Document

Gambaran Umum

Document adalah kelas dalam Aspose.Html FOSS untuk Python. Mewarisi dari: Node.

Akar dari pohon DOM.

Kelas ini menyediakan 66 metode untuk bekerja dengan objek Document dalam program Python. Metode yang tersedia meliputi: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns, dan 54 metode tambahan. Semua anggota publik dapat diakses oleh aplikasi Python mana pun setelah menginstal paket Aspose.Html FOSS untuk Python. Properti: a_link_color, active_element, adopted_style_sheets, all, anchors, applets, dan 67 lagi.

Properti

Nama	Jenis	Akses	Deskripsi
`default_view`	``	Baca	Objek Window per-Dokumen (lazy, cached).
`location`	``	Baca	Kembalikan objek Location dari Window yang terkait, atau `None`.
`implementation`	`"DOMImplementation"`	Baca	Objek DOMImplementation per-Dokumen (lazy, cached).
`dom_config`	`DOMConfiguration`	Baca	Objek DOMConfiguration per-dokumen (malas, di-cache).
`url`	`str`	Baca	URL Dokumen (WHATWG `Document.URL`), default `"about:blank"`.
`document_uri`	`str`	Baca	URL dokumen sebagai string (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	Baca	URL dasar yang diresolusikan untuk dokumen ini (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	Baca	URL dokumen rujukan (WHATWG HTML Standard §document).
`domain`	`str`	Baca	Komponen hostname dari URL dokumen (WHATWG HTML Standard §document).
`last_modified`	`str`	Baca	String cap waktu terakhir dimodifikasi (WHATWG HTML Standard §document).
`cookie`	`str`	Baca/Tulis	Stub string cookie hanya-baca — selalu mengembalikan `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	Baca	Apakah dokumen disembunyikan — selalu `False` dalam mode headless.
`visibility_state`	`str`	Baca	Status visibilitas dokumen — selalu `"visible"` dalam mode headless.
`design_mode`	`str`	Baca/Tulis	Apakah dokumen berada dalam mode desain (WHATWG HTML §7.6.4).
`dir`	`str`	Baca/Tulis	Arah teks dokumen (WHATWG HTML §3.3.2).
`current_script`	`None`	Baca	Elemen skrip yang sedang dieksekusi (WHATWG HTML §8.1.3.4).
`character_set`	`str`	Baca	Pengkodean karakter yang digunakan selama parsing (WHATWG DOM §3.1).
`charset`	`str`	Baca	Alias untuk :attr:`character_set` (HTML nama standar).
`input_encoding`	`str`	Baca	Alias untuk :attr:`character_set` (nama kompatibilitas WHATWG DOM).
`content_type`	`str`	Baca	Tipe MIME dokumen; selalu `"text/html"` untuk dokumen HTML.
`style_sheets`	`"StyleSheetList"`	Baca	Daftar stylesheet dokumen langsung.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	Baca/Tulis	Daftar adopsi stylesheet yang dapat dibangun pada tingkat dokumen.
`node_name`	`str`	Baca	`'#document'`
`document_element`	`Element	None`	Baca
`document_type`	`DocumentType	None`	Baca
`compat_mode`	`str`	Baca/Tulis	`'BackCompat'` (quirks) atau `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	Baca	Status pemuatan dokumen.
`parse_errors`	`list[ParseError]`	Baca	Kesalahan parsing dari operasi parse terakhir.
`head`	`Element	None`	Baca
`body`	`Element	None`	Baca
`forms`	`"HTMLCollection"`	Baca	Koleksi langsung dari semua elemen `<form>` dalam dokumen.
`images`	`"HTMLCollection"`	Baca	Koleksi langsung dari semua elemen `<img>` dalam dokumen.
`links`	`"HTMLCollection"`	Baca	Koleksi langsung dari elemen `<a href>` dan `<area href>`.
`scripts`	`"HTMLCollection"`	Baca	Koleksi langsung dari semua elemen `<script>` dalam dokumen.
`embeds`	`"HTMLCollection"`	Baca	Koleksi langsung semua keturunan `<embed>`.
`applets`	`"HTMLCollection"`	Baca	Koleksi langsung semua keturunan `<applet>`.
`anchors`	`"HTMLCollection"`	Baca	Koleksi langsung dari elemen `<a name=...>` (anchor bernama warisan).
`title`	`str`	Baca/Tulis	Konten teks dari elemen `<title>` pertama dalam `<head>`.
`compatible_mode`	`str`	Baca	Indikator mode quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	Baca/Tulis	Selalu `True` dalam mode headless (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	Baca
`last_element_child`	`“Element	None”`	Baca
`child_element_count`	`int`	Baca	Jumlah anak langsung yang merupakan node Elemen.
`active_element`	`“Element	None”`	Baca
`full_screen_enabled`	`bool`	Baca	Selalu `False` — tidak ada tampilan dalam mode headless (Fullscreen API §7).
`fullscreen_element`	`None`	Baca	Selalu `None` — tidak ada elemen fullscreen dalam mode headless (Fullscreen API §7).
`pointer_lock_element`	`None`	Baca	Selalu `None` — tidak ada pointer lock dalam mode headless (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	Baca	Stub timeline dokumen; `current_time` selalu `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	Baca	Semua elemen dalam urutan pohon (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	Baca	Alias untuk :attr:`embeds` per WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	Baca	Anak elemen langsung dari dokumen (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	Baca	String asal yang tidak dapat dilihat — selalu `'null'` dalam mode headless (WHATWG DOM §4.5).
`fg_color`	`str`	Baca/Tulis	Merefleksikan atribut tingkat dokumen `fgColor` yang usang melalui atribut `<body>` `text`.
`bg_color`	`str`	Baca/Tulis	Merefleksikan atribut tingkat dokumen `bgColor` yang usang melalui atribut `<body>` `bgcolor`.
`link_color`	`str`	Baca/Tulis	Mencerminkan atribut tingkat dokumen `linkColor` yang usang melalui atribut `<body>` `link`.
`v_link_color`	`str`	Baca/Tulis	Mencerminkan atribut tingkat dokumen `vlinkColor` yang usang melalui atribut `<body>` `vlink`.
`a_link_color`	`str`	Baca/Tulis	Mencerminkan atribut tingkat dokumen `alinkColor` yang usang melalui atribut `<body>` `alink`.
`fonts`	``	Baca	Selalu `None` dalam mode headless.
`picture_in_picture_enabled`	`bool`	Baca	Selalu `False` dalam mode headless.
`picture_in_picture_element`	``	Baca	Selalu `None` dalam mode headless.
`prerendering`	`bool`	Baca	Selalu `False` dalam mode tanpa kepala.
`node_type`	`int`	Baca	Konstanta tipe node integer dari `NodeType`.
`node_value`	`str	None`	Baca/Tulis
`text_content`	`str	None`	Baca/Tulis
`parent_node`	`Node	None`	Baca
`parent_element`	`Element	None`	Baca
`is_connected`	`bool`	Baca	Apakah node ini merupakan bagian dari pohon node dokumen (WHATWG DOM §4.4).
`owner_document`	`Document	None`	Baca
`child_nodes`	`NodeList`	Baca	Sebuah NodeList langsung dari semua node anak.
`first_child`	`Node	None`	Baca
`last_child`	`Node	None`	Baca
`previous_sibling`	`Node	None`	Baca
`next_sibling`	`Node	None`	Baca

Metode

Tanda tangan	Deskripsi
`__init__()`	Calls init pada instance Document ini.
`normalize_document()`	Normalisasi dokumen ini menggunakan semantik `Node.normalize` yang ada.
`has_focus()` → `bool`	Kembalikan apakah dokumen memiliki fokus — selalu `False` dalam mode headless.
`open(type: str, replace: str)` → `"Document"`	Buka dokumen untuk menulis (WHATWG HTML §7.7).
`close()`	Tutup dokumen setelah menulis (WHATWG HTML §7.7).
`write()`	Tulis string ke aliran dokumen (WHATWG HTML §7.7).
`writeln()`	Tuliskan sebuah string diikuti oleh baris baru (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	Lampirkan stylesheet ke dokumen ini.
`detach_style_sheet(sheet: "CSSStyleSheet")`	Lepaskan stylesheet yang sebelumnya dilampirkan.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	Buat sebuah HTMLElement yang dimiliki oleh dokumen ini.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	Buat sebuah Element dalam namespace tertentu, yang dimiliki oleh dokumen ini.
`create_text_node(data: str)` → `Text`	Buat node Teks dengan data karakter yang diberikan.
`create_comment(data: str)` → `Comment`	Buat node Komentar dengan data karakter yang diberikan.
`create_cdata_section(data: str)` → `"CDATASection"`	Buat node CDATASection yang dimiliki oleh dokumen ini.
`create_document_fragment()` → `DocumentFragment`	Buat DocumentFragment kosong yang dimiliki oleh dokumen ini.
`create_event(interface: str)` → `"Event"`	Buat objek acara warisan untuk interface.
`create_range()` → `"Range"`	Buat Range baru yang terlipat pada dokumen ini.
`get_selection()` → `"Selection"`	Kembalikan objek pemilihan tunggal dokumen ini.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	Buat node ProcessingInstruction yang dimiliki oleh dokumen ini.
`create_attribute(local_name: str)` → `"Attr"`	Buat `Attr` non-namespaced yang dimiliki oleh dokumen ini.
`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 ke dalam dokumen ini, memindahkannya dari pohon saat ini.
`import_node(node: Node, deep: bool)` → `Node`	Kembalikan sebuah klon dari node dimiliki oleh dokumen ini.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	Kembalikan semua elemen turunan dengan nama tag yang diberikan.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	Kembalikan semua elemen turunan dengan semua nama kelas yang diberikan.
`filter_fn(el: Element)` → `bool`	Memanggil filter_fn(el) pada instance Document ini.
`get_elements_by_name(name: str)` → `NodeList`	Kembalikan semua elemen turunan yang `name` atributnya sama dengan name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes sebelum anak pertama dari dokumen ini.
`append()`	Append nodes sebagai anak terakhir dari dokumen ini.
`replace_children()`	Hapus semua anak dari dokumen ini, lalu tambahkan nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Kembalikan NodeList statis dari semua elemen yang cocok dengan selector CSS.
`get_animations()` → `list[object]`	Kembalikan animasi tingkat dokumen (stub headless: selalu `[]`).
`element_from_point(x: float, y: float)`	Selalu `None` — headless tidak memiliki mesin layout untuk pengujian hit (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	Selalu `[]` — headless tidak memiliki mesin tata letak untuk pengujian hit (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	Selalu `False` — perintah penyuntingan warisan; tidak ada pipeline di headless (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	Selalu `False` — tidak ada pipeline penyuntingan di headless (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	Selalu `True` — origin headless diperlakukan sebagai same-origin (Storage Access API).
`request_storage_access()`	Stub No-op — headless selalu memiliki akses penyimpanan; tidak perlu pemberian async (Storage Access API).
`get_root_node(composed: bool)` → `"Node"`	Kembalikan akar pohon node.
`has_child_nodes()` → `bool`	Kembalikan apakah node ini memiliki setidaknya satu node anak langsung.
`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 sebagai anak terakhir dari node ini.
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node dari daftar anak dan mengembalikannya.
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	Kembalikan salinan node ini.
`normalize()`	Masukkan node ini dan seluruh subtree-nya ke dalam bentuk normal.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Mengembalikan bitmask yang menggambarkan posisi other relatif terhadap node ini.
`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 untuk peristiwa type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	Batalkan pendaftaran pendengar yang sebelumnya terdaftar.
`dispatch_event(event: "Event")` → `bool`	Dispatch event melalui pohon leluhur.

Lihat Juga

Aspose.HTML for Python — Enterprise API Reference