Element

نظرة عامة

Element هي فئة في Aspose.Html FOSS لـ Python. تورث من: Node.

عقدة عنصر HTML أو XML.

توفر هذه الفئة 72 طريقة للعمل مع كائنات Element في برامج Python. الطرق المتاحة تشمل: __init__, add_event_listener, after, append, append_child, attach_shadow, before, check_visibility, clone_node, closest, compare_document_position, contains، بالإضافة إلى 60 طريقة أخرى. جميع الأعضاء العامة متاحة لأي تطبيق Python بعد تثبيت حزمة Aspose.Html FOSS لـ Python. الخصائص: assigned_slot, attributes, child_element_count, child_nodes, children, class_list، بالإضافة إلى 43 أخرى.

خصائص

اسم	النوع	الوصول	وصف
`node_name`	`str`	قراءة	اسم الوسم المؤهل (بالأحرف الكبيرة لعناصر HTML).
`tag_name`	`str`	قراءة	اسم الوسم المؤهل بالأحرف الكبيرة (عناصر HTML).
`local_name`	`str`	قراءة	الجزء المحلي من الاسم المؤهل (أحرف صغيرة).
`namespace_uri`	`str	None`	قراءة
`style_sheets`	`"StyleSheetList"`	قراءة	قائمة الأنماط الحية المطبقة على مستند هذا العنصر.
`prefix`	`str	None`	قراءة
`id`	`str`	قراءة	قيمة السمة `id`، أو `''` إذا لم تكن موجودة.
`class_name`	`str`	قراءة	قيمة السمة `class`، أو `''`.
`class_list`	`"DOMTokenList"`	قراءة	مجموعة حية قابلة للتغيير من رموز الفئة CSS المدعومة بسمة `class`.
`dataset`	`"DOMStringMap"`	قراءة	عرض مباشر شبيه بالقاموس لسمات `data-*` المخصصة للعنصر.
`attributes`	`NamedNodeMap`	قراءة	خريطة مرتبة لكائنات Attr لهذا العنصر.
`children`	`HTMLCollection`	قراءة	مجموعة HTMLCollection حية لأطفال من نوع Element فقط.
`first_element_child`	`Element	None`	قراءة
`last_element_child`	`Element	None`	قراءة
`next_element_sibling`	`Element	None`	قراءة
`previous_element_sibling`	`Element	None`	قراءة
`child_element_count`	`int`	قراءة	عدد العناصر الفرعية.
`inner_html`	`str`	قراءة/كتابة	المحتوى المتسلسل HTML لجميع العناصر الفرعية (innerHTML).
`outer_html`	`str`	قراءة/كتابة	المسلسل HTML لهذا العنصر وجميع أبنائه (outerHTML).
`text_content`	`str	None`	قراءة/كتابة
`style`	`"CSSStyleDeclaration"`	قراءة	نمط الإدراج لهذا العنصر كـ CSSStyleDeclaration حي.
`scroll_width`	`int`	قراءة	عرض تمرير المحتوى بوحدات CSS بكسل (نموذج: 0).
`scroll_height`	`int`	قراءة	ارتفاع تمرير المحتوى بوحدات CSS بكسل (قالب: 0).
`client_width`	`int`	قراءة	العرض الداخلي بما في ذلك الحشو، باستثناء الحد (قالب: 0).
`client_height`	`int`	قراءة	الارتفاع الداخلي بما في ذلك الحشو، باستثناء الحد (قالب: 0).
`scroll_top`	`int`	قراءة/كتابة	إزاحة التمرير العمودي بـ CSS بكسل (القالب: 0).
`scroll_left`	`int`	قراءة/كتابة	إزاحة التمرير الأفقي بـ CSS بكسل (قالب: 0).
`offset_width`	`int`	قراءة	عرض صندوق الحدود للتخطيط بـ CSS بكسل (قالب: 0).
`offset_height`	`int`	قراءة	ارتفاع صندوق الحدود للتخطيط بـ CSS بكسل (قالب: 0).
`offset_top`	`int`	قراءة	الإزاحة العلوية من `offsetParent` بوحدات CSS بكسل (قالب: 0).
`offset_left`	`int`	قراءة	الإزاحة اليسرى من `offsetParent` بوحدات CSS بكسل (قالب: 0).
`offset_parent`	`None`	قراءة	عنصر الأصل للإزاحة؛ يكون دائمًا `None` في وضع بدون رأس.
`client_top`	`int`	قراءة	عرض الحد العلوي لـ CSS بالبكسل; يكون دائمًا `0` في وضع بدون رأس.
`client_left`	`int`	قراءة	عرض الحد الأيسر CSS بالبكسل؛ دائمًا `0` في وضع headless mode.
`part`	`"DOMTokenList"`	قراءة	قائمة DOMTokenList الحية التي تعكس سمة العنصر `part`.
`shadow_root`	``	قراءة	دائمًا `None` في وضع headless mode.
`slot`	`str`	قراءة/كتابة	يعكس سمة المحتوى `slot` (DOM §4.2.3).
`assigned_slot`	``	قراءة	دائمًا `None` في وضع headless.
`node_type`	`int`	قراءة	ثابت عدد صحيح لنوع العقدة من `NodeType`.
`node_value`	`str	None`	قراءة/كتابة
`parent_node`	`Node	None`	قراءة
`parent_element`	`Element	None`	قراءة
`is_connected`	`bool`	قراءة	ما إذا كانت هذه العقدة جزءًا من شجرة عقد المستند (WHATWG DOM §4.4).
`owner_document`	`Document	None`	قراءة
`child_nodes`	`NodeList`	قراءة	قائمة NodeList حية لجميع العقد الفرعية.
`first_child`	`Node	None`	قراءة
`last_child`	`Node	None`	قراءة
`previous_sibling`	`Node	None`	قراءة
`next_sibling`	`Node	None`	قراءة

الطرق

التوقيع	وصف
`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)`	عيّن هذا العنصر كهدف للإمساك للمؤشر المعطى (no-op).
`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`	يستدعي 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`	أرجع bitmask يصف موضع 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