HTMLMediaElement

نمای کلی

HTMLMediaElement یک کلاس در Aspose.Html FOSS برای Python است. از HTMLElement ارث می‌برد.

کلاس پایه برای HTML عناصر رسانه‌ای (<audio> / <video>).

این کلاس 83 متد برای کار با اشیاء HTMLMediaElement در برنامه‌های 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، همیشه `False`) است.
`default_playback_rate`	`float`	خواندن/نوشتن	نرخ پخش پیش‌فرض (پیش‌فرض headless `1.0`).
`playback_rate`	`float`	خواندن/نوشتن	نرخ پخش فعلی (پیش‌فرض headless `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`	بازگرداندن `''` — حالت headless نمی‌تواند هیچ نوع رسانه‌ای را پخش کند.
`add_text_track(kind: str, label: str, language: str)`	یک ردیف متنی اضافه کنید (stub no-op، `None` را برمی‌گرداند).
`click()`	یک رویداد کلیک مصنوعی را بر روی این عنصر ارسال کنید.
`focus(options: “dict	None”)`
`blur()`	یک رویداد `'blur'` غیر حبابی را بر روی این عنصر ارسال کنید.
`show_popover()`	این عنصر را به‌صورت پاپ‌اور نمایش دهید (در حالت 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"`	اعلان‌های cascade-resolved فاز ۲ را برای این عنصر برگردانید.
`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)`	آزادسازی گرفتن اشاره‌گر برای شناسهٔ اشاره‌گر داده شده (no-op).
`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`	در این نمونهٔ 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)`	لغو ثبت یک listener که قبلاً ثبت شده است.
`dispatch_event(event: "Event")` → `bool`	Dispatch event از طریق درخت نیاکان.

همچنین ببینید:

Aspose.HTML for Python — Enterprise API Reference