Document
Document
Overzicht
Document is een class in Aspose.Html FOSS voor Python. Inherits from: Node.
De root van een DOM-boom.
Deze class biedt 66 methods voor het werken met Document-objecten in Python-programma’s. Beschikbare methods zijn: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns, en 54 extra methods. Alle public members zijn toegankelijk voor elke Python applicatie na het installeren van het Aspose.Html FOSS voor Python pakket. Eigenschappen: a_link_color, active_element, adopted_style_sheets, all, anchors, applets, en 67 meer.
Eigenschappen
| Naam | Type | Toegang | Beschrijving |
|---|---|---|---|
default_view | `` | Lezen | Per-document Window-object (lazy, cached). |
location | `` | Lezen | Retourneer het bijbehorende Window Location-object, of None. |
implementation | "DOMImplementation" | Lezen | Per-document DOMImplementation-object (lazy, cached). |
dom_config | DOMConfiguration | Lezen | Per-document DOMConfiguration-object (lui, gecacheerd). |
url | str | Lezen | Document-URL (WHATWG Document.URL), standaard "about:blank". |
document_uri | str | Lezen | De URL van het document als een string (WHATWG DOM §4.5 documentURI). |
base_uri | str | Lezen | Opgeloste basis-URL voor dit document (WHATWG DOM Node.baseURI). |
referrer | str | Lezen | Verwijzende document-URL (WHATWG HTML Standard §document). |
domain | str | Lezen | Hostnaamcomponent van de document-URL (WHATWG HTML Standard §document). |
last_modified | str | Lezen | Last-modified tijdstempelstring (WHATWG HTML Standard §document). |
cookie | str | Lezen/schrijven | Alleen-lezen cookie-string-stub — altijd "" terug (WHATWG HTML §8.11.1). |
hidden | bool | Lezen | Of het document verborgen is — altijd False in headless-modus. |
visibility_state | str | Lezen | Documentzichtbaarheidsstatus — altijd "visible" in headless-modus. |
design_mode | str | Lezen/schrijven | Of het document zich in ontwerpmode bevindt (WHATWG HTML §7.6.4). |
dir | str | Lezen/schrijven | Richting van de documenttekst (WHATWG HTML §3.3.2). |
current_script | None | Lezen | Het momenteel uitgevoerde script-element (WHATWG HTML §8.1.3.4). |
character_set | str | Lezen | Tekencodering gebruikt tijdens het parseren (WHATWG DOM §3.1). |
charset | str | Lezen | Alias voor :attr:character_set (HTML Standaardnaam). |
input_encoding | str | Lezen | Alias voor :attr:character_set (WHATWG DOM-compatibiliteitsnaam). |
content_type | str | Lezen | Document MIME-type; altijd "text/html" voor HTML documenten. |
style_sheets | "StyleSheetList" | Lezen | Live document stylesheet lijst. |
adopted_style_sheets | list["CSSStyleSheet"] | Lezen/schrijven | Documentniveau constructeerbare stylesheet adoptielijst. |
node_name | str | Lezen | '#document' |
document_element | `Element | None` | Lezen |
document_type | `DocumentType | None` | Lezen |
compat_mode | str | Lezen/schrijven | 'BackCompat' (quirks) of 'CSS1Compat' (no-quirks). |
ready_state | str | Lezen | Document laadtoestand. |
parse_errors | list[ParseError] | Lezen | Parse-fouten van de laatste parse-bewerking. |
head | `Element | None` | Lezen |
body | `Element | None` | Lezen |
forms | "HTMLCollection" | Lezen | Live-collectie van alle <form> elementen in het document. |
images | "HTMLCollection" | Lezen | Live-collectie van alle <img> elementen in het document. |
links | "HTMLCollection" | Lezen | Live-collectie van <a href> en <area href> elementen. |
scripts | "HTMLCollection" | Lezen | Live-collectie van alle <script> elementen in het document. |
embeds | "HTMLCollection" | Lezen | Live-collectie van alle <embed> afstammelingen. |
applets | "HTMLCollection" | Lezen | Live-collectie van alle <applet> afstammelingen. |
anchors | "HTMLCollection" | Lezen | Live-verzameling van <a name=...> elementen (verouderde benoemde ankers). |
title | str | Lezen/schrijven | De tekstinhoud van het eerste <title> element in <head>. |
compatible_mode | str | Lezen | Quirks-mode-indicator (WHATWG HTML §3.2.1). |
strict_error_checking | bool | Lezen/schrijven | Altijd True in headless-modus (DOM3 Core §1.1.1). |
first_element_child | `“Element | None”` | Lezen |
last_element_child | `“Element | None”` | Lezen |
child_element_count | int | Lezen | Aantal directe kinderen die Element-knooppunten zijn. |
active_element | `“Element | None”` | Lezen |
full_screen_enabled | bool | Lezen | Altijd False — geen weergave in headless-modus (Fullscreen API §7). |
fullscreen_element | None | Lezen | Altijd None — geen fullscreen-element in headless-modus (Fullscreen API §7). |
pointer_lock_element | None | Lezen | Altijd None — geen pointer lock in headless-modus (Pointer Lock API §4). |
timeline | "_DocumentTimeline" | Lezen | Documenttijdlijn stub; current_time is altijd 0.0 (Web Animations API §6.2). |
all | "_AllCollection" | Lezen | Alle elementen in boomvolgorde (WHATWG HTML §legacy document layout interface). |
plugins | "HTMLCollection" | Lezen | Alias voor :attr:embeds volgens WHATWG HTML §4.1 legacy interface. |
children | "HTMLCollection" | Lezen | Directe elementkinderen van het document (WHATWG DOM §4.2.6 ParentNode). |
origin | str | Lezen | Ondoorzichtige origin string — altijd 'null' in headless mode (WHATWG DOM §4.5). |
fg_color | str | Lezen/schrijven | Reflecteert verouderd fgColor document-niveau attribuut via <body> text attribuut. |
bg_color | str | Lezen/schrijven | Geeft verouderde bgColor documentniveau-attribuut weer via <body> bgcolor attribuut. |
link_color | str | Lezen/schrijven | Geeft verouderde linkColor documentniveau-attribuut weer via <body> link attribuut. |
v_link_color | str | Lezen/schrijven | Geeft verouderde vlinkColor documentniveau-attribuut weer via <body> vlink attribuut. |
a_link_color | str | Lezen/schrijven | Geeft verouderde alinkColor documentniveau-attribuut weer via <body> alink attribuut. |
fonts | `` | Lezen | Altijd None in headless-modus. |
picture_in_picture_enabled | bool | Lezen | Altijd False in headless-modus. |
picture_in_picture_element | `` | Lezen | Altijd None in headless-modus. |
prerendering | bool | Lezen | Altijd False in headless-modus. |
node_type | int | Lezen | Integer knooptype-constante van NodeType. |
node_value | `str | None` | Lezen/schrijven |
text_content | `str | None` | Lezen/schrijven |
parent_node | `Node | None` | Lezen |
parent_element | `Element | None` | Lezen |
is_connected | bool | Lezen | Of deze knoop deel uitmaakt van de knoopboom van een document (WHATWG DOM §4.4). |
owner_document | `Document | None` | Lezen |
child_nodes | NodeList | Lezen | Een live NodeList van alle kindknooppunten. |
first_child | `Node | None` | Lezen |
last_child | `Node | None` | Lezen |
previous_sibling | `Node | None` | Lezen |
next_sibling | `Node | None` | Lezen |
Methoden
| Handtekening | Beschrijving |
|---|---|
__init__() | Calls init op deze Document-instantie. |
normalize_document() | Normaliseer dit document met behulp van de bestaande Node.normalize-semantiek. |
has_focus() → bool | Geef terug of het document focus heeft — altijd False in headless-modus. |
open(type: str, replace: str) → "Document" | Open het document voor schrijven (WHATWG HTML §7.7). |
close() | Sluit het document na het schrijven (WHATWG HTML §7.7). |
write() | Schrijf een tekenreeks naar de documentstroom (WHATWG HTML §7.7). |
writeln() | Schrijf een tekenreeks gevolgd door een regeleinde (WHATWG HTML §7.7). |
attach_style_sheet(sheet: "CSSStyleSheet") | Voeg een stylesheet toe aan dit document. |
detach_style_sheet(sheet: "CSSStyleSheet") | Ontkoppel een eerder gekoppelde stylesheet. |
| `save(path: “str | pathlib.Path”, encoding: str)` |
create_element(tag_name: str) → "HTMLElement" | Maak een HTMLElement aan die eigendom is van dit document. |
create_element_ns(namespace_uri: str, qualified_name: str) → Element | Maak een Element aan in een specifieke namespace, eigendom van dit document. |
create_text_node(data: str) → Text | Maak een Text node met de opgegeven tekengegevens. |
create_comment(data: str) → Comment | Maak een Comment node met de opgegeven tekengegevens. |
create_cdata_section(data: str) → "CDATASection" | Maak een CDATASection-node die eigendom is van dit document. |
create_document_fragment() → DocumentFragment | Maak een lege DocumentFragment die eigendom is van dit document. |
create_event(interface: str) → "Event" | Maak een legacy event object voor interface. |
create_range() → "Range" | Maak een nieuw Range dat is samengevouwen op dit document. |
get_selection() → "Selection" | Retourneer het singleton-selectieobject van dit document. |
create_processing_instruction(target: str, data: str) → "ProcessingInstruction" | Maak een ProcessingInstruction node die eigendom is van dit document. |
create_attribute(local_name: str) → "Attr" | Maak een niet-genamespaceerde Attr die eigendom is van dit document. |
| `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 naar dit document, waarbij het uit zijn huidige boom wordt verplaatst. |
import_node(node: Node, deep: bool) → Node | Retourneer een kloon van node eigendom van dit document. |
get_element_by_id(id: str) → `Element | None` |
get_elements_by_tag_name(name: str) → HTMLCollection | Retourneer alle onderliggende elementen met de opgegeven tagnaam. |
get_elements_by_class_name(names: str) → HTMLCollection | Retourneer alle onderliggende elementen met al de opgegeven klassennamen. |
filter_fn(el: Element) → bool | Roept filter_fn(el) aan op deze Document-instantie. |
get_elements_by_name(name: str) → NodeList | Retourneer alle onderliggende elementen waarvan name attribuut gelijk is aan name. |
| `get_elements_by_tag_name_ns(namespace: “str | None”, local_name: str)→list` |
prepend() | Insert nodes vóór het eerste kind van dit document. |
append() | Append nodes als de laatste kinderen van dit document. |
replace_children() | Verwijder alle kinderen van dit document, en voeg vervolgens toe nodes. |
query_selector(selector: str) → `Element | None` |
query_selector_all(selector: str) → NodeList | Retourneer een statische NodeList van alle elementen die overeenkomen met de CSS selector. |
get_animations() → list[object] | Retourneer document-niveau animaties (headless stub: altijd []). |
element_from_point(x: float, y: float) | Altijd None — headless heeft geen layout engine voor hit testing (CSSOM View §11.6). |
elements_from_point(x: float, y: float) → list | Altijd [] — headless heeft geen layout engine voor hit testing (CSSOM View §11.6). |
exec_command(command_id: str, show_ui: bool, value: str) → bool | Altijd False — legacy bewerkingsopdracht; geen pipeline in headless (WHATWG HTML §8.6.1). |
query_command_enabled(command_id: str) → bool | Altijd False — geen bewerkingspijplijn in headless (WHATWG HTML §8.6.1). |
has_storage_access() → bool | Altijd True — headless-origin wordt behandeld als dezelfde origin (Storage Access API). |
request_storage_access() | No-op stub — headless heeft altijd opslagtoegang; geen async-toekenning nodig (Storage Access API). |
get_root_node(composed: bool) → "Node" | Retourneer de wortel van de boom van de node. |
has_child_nodes() → bool | Retourneer of dit knooppunt ten minste één direct kindknooppunt heeft. |
| `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 als het laatste kind van deze node. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node van de kinderlijst en retourneer deze. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | Retourneer een kopie van deze knoop. |
normalize() | Zet deze knoop en zijn volledige subboom in genormaliseerde vorm. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | Retourneer een bitmasker dat de positie beschrijft van other ten opzichte van dit knooppunt. |
| `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 voor evenementen van type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | Deregistreer een eerder geregistreerde listener. |
dispatch_event(event: "Event") → bool | Dispatch event via de voorouderboom. |