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 | קריאה | משך המדיה בשניות (stub, תמיד NaN). |
current_time | float | קריאה/כתיבה | מיקום ההשמעה הנוכחי בשניות (stub, תמיד 0.0). |
volume | float | קריאה/כתיבה | רמת עוצמת השמע (stub, תמיד 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 | Read/Write | משקף את המאפיין contenteditable (WHATWG HTML §6.6). | | is_content_editable | bool | Read | האם אלמנט זה ניתן לעריכה כרגע (WHATWG HTML §6.6). | | dir | str | Read/Write | כיווניות הטקסט של האלמנט (משקף את המאפיין dir). | | draggable | bool | Read/Write | האם האלמנט ניתן לגרירה (משקף את המאפיין draggable). | | spell_check | bool | Read/Write | האם בדיקת האיות מופעלת (משקף את המאפיין spellcheck). | | spellcheck | bool | Read/Write | האם בדיקת האיות מופעלת (משקף את המאפיין spellcheck). | | autocapitalize | str | Read/Write | רמז לאותיות גדולות אוטומטיות (משקף את המאפיין autocapitalize). | | nonce | str | Read/Write | nonce קריפטוגרפי ל-CSP (משקף את המאפיין nonce). | | autofocus | bool | Read/Write | האם אלמנט זה צריך לקבל פוקוס בעת טעינת העמוד. | | access_key_label | str | Read | תווית מקש גישה שהוקצתה על ידי המערכת (תצורת headless: תמיד ''). | | input_mode | str | Read/Write | רמז למצב קלט במקלדת וירטואלית (משקף את המאפיין inputmode). | | enter_key_hint | str | Read/Write | רמז לתווית פעולה של מקש Enter (משקף את המאפיין enterkeyhint). | | translate | bool | Read/Write | האם תרגום מופעל עבור אלמנט זה (WHATWG HTML §6.1.2). | | inner_text | str | Read/Write | תוכן טקסט מעובד — רווחים מצומצמים text_content. | | outer_text | str | Read/Write | זהה ל-inner_text (המקבל משקף את inner_text לפי תקן HTML §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 | Read/Write | משקף את המאפיין 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() | התחל הפעלה (stub no-op). |
pause() | השהה הפעלה (stub no-op). |
load() | טען מחדש את בחירת משאב המדיה (stub no-op). |
can_play_type(type: str) → str | החזר '' — מצב ללא ראש אינו יכול לנגן שום סוג מדיה. |
add_text_track(kind: str, label: str, language: str) | הוסף מסלול טקסט (stub no-op, מחזיר None). |
click() | הפץ אירוע לחיצה סינתטי על אלמנט זה. |
| `focus(options: “dict | None”)` |
blur() | הפץ אירוע 'blur' non-bubbling על אלמנט זה. |
show_popover() | הצג אלמנט זה כתצוגה קופצת (no-op במצב headless). |
hide_popover() | הסתר את התצוגה הקופצת של אלמנט זה (no-op במצב headless). |
| `toggle_popover(force: “bool | None”)→bool` |
| `init(local_name: str, namespace_uri: str | None, prefix: str |
get_computed_style() → "ComputedStyleDeclaration" | החזר הצהרות פתורות בקסקייד של שלב-2 עבור אלמנט זה. |
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) | גלול אלמנט זה לתצוגה אם הוא עדיין אינו גלוי (לא עושה דבר במצב headless). |
set_pointer_capture(pointer_id: int) | הגדר אלמנט זה כיעד לכיבוש עבור הסמן הנתון (לא פועל). |
release_pointer_capture(pointer_id: int) | שחרר לכידת סמן עבור מזהה הסמן הנתון (לא פועל). |
has_pointer_capture(pointer_id: int) → bool | החזר האם לאלמנט זה יש לכידת סמן עבור המזהה הנתון. |
request_pointer_lock() | בקש שהסמן יינעל אל הרכיב הזה (no-op). |
| `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 | החזר מסכת ביט המתארת את המיקום של 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 דרך עץ האבות. |