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 طريقة إضافية. جميع الأعضاء العامة متاحة لأي تطبيق 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). |

الطرق

التوقيع	وصف
`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"`	إرجاع التصريحات التي تم حلّها بالتسلسل في المرحلة الثانية لهذا العنصر.
`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()`	اطلب أن يتم قفل المؤشر إلى هذا العنصر (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) على هذا الكائن HTMLMediaElement.
`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