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 متد دیگر می‌باشند. تمام اعضای عمومی پس از نصب بسته Aspose.Html FOSS برای 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`	خواندن	آیا عنصر در حال حاضر در حال جستجو است (stub, always `False`).
`default_playback_rate`	`float`	خواندن/نوشتن	نرخ پخش پیش‌فرض (headless default `1.0`).
`playback_rate`	`float`	خواندن/نوشتن	نرخ پخش فعلی (headless default `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()`	شروع پخش (stub no-op).
`pause()`	توقف پخش (stub no-op).
`load()`	بارگذاری مجدد انتخاب منبع رسانه (stub no-op).
`can_play_type(type: str)` → `str`	بازگرداندن `''` — حالت headless نمی‌تواند هیچ نوع رسانه‌ای را پخش کند.
`add_text_track(kind: str, label: str, language: str)`	یک مسیر متنی اضافه کنید (stub no-op، `None` را برمی‌گرداند).
`click()`	یک رویداد کلیک ساختگی را بر روی این عنصر ارسال کنید.
`focus(options: “dict	None”)`
`blur()`	یک رویداد `'blur'` غیر حباب‌دار را بر روی این عنصر ارسال کنید.
`show_popover()`	این عنصر را به‌صورت پاپ‌اور نمایش دهید (در حالت سرلس هیچ عملی انجام نمی‌شود).
`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"`	اعلامیه‌های cascade-حل‌شده فاز-۲ را برای این عنصر برگردانید.
`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)`	اگر این عنصر هنوز قابل مشاهده نیست، آن را به نمای قابل مشاهده اسکرول کنید (no-op در حالت headless).
`set_pointer_capture(pointer_id: int)`	این عنصر را به‌عنوان هدف ضبط برای اشاره‌گر داده‌شده تعیین کنید (no-op).
`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`	بر روی این نمونه HTMLAudioElement، 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