HTMLMediaElement

概述

HTMLMediaElement 是 Aspose.Html FOSS 中用于 Python 的类。继承自：HTMLElement。

用于 HTML 媒体元素的基类（<audio> / <video>）。

此类在 Python 程序中提供 83 个用于操作 HTMLMediaElement 对象的方法。可用的方法包括：__init__、add_event_listener、add_text_track、after、append、append_child、attach_shadow、before、blur、can_play_type、check_visibility、click，以及另外 71 个方法。所有公共成员在安装 Aspose.Html FOSS for Python 包后，可供任何 Python 应用程序访问。属性：access_key、access_key_label、assigned_slot、attributes、audio_tracks、auto_play，以及另外 92 项。

属性

名称	类型	访问	描述
`src`	`str`	读取	缺失时为 `''`，否则为 `src` 属性值。
`current_src`	`str`	读取	当前选定的源 URL（存根，始终为 `''`）。
`auto_play`	`bool`	读取	对 `autoplay` 属性的布尔反射。
`controls`	`bool`	读取	对 `controls` 属性的布尔反射。
`loop`	`bool`	读取	对 `loop` 属性的布尔反射。
`muted`	`bool`	读取	对 `muted` 属性的布尔反射。
`preload`	`str`	读取	`preload` 属性的值，若不存在则为 `''`。
`cross_origin`	`str	None`	读取
`paused`	`bool`	读取	播放暂停状态（存根，始终为 `True`）。
`ended`	`bool`	读取	播放结束状态（存根，始终为 `False`）。
`duration`	`float`	读取	媒体时长（秒）（存根，始终为 NaN）。
`current_time`	`float`	读写	当前播放位置（秒）（存根，始终为 `0.0`）。
`volume`	`float`	读写	音频音量级别（存根，始终为 `1.0`）。
`default_muted`	`bool`	读取	默认静音状态反映自 `muted` 属性。
`ready_state`	`int`	读取	就绪状态（存根，始终 `0` = HAVE_NOTHING）。
`network_state`	`int`	读取	网络状态（存根，始终 `0` = NETWORK_EMPTY）。
`buffered`	`"_TimeRanges"`	读取	已缓冲的时间范围 (存根, 始终为空).
`played`	`"_TimeRanges"`	读取	已播放的时间范围 (存根, 始终为空).
`seekable`	`"_TimeRanges"`	读取	可跳转的时间范围 (存根, 始终为空).
`seeking`	`bool`	读取	元素当前是否正在寻找（存根，始终为 `False`）。
`default_playback_rate`	`float`	读写	默认播放速率（无头默认 `1.0`）。
`playback_rate`	`float`	读写	当前播放速率（无头默认 `1.0`）。
`media_keys`	`None`	读取	关联的 MediaKeys 对象 (存根，始终为 `None`).
`src_object`	`None`	读取	关联的 MediaStream/Blob (存根，始终为 `None`).
`error`	`None`	读取	上一次媒体错误（存根，始终为 `None`）。
`text_tracks`	`"_EmptyTrackList"`	读取	文本轨道列表（存根，始终为空）。
`audio_tracks`	`"_EmptyTrackList"`	读取	音频轨道列表（存根，始终为空）。
`video_tracks`	`"_EmptyTrackList"`	读取	视频轨道列表（存根，始终为空）。
`hidden`	`bool`	读写	元素是否隐藏（反映 `hidden` 布尔属性）。
`title`	`str`	读写	此元素的工具提示标题（反映 `title` 属性）。
`lang`	`str`	读写	元素内容的语言（反映 `lang` 属性）。
`tab_index`	`int`	读写	此元素的制表顺序索引（反映 `tabindex` 属性）。
`access_key`	`str`	读写	此元素的键盘快捷键（反映 `accesskey`

    attribute). |

方法

