Document

نظرة عامة

Document هي class في Aspose.Html FOSS لـ Python. يُورث من: Node.

جذر شجرة DOM.

هذه class توفر 66 methods للعمل مع كائنات Document في برامج Python. تشمل الطرق المتاحة: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns, و 54 طريقة إضافية. جميع الأعضاء العامة يمكن الوصول إليها من أي تطبيق Python بعد تثبيت حزمة Aspose.Html FOSS لـ Python. الخصائص: a_link_color, active_element, adopted_style_sheets, all, anchors, applets, و 67 أخرى.

خصائص

اسم	النوع	الوصول	وصف
`default_view`	``	قراءة	كائن Window لكل مستند (كسول، مخزن مؤقتًا).
`location`	``	قراءة	إرجاع كائن Location الخاص بالـ Window المرتبط، أو `None`.
`implementation`	`"DOMImplementation"`	قراءة	كائن DOMImplementation لكل مستند (كسول، مخزن مؤقتًا).
`dom_config`	`DOMConfiguration`	قراءة	كائن DOMConfiguration لكل مستند (كسول، مخزن مؤقتًا).
`url`	`str`	قراءة	عنوان URL للمستند (WHATWG `Document.URL`)، الافتراضي `"about:blank"`.
`document_uri`	`str`	قراءة	عنوان URL للمستند كسلسلة نصية (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	قراءة	تم حل عنوان URL الأساسي لهذا المستند (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	قراءة	عنوان URL للوثيقة المرجعية (WHATWG HTML Standard §document).
`domain`	`str`	قراءة	مكوّن اسم المضيف لعنوان URL للوثيقة (WHATWG HTML Standard §document).
`last_modified`	`str`	قراءة	سلسلة طابع الوقت لآخر تعديل (WHATWG HTML Standard §document).
`cookie`	`str`	قراءة/كتابة	نموذج سلسلة ملف تعريف الارتباط للقراءة فقط — يُعيد دائمًا `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	قراءة	ما إذا كان المستند مخفيًا — دائمًا `False` في وضع headless.
`visibility_state`	`str`	قراءة	حالة وضوح المستند — دائمًا `"visible"` في وضع headless.
`design_mode`	`str`	قراءة/كتابة	ما إذا كان المستند في وضع التصميم (WHATWG HTML §7.6.4).
`dir`	`str`	قراءة/كتابة	اتجاه نص المستند (WHATWG HTML §3.3.2).
`current_script`	`None`	قراءة	عنصر البرنامج النصي الجاري تنفيذه حاليًا (WHATWG HTML §8.1.3.4).
`character_set`	`str`	قراءة	ترميز الأحرف المستخدم أثناء التحليل (WHATWG DOM §3.1).
`charset`	`str`	قراءة	اسم مستعار لـ :attr:`character_set` (اسم HTML القياسي).
`input_encoding`	`str`	قراءة	اسم مستعار لـ :attr:`character_set` (اسم توافق WHATWG DOM).
`content_type`	`str`	قراءة	نوع MIME للوثيقة؛ يكون دائمًا `"text/html"` للوثائق HTML.
`style_sheets`	`"StyleSheetList"`	قراءة	قائمة أنماط المستند الحية.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	قراءة/كتابة	قائمة اعتماد stylesheet القابلة للإنشاء على مستوى المستند.
`node_name`	`str`	قراءة	`'#document'`
`document_element`	`Element	None`	قراءة
`document_type`	`DocumentType	None`	قراءة
`compat_mode`	`str`	قراءة/كتابة	`'BackCompat'` (quirks) أو `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	قراءة	حالة تحميل المستند.
`parse_errors`	`list[ParseError]`	قراءة	أخطاء التحليل من عملية التحليل الأخيرة.
`head`	`Element	None`	قراءة
`body`	`Element	None`	قراءة
`forms`	`"HTMLCollection"`	قراءة	مجموعة حية لجميع عناصر `<form>` في المستند.
`images`	`"HTMLCollection"`	قراءة	مجموعة حية لجميع عناصر `<img>` في المستند.
`links`	`"HTMLCollection"`	قراءة	مجموعة حية من عناصر `<a href>` و `<area href>`.
`scripts`	`"HTMLCollection"`	قراءة	مجموعة حية من جميع عناصر `<script>` في المستند.
`embeds`	`"HTMLCollection"`	قراءة	مجموعة حية لجميع سلالات `<embed>`.
`applets`	`"HTMLCollection"`	قراءة	مجموعة حية لجميع سلالات `<applet>`.
`anchors`	`"HTMLCollection"`	قراءة	مجموعة حية من عناصر `<a name=...>` (الروابط المسماة القديمة).
`title`	`str`	قراءة/كتابة	محتوى النص للعنصر الأول `<title>` في `<head>`.
`compatible_mode`	`str`	قراءة	مؤشر وضع Quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	قراءة/كتابة	دائمًا `True` في وضع headless (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	قراءة
`last_element_child`	`“Element	None”`	قراءة
`child_element_count`	`int`	قراءة	عدد الأطفال المباشرين الذين هم عقد عنصر.
`active_element`	`“Element	None”`	قراءة
`full_screen_enabled`	`bool`	قراءة	دائمًا `False` — لا عرض في وضعية بدون رأس (ملء الشاشة API §7).
`fullscreen_element`	`None`	قراءة	دائمًا `None` — لا عنصر ملء شاشة في وضعية بدون رأس (ملء الشاشة API §7).
`pointer_lock_element`	`None`	قراءة	دائمًا `None` — لا يوجد Pointer Lock في الوضع بدون رأس (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	قراءة	مقتطف مخطط الوثيقة؛ `current_time` يكون دائمًا `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	قراءة	جميع العناصر بترتيب الشجرة (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	قراءة	اسم مستعار لـ :attr:`embeds` وفقًا لـ WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	قراءة	العناصر الفرعية المباشرة للمستند (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	قراءة	سلسلة الأصل غير الشفافة — دائمًا `'null'` في وضع بدون رأس (WHATWG DOM §4.5).
`fg_color`	`str`	قراءة/كتابة	يعكس سمة مستوى المستند `fgColor` القديمة عبر سمة `<body>` `text`.
`bg_color`	`str`	قراءة/كتابة	يعكس سمة مستوى المستند `bgColor` القديمة عبر سمة `<body>` `bgcolor`.
`link_color`	`str`	قراءة/كتابة	يعكس السمة `linkColor` القديمة على مستوى المستند عبر سمة `<body>` `link`.
`v_link_color`	`str`	قراءة/كتابة	يعكس السمة `vlinkColor` القديمة على مستوى المستند عبر سمة `<body>` `vlink`.
`a_link_color`	`str`	قراءة/كتابة	يعكس السمة `alinkColor` القديمة على مستوى المستند عبر سمة `<body>` `alink`.
`fonts`	``	قراءة	دائمًا `None` في وضع بدون رأس.
`picture_in_picture_enabled`	`bool`	قراءة	دائمًا `False` في وضع بدون رأس.
`picture_in_picture_element`	``	قراءة	دائمًا `None` في وضع بدون رأس.
`prerendering`	`bool`	قراءة	دائمًا `False` في وضع headless.
`node_type`	`int`	قراءة	ثابت نوع العقدة عدد صحيح من `NodeType`.
`node_value`	`str	None`	قراءة/كتابة
`text_content`	`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__()`	Calls init على هذه المثيلة من Document.
`normalize_document()`	قم بتطبيع هذا المستند باستخدام دلالات `Node.normalize` الموجودة.
`has_focus()` → `bool`	أرجع ما إذا كان المستند في حالة تركيز — دائمًا `False` في وضع headless.
`open(type: str, replace: str)` → `"Document"`	افتح المستند للكتابة (WHATWG HTML §7.7).
`close()`	أغلق المستند بعد الكتابة (WHATWG HTML §7.7).
`write()`	اكتب سلسلة إلى تدفق المستند (WHATWG HTML §7.7).
`writeln()`	اكتب سلسلة تليها سطر جديد (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	أرفق ورقة أنماط إلى هذا المستند.
`detach_style_sheet(sheet: "CSSStyleSheet")`	افصل ورقة الأنماط المرفقة مسبقًا.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	أنشئ HTMLElement مملوك لهذا المستند.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	أنشئ Element في مساحة اسم محددة، مملوك لهذا المستند.
`create_text_node(data: str)` → `Text`	إنشاء عقدة نصية بالبيانات الحرفية المعطاة.
`create_comment(data: str)` → `Comment`	إنشاء عقدة تعليق بالبيانات الحرفية المعطاة.
`create_cdata_section(data: str)` → `"CDATASection"`	إنشاء عقدة CDATASection مملوكة لهذا المستند.
`create_document_fragment()` → `DocumentFragment`	إنشاء DocumentFragment فارغ مملوك لهذا المستند.
`create_event(interface: str)` → `"Event"`	إنشاء كائن حدث قديم لـ interface.
`create_range()` → `"Range"`	إنشاء Range جديد مدمج في هذا المستند.
`get_selection()` → `"Selection"`	إرجاع كائن selection object المفرد لهذا المستند.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	إنشاء عقدة ProcessingInstruction مملوكة لهذا المستند.
`create_attribute(local_name: str)` → `"Attr"`	إنشاء `Attr` غير مسمى مملوك لهذا المستند.
`create_attribute_ns(namespace_uri: str	None, qualified_name: str)`→`“Attr”`
`create_tree_walker(root: “Node”, what_to_show: int, node_filter: “Callable[[Node], int]	None”)`→`“TreeWalker”`
`create_node_iterator(root: “Node”, what_to_show: int, node_filter: “Callable[[Node], int]	None”)`→`“NodeIterator”`
`adopt_node(node: Node)` → `Node`	Adopt node إلى هذا المستند، مع نقلها من شجرتها الحالية.
`import_node(node: Node, deep: bool)` → `Node`	إرجاع نسخة من node المملوكة لهذا المستند.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	إرجاع جميع العناصر المتفرعة ذات اسم العلامة المعطى.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	إرجاع جميع العناصر المتفرعة التي تحمل جميع أسماء الفئات المحددة.
`filter_fn(el: Element)` → `bool`	يستدعي filter_fn(el) على هذه المثلة من Document.
`get_elements_by_name(name: str)` → `NodeList`	إرجاع جميع العناصر السفلية التي `name` السمة تساوي name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes قبل العنصر الأول لهذا المستند.
`append()`	Append nodes كآخر العناصر لهذا المستند.
`replace_children()`	إزالة جميع العناصر الفرعية لهذا المستند، ثم إلحاق nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	أرجع NodeList ثابتًا لجميع العناصر المطابقة لمحدد CSS.
`get_animations()` → `list[object]`	أرجع الرسوم المتحركة على مستوى المستند (headless stub: دائمًا `[]`).
`element_from_point(x: float, y: float)`	دائمًا `None` — headless لا يمتلك محرك تخطيط لاختبار الضربات (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	دائمًا `[]` — لا يحتوي headless على محرك تخطيط لاختبار الضربة (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	دائمًا `False` — أمر تحرير قديم؛ لا توجد أنابيب في headless (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	دائمًا `False` — لا توجد أنابيب تحرير في الوضع غير المتصل (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	دائمًا `True` — يُعامل أصل headless كأصل من نفس الأصل (Storage Access API).
`request_storage_access()`	دالة تجريبية لا تفعل شيئًا — headless دائمًا لديه وصول إلى التخزين؛ لا حاجة لمنح غير متزامن (Storage Access API).
`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