HTMLAudioElement
Обзор
HTMLAudioElement — это класс в Aspose.Html FOSS для Python. Наследуется от: HTMLMediaElement.
HTML <audio> элемент.
Этот класс предоставляет 83 метода для работы с объектами HTMLAudioElement в программах Python. Доступные методы включают: __init__, add_event_listener, add_text_track, after, append, append_child, attach_shadow, before, blur, can_play_type, check_visibility, click и ещё 71 метод. Все публичные члены доступны любому приложению Python после установки пакета Aspose.Html FOSS для 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). || content_editable | str | Чтение/Запись | Отражает атрибут contenteditable (WHATWG HTML §6.6). | | is_content_editable | bool | Чтение | Является ли этот элемент в данный момент редактируемым (WHATWG HTML §6.6). | | dir | str | Чтение/Запись | Направление текста элемента (отражает атрибут dir). | | draggable | bool | Чтение/Запись | Является ли элемент перемещаемым (отражает атрибут draggable). | | spell_check | bool | Чтение/Запись | Включена ли проверка орфографии (отражает атрибут spellcheck). | | spellcheck | bool | Чтение/Запись | Включена ли проверка орфографии (отражает атрибут spellcheck). | | autocapitalize | str | Чтение/Запись | Подсказка автокапитализации (отражает атрибут autocapitalize). | | nonce | str | Чтение/Запись | Криптографический nonce для CSP (отражает атрибут nonce). | | autofocus | bool | Чтение/Запись | Должен ли этот элемент получать фокус при загрузке страницы. | | access_key_label | str | Чтение | Системно присвоенный ярлык клавиши доступа (заглушка безголового режима: всегда ''). | | input_mode | str | Чтение/Запись | Подсказка режима ввода виртуальной клавиатуры (отражает атрибут inputmode). | | enter_key_hint | str | Чтение/Запись | Подсказка метки действия клавиши Enter (отражает атрибут enterkeyhint). | | translate | bool | Чтение/Запись | Включён ли перевод для этого элемента (WHATWG HTML §6.1.2). | | inner_text | str | Чтение/Запись | Отображаемое текстовое содержимое — свернутое пробелами text_content. | | outer_text | str | Чтение/Запись | То же, что inner_text (геттер зеркалит inner_text согласно HTML Standard §3.2.7). | | popover | | Read/Write | Reflects thepopovercontent attribute (WHATWG HTML §6.12). | | node_name|str| Read | The qualified tag name (uppercase for HTML elements). | |tag_name|str| Read | The qualified tag name in uppercase (HTML elements). | |local_name|str| Read | The local part of the qualified name (lowercase). | |namespace_uri|str | None | Read | The namespace URI, orNonefor no namespace. | | style_sheets|“StyleSheetList”| Read | Live stylesheet list applicable to this element's document. | |prefix|str | None | Read | The namespace prefix, orNone. | | id|str| Read | The value of theidattribute, or’’if not present. | | class_name|str | Read | The value of theclassattribute, or’’. | | class_list|“DOMTokenList”| Read | Live mutable set of CSS class tokens backed by theclassattribute. | | dataset|“DOMStringMap” | Read | Live dict-like view of the element'sdata-*custom attributes. | | attributes|NamedNodeMap| Read | The ordered map of Attr objects for this element. | |children|HTMLCollection| Read | A live HTMLCollection of Element-type children only. | |first_element_child|Element | None | Read | The first Element child, orNone. | | last_element_child|Element | None| Read | The last Element child, orNone. | | next_element_sibling|Element | None| Read | The next sibling that is an Element, orNone. | | previous_element_sibling|Element | None| Read | The previous sibling that is an Element, orNone. | | child_element_count|int| Read | The number of Element children. | |inner_html|str| Read/Write | The serialised HTML content of all children (innerHTML). | |outer_html|str| Read/Write | The serialised HTML of this element and all its descendants (outerHTML). | |text_content|str | None| Read/Write | The concatenation of all descendant Text node data (DFS order). | |style|“CSSStyleDeclaration”| Read | The inline style of this element as a live CSSStyleDeclaration. | |scroll_width|int| Read | Content scroll width in CSS pixels (stub: 0). | |scroll_height|int| Read | Content scroll height in CSS pixels (stub: 0). | |client_width|int| Read | Inner width including padding, excluding border (stub: 0). | |client_height|int| Read | Inner height including padding, excluding border (stub: 0). | |scroll_top|int| Read/Write | Vertical scroll offset in CSS pixels (stub: 0). | |scroll_left|int| Read/Write | Horizontal scroll offset in CSS pixels (stub: 0). | |offset_width|int| Read | Layout border-box width in CSS pixels (stub: 0). | |offset_height|int| Read | Layout border-box height in CSS pixels (stub: 0). | |offset_top|int| Read | Top offset fromoffsetParentin CSS pixels (stub: 0). | | offset_left|int | Read | Left offset fromoffsetParentin CSS pixels (stub: 0). | | offset_parent|None | Read | The offset parent element; alwaysNonein headless mode. | | client_top|int | Read | Width of the top CSS border in pixels; always0in headless mode. | | client_left|int | Read | Width of the left CSS border in pixels; always0in headless mode. | | part|“DOMTokenList” | Read | Live DOMTokenList reflecting the elementpartattribute. | | shadow_root | | Read | Always None in headless mode. | | slot | str | Чтение/Запись | Отражает атрибут содержимого slot (DOM §4.2.3). | | assigned_slot | | Read | AlwaysNonein headless mode. | | node_type|int | Read | Integer node type constant fromNodeType. | | node_value|str | None| Read/Write | Character data for CharacterData nodes;Noneotherwise. | | parent_node|Node | None | Read | The parent node, orNoneif this node has no parent. | | parent_element|Element | None | Read | The parent node if it is an Element;Noneotherwise. | | is_connected|bool| Read | Whether this node is part of a document's node tree (WHATWG DOM §4.4). | |owner_document|Document | None | Read | The Document this node belongs to, orNonefor Document itself. | | child_nodes|NodeList| Read | A live NodeList of all child nodes. | |first_child|Node | None | Read | The first child node, orNone. | | last_child|Node | None| Read | The last child node, orNone. | | previous_sibling|Node | None| Read | The preceding sibling node, orNone. | | next_sibling|Node | None| Read | The following sibling node, orNone``. |
Методы
| Подпись | Описание: |
|---|---|
play() | Запуск воспроизведения (заглушка, без действия). |
pause() | Пауза воспроизведения (заглушка, без действия). |
load() | Перезагрузка выбора медиа-ресурса (заглушка, без действия). |
can_play_type(type: str) → str | Вернуть '' — безголовый режим не может воспроизводить ни один тип медиа. |
add_text_track(kind: str, label: str, language: str) | Добавить текстовую дорожку (заглушка без действия, возвращает None). |
click() | Вызвать синтетическое событие 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" | Вернуть декларации, разрешённые каскадом во второй фазе, для этого элемента. |
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) | Освободить захват указателя для указанного идентификатора указателя (не делает ничего). |
has_pointer_capture(pointer_id: int) → bool | Вернуть, захвачен ли этот элемент указателем с указанным идентификатором. |
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 | Вызывает filter_fn(el) у этого экземпляра HTMLAudioElement. |
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 | Вернуть битовую маску, описывающую позицию of 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 через древо предков. |