签名	描述
`play()`	开始播放（存根无操作）。
`pause()`	暂停播放（存根无操作）。
`load()`	重新加载媒体资源选择（存根无操作）。
`can_play_type(type: str)` → `str`	返回 `''` — 无头模式无法播放任何媒体类型。
`add_text_track(kind: str, label: str, language: str)`	添加文本轨道（存根无操作，返回 `None`）。
`click()`	在此元素上分派一个合成点击事件。
`focus(options: “dict	None”)`
`blur()`	在此元素上分派一个非冒泡的 `'blur'` 事件。
`show_popover()`	将此元素显示为弹出框（在无头模式下为无操作）。
`hide_popover()`	隐藏此元素的弹出框（在无头模式下为无操作）。
`toggle_popover(force: “bool	None”)`→`bool`
`init(local_name: str, namespace_uri: str	None, prefix: str
`get_computed_style()` → `"ComputedStyleDeclaration"`	返回此元素的 phase-2 cascade-resolved declarations。
`insert_adjacent_html(position: str, html: str)`	在此元素相对位置插入已解析的 HTML 标记。
`insert_adjacent_text(position: str, text: str)`	在此元素相对位置插入文本节点。
`insert_adjacent_element(position: str, element: “Element	None”)`→`“Element
`get_attribute(name: str)` → `str	None`
`set_attribute(name: str, value: str)`	设置属性 name to value, 如果不存在则创建。
`remove_attribute(name: str)`	删除属性 name.
`has_attribute(name: str)` → `bool`	Return `True` 如果属性 name 存在于此元素上。
`get_attribute_node(name: str)` → `“Attr	None”`
`set_attribute_node(attr: "Attr")` → `“Attr	None”`
`remove_attribute_node(attr: "Attr")` → `"Attr"`	Remove attr 从此元素的属性集合中获取并返回它。
`get_attribute_node_ns(namespace_uri: str	None, local_name: str)`→`“Attr
`set_attribute_node_ns(attr: "Attr")` → `“Attr	None”`
`remove_attribute_node_ns(namespace_uri: str	None, local_name: str)`→`“Attr”`
`get_attribute_ns(namespace_uri: str	None, local_name: str)`→`str
`set_attribute_ns(namespace_uri: str	None, qualified_name: str, value: str)`
`has_attribute_ns(namespace_uri: str	None, local_name: str)`→`bool`
`remove_attribute_ns(namespace_uri: str	None, local_name: str)`
`toggle_attribute(name: str, force: bool	None)`→`bool`
`get_attribute_names()` → `list[str]`	返回所有属性的限定名称，按收集顺序。
`has_attributes()` → `bool`	当此元素具有一个或多个属性时，返回 `True`。
`scroll_into_view(arg: bool	dict
`scroll(x_or_options: float	dict
`scroll_into_view_if_needed(center_if_needed: bool)`	如果该元素尚未可见，则将其滚动至视图中（在无头模式下为无操作）。
`set_pointer_capture(pointer_id: int)`	将此元素指定为给定指针的捕获目标（无操作）。
`release_pointer_capture(pointer_id: int)`	释放给定指针 ID 的指针捕获（无操作）。
`has_pointer_capture(pointer_id: int)` → `bool`	返回此元素是否对给定 ID 拥有指针捕获。
`request_pointer_lock()`	请求将指针锁定到此元素（无操作）。
`request_fullscreen(options: “dict	None”)`
`check_visibility(options: “dict	None”)`→`bool`
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	返回一个静态的 NodeList，包含所有匹配的元素 selector.
`matches(selector: str)` → `bool`	Return `True` 如果此元素匹配 CSS selector.
`webkit_matches_selector(selector: str)` → `bool`	浏览器兼容别名，针对 :meth:`matches`。
`closest(selector: str)` → `“Element	None”`
`get_elements_by_tag_name(qualified_name: str)` → `HTMLCollection`	返回所有标签名匹配的后代元素 qualified_name.
`get_elements_by_class_name(class_names: str)` → `HTMLCollection`	返回所有拥有给定所有类标记的后代元素。
`filter_fn(el: "Element")` → `bool`	在此 HTMLMediaElement 实例上调用 filter_fn(el)。
`remove()`	将此元素从其父节点中移除。
`before()`	Insert nodes 在其父节点中紧靠此元素之前。
`after()`	Insert nodes 在其父元素中紧接此元素之后。
`replace_with()`	将此元素替换为 nodes 在其父元素中。
`prepend()`	Insert nodes 在此元素的第一个子元素之前。
`append()`	Append nodes 作为此元素的最后子元素。
`replace_children()`	移除所有子元素，然后追加 nodes 作为新的子元素。
`get_bounding_client_rect()` → `"DOMRect"`	返回边界客户端矩形（全零存根）。
`get_client_rects()` → `"DOMRectList"`	返回客户端矩形列表（在服务器端上下文中为空）。
`get_animations()` → `list[object]`	返回此元素的活动动画（无头存根：始终为 `[]`）。
`attach_shadow(init: “dict	None”)`
`get_root_node(composed: bool)` → `"Node"`	返回节点树的根节点。
`has_child_nodes()` → `bool`	返回此节点是否至少拥有一个直接子节点。
`lookup_namespace_uri(prefix: str	None)`→`str
`lookup_prefix(namespace_uri: str	None)`→`str
`is_default_namespace(namespace_uri: str	None)`→`bool`
`is_supported(feature: str, version: str	None)`→`bool`
`get_feature(feature: str, version: str	None)`→`object
`set_user_data(key: str, data: object	None, handler: object
`get_user_data(key: str)` → `object	None`
`append_child(node: Node)` → `Node`	Append node 作为此节点的最后一个子节点。
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node 从子列表中取出并返回它。
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	返回此节点的副本。
`normalize()`	将此节点及其整个子树置于规范形式。
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	返回描述位置的位掩码 other 相对于此节点。
`is_equal_node(other: Node	None)`→`bool`
`is_same_node(other_node: Node	None)`→`bool`
`add_event_listener(type: str, listener: Callable, capture: bool, once: bool)`	Register listener 针对事件的 type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	取消注册先前已注册的监听器。
`dispatch_event(event: "Event")` → `bool`	Dispatch event 通过祖先树。

另请参阅

Aspose.HTML for Python — Enterprise API Reference