Document
Document
Übersicht
Document ist eine Klasse in Aspose.Html FOSS für Python. Erbt von: Node.
Die Wurzel eines DOM-Baums.
Diese Klasse stellt 66 Methoden zum Arbeiten mit Document-Objekten in Python-Programmen bereit. Verfügbare Methoden umfassen: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns und 54 weitere Methoden. Alle öffentlichen Mitglieder sind für jede Python-Anwendung zugänglich, nachdem das Aspose.Html FOSS für Python-Paket installiert wurde. Eigenschaften: a_link_color, active_element, adopted_style_sheets, all, anchors, applets und 67 weitere.
Eigenschaften
| Name | Typ | Zugriff | Beschreibung |
|---|---|---|---|
default_view | `` | Lesen | Pro-Dokument-Window-Objekt (lazy, cached). |
location | `` | Lesen | Gibt das zugehörige Window’s Location-Objekt zurück oder None. |
implementation | "DOMImplementation" | Lesen | Pro-Dokument-DOMImplementation-Objekt (lazy, cached). |
dom_config | DOMConfiguration | Lesen | Pro-Dokument DOMConfiguration-Objekt (lazy, cached). |
url | str | Lesen | Dokument-URL (WHATWG Document.URL), Standard "about:blank". |
document_uri | str | Lesen | Die URL des Dokuments als Zeichenkette (WHATWG DOM §4.5 documentURI). |
base_uri | str | Lesen | Aufgelöste Basis-URL für dieses Dokument (WHATWG DOM Node.baseURI). |
referrer | str | Lesen | URL des verweisenden Dokuments (WHATWG HTML Standard §document). |
domain | str | Lesen | Hostname-Komponente der Dokument-URL (WHATWG HTML Standard §document). |
last_modified | str | Lesen | Last-modified-Zeitstempel-String (WHATWG HTML Standard §document). |
cookie | str | Lesen/Schreiben | Read-only-Cookie-String-Stub — immer "" zurückgeben (WHATWG HTML §8.11.1). |
hidden | bool | Lesen | Ob das Dokument verborgen ist — immer False im Headless-Modus. |
visibility_state | str | Lesen | Dokument-Sichtbarkeitsstatus — immer "visible" im Headless-Modus. |
design_mode | str | Lesen/Schreiben | Ob das Dokument im Designmodus ist (WHATWG HTML §7.6.4). |
dir | str | Lesen/Schreiben | Textrichtung des Dokuments (WHATWG HTML §3.3.2). |
current_script | None | Lesen | Das aktuell ausgeführte Skriptelement (WHATWG HTML §8.1.3.4). |
character_set | str | Lesen | Zeichencodierung, die beim Parsen verwendet wird (WHATWG DOM §3.1). |
charset | str | Lesen | Alias für :attr:character_set (HTML Standardname). |
input_encoding | str | Lesen | Alias für :attr:character_set (WHATWG DOM-Kompatibilitätsname). |
content_type | str | Lesen | Dokument-MIME-Typ; immer "text/html" für HTML-Dokumente. |
style_sheets | "StyleSheetList" | Lesen | Live-Dokument-Stylesheet-Liste. |
adopted_style_sheets | list["CSSStyleSheet"] | Lesen/Schreiben | Dokumentebene konstruierbare Stylesheet-Adoptionsliste. |
node_name | str | Lesen | '#document' |
document_element | `Element | None` | Lesen |
document_type | `DocumentType | None` | Lesen |
compat_mode | str | Lesen/Schreiben | 'BackCompat' (quirks) oder 'CSS1Compat' (no-quirks). |
ready_state | str | Lesen | Ladezustand des Dokuments. |
parse_errors | list[ParseError] | Lesen | Parse-Fehler aus der letzten Parse-Operation. |
head | `Element | None` | Lesen |
body | `Element | None` | Lesen |
forms | "HTMLCollection" | Lesen | Live-Sammlung aller <form>-Elemente im Dokument. |
images | "HTMLCollection" | Lesen | Live-Sammlung aller <img>-Elemente im Dokument. |
links | "HTMLCollection" | Lesen | Live-Sammlung von <a href> und <area href>-Elementen. |
scripts | "HTMLCollection" | Lesen | Live-Sammlung aller <script>-Elemente im Dokument. |
embeds | "HTMLCollection" | Lesen | Live-Sammlung aller <embed>-Nachkommen. |
applets | "HTMLCollection" | Lesen | Live-Sammlung aller <applet>-Nachkommen. |
anchors | "HTMLCollection" | Lesen | Live-Sammlung von <a name=...>-Elementen (veraltete benannte Anker). |
title | str | Lesen/Schreiben | Der Textinhalt des ersten <title>-Elements in <head>. |
compatible_mode | str | Lesen | Quirks-Mode-Indikator (WHATWG HTML §3.2.1). |
strict_error_checking | bool | Lesen/Schreiben | Immer True im Headless-Modus (DOM3 Core §1.1.1). |
first_element_child | `“Element | None”` | Lesen |
last_element_child | `“Element | None”` | Lesen |
child_element_count | int | Lesen | Anzahl direkter Kinder, die Elementknoten sind. |
active_element | `“Element | None”` | Lesen |
full_screen_enabled | bool | Lesen | Immer False — keine Anzeige im headless mode (Fullscreen API §7). |
fullscreen_element | None | Lesen | Immer None — kein fullscreen element im headless mode (Fullscreen API §7). |
pointer_lock_element | None | Lesen | Immer None — kein pointer lock im headless mode (Pointer Lock API §4). |
timeline | "_DocumentTimeline" | Lesen | Dokumentzeitlinien-Stub; current_time ist immer 0.0 (Web Animations API §6.2). |
all | "_AllCollection" | Lesen | Alle Elemente in Baumreihenfolge (WHATWG HTML §legacy document layout interface). |
plugins | "HTMLCollection" | Lesen | Alias für :attr:embeds gemäß WHATWG HTML §4.1 legacy interface. |
children | "HTMLCollection" | Lesen | Direkte Elementkinder des Dokuments (WHATWG DOM §4.2.6 ParentNode). |
origin | str | Lesen | Undurchsichtiger Origin-String — immer 'null' im Headless-Modus (WHATWG DOM §4.5). |
fg_color | str | Lesen/Schreiben | Spiegelt das veraltete fgColor Dokument-Ebene-Attribut über das <body> text-Attribut. |
bg_color | str | Lesen/Schreiben | Spiegelt das veraltete bgColor Dokument-Ebene-Attribut über das <body> bgcolor Attribut wider. |
link_color | str | Lesen/Schreiben | Spiegelt das veraltete linkColor Dokument-Ebene-Attribut über das <body> link Attribut wider. |
v_link_color | str | Lesen/Schreiben | Spiegelt das veraltete vlinkColor Dokument-Ebene-Attribut über das <body> vlink Attribut wider. |
a_link_color | str | Lesen/Schreiben | Spiegelt das veraltete alinkColor Dokument-Ebene-Attribut über das <body> alink Attribut wider. |
fonts | `` | Lesen | Immer None im headless mode. |
picture_in_picture_enabled | bool | Lesen | Immer False im headless mode. |
picture_in_picture_element | `` | Lesen | Immer None im Headless-Modus. |
prerendering | bool | Lesen | Immer False im Headless-Modus. |
node_type | int | Lesen | Integer-Knoten-Typ-Konstante aus NodeType. |
node_value | `str | None` | Lesen/Schreiben |
text_content | `str | None` | Lesen/Schreiben |
parent_node | `Node | None` | Lesen |
parent_element | `Element | None` | Lesen |
is_connected | bool | Lesen | Ob dieser Knoten Teil des Knotensbaums eines Dokuments ist (WHATWG DOM §4.4). |
owner_document | `Document | None` | Lesen |
child_nodes | NodeList | Lesen | Ein Live-NodeList aller untergeordneten Knoten. |
first_child | `Node | None` | Lesen |
last_child | `Node | None` | Lesen |
previous_sibling | `Node | None` | Lesen |
next_sibling | `Node | None` | Lesen |
Methoden
| Signatur | Beschreibung |
|---|---|
__init__() | Calls init auf dieser Document-Instanz. |
normalize_document() | Normalisiere dieses Dokument unter Verwendung der vorhandenen Node.normalize-Semantik. |
has_focus() → bool | Gib zurück, ob das Dokument Fokus hat — immer False im headless mode. |
open(type: str, replace: str) → "Document" | Öffne das Dokument zum Schreiben (WHATWG HTML §7.7). |
close() | Schließen Sie das Dokument nach dem Schreiben (WHATWG HTML §7.7). |
write() | Schreiben Sie eine Zeichenkette in den Dokumentstream (WHATWG HTML §7.7). |
writeln() | Schreiben Sie eine Zeichenkette gefolgt von einem Zeilenumbruch (WHATWG HTML §7.7). |
attach_style_sheet(sheet: "CSSStyleSheet") | Fügen Sie diesem Dokument ein Stylesheet hinzu. |
detach_style_sheet(sheet: "CSSStyleSheet") | Entkoppeln Sie ein zuvor angehängtes Stylesheet. |
| `save(path: “str | pathlib.Path”, encoding: str)` |
create_element(tag_name: str) → "HTMLElement" | Erstellen Sie ein HTMLElement, das zu diesem Dokument gehört. |
create_element_ns(namespace_uri: str, qualified_name: str) → Element | Erstellen Sie ein Element in einem bestimmten Namensraum, das zu diesem Dokument gehört. |
create_text_node(data: str) → Text | Erstelle einen Textknoten mit den angegebenen Zeichendaten. |
create_comment(data: str) → Comment | Erstelle einen Kommentarknoten mit den angegebenen Zeichendaten. |
create_cdata_section(data: str) → "CDATASection" | Erstelle einen CDATASection-Knoten, der diesem Dokument gehört. |
create_document_fragment() → DocumentFragment | Erstelle ein leeres DocumentFragment, das diesem Dokument gehört. |
create_event(interface: str) → "Event" | Erstelle ein Legacy-Ereignisobjekt für interface. |
create_range() → "Range" | Erstelle einen neuen Range, der an diesem Dokument kollabiert. |
get_selection() → "Selection" | Gib das Singleton-Auswahlobjekt dieses Dokuments zurück. |
create_processing_instruction(target: str, data: str) → "ProcessingInstruction" | Erstelle einen ProcessingInstruction-Knoten, der diesem Dokument gehört. |
create_attribute(local_name: str) → "Attr" | Erstelle ein nicht-namensraumgebundenes Attr, das diesem Dokument gehört. |
| `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 in dieses Dokument, wobei es aus seinem aktuellen Baum verschoben wird. |
import_node(node: Node, deep: bool) → Node | Gib eine Kopie von zurück node die diesem Dokument gehört. |
get_element_by_id(id: str) → `Element | None` |
get_elements_by_tag_name(name: str) → HTMLCollection | Gib alle untergeordneten Elemente mit dem angegebenen Tag-Namen zurück. |
get_elements_by_class_name(names: str) → HTMLCollection | Gib alle untergeordneten Elemente mit allen angegebenen Klassennamen zurück. |
filter_fn(el: Element) → bool | Ruft filter_fn(el) für diese Dokumentinstanz auf. |
get_elements_by_name(name: str) → NodeList | Gibt alle Nachfahren-Elemente zurück, deren name Attribut gleich name. |
| `get_elements_by_tag_name_ns(namespace: “str | None”, local_name: str)→list` |
prepend() | Insert nodes vor dem ersten Kind dieses Dokuments. |
append() | Append nodes als die letzten Kinder dieses Dokuments. |
replace_children() | Entferne alle Kinder dieses Dokuments, dann anhängen nodes. |
query_selector(selector: str) → `Element | None` |
query_selector_all(selector: str) → NodeList | Gib ein statisches NodeList aller Elemente zurück, die dem CSS-Selektor entsprechen. |
get_animations() → list[object] | Gib Dokument-Ebene-Animationen zurück (headless stub: immer []). |
element_from_point(x: float, y: float) | Immer None — headless hat keine Layout-Engine für Hit-Testing (CSSOM View §11.6). |
elements_from_point(x: float, y: float) → list | Immer [] — headless hat keine Layout-Engine für Hit-Testing (CSSOM View §11.6). |
exec_command(command_id: str, show_ui: bool, value: str) → bool | Immer False — Legacy-Bearbeitungsbefehl; keine Pipeline im headless (WHATWG HTML §8.6.1). |
query_command_enabled(command_id: str) → bool | Immer False — keine Bearbeitungspipeline im headless (WHATWG HTML §8.6.1). |
has_storage_access() → bool | Immer True — die headless-Quelle wird als same-origin behandelt (Storage Access API). |
request_storage_access() | No-op-Stub — headless hat immer Storage Access; keine asynchrone Genehmigung nötig (Storage Access API). |
get_root_node(composed: bool) → "Node" | Gib die Wurzel des Baums des Knotens zurück. |
has_child_nodes() → bool | Gibt zurück, ob dieser Knoten mindestens ein direktes Kindknoten hat. |
| `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 letztes Kind dieses Knotens. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node aus der Kindliste und gib sie zurück. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | Gib eine Kopie dieses Knotens zurück. |
normalize() | Setze diesen Knoten und seinen gesamten Unterbaum in die normalisierte Form. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | Geben Sie eine Bitmaske zurück, die die Position von other relativ zu diesem Knoten. |
| `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 für Ereignisse von type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | Deregistrieren Sie einen zuvor registrierten Listener. |
dispatch_event(event: "Event") → bool | Dispatch event durch den Vorfahrenbaum. |
