Document
Document
Översikt
Document är en klass i Aspose.Html FOSS för Python. Ärver från: Node.
Roten av ett DOM-träd.
Denna klass tillhandahåller 66 metoder för att arbeta med Document-objekt i Python-program. Tillgängliga metoder inkluderar: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns och 54 ytterligare metoder. Alla offentliga medlemmar är tillgängliga för alla Python-applikationer efter att ha installerat Aspose.Html FOSS för Python-paketet. Egenskaper: a_link_color, active_element, adopted_style_sheets, all, anchors, applets och 67 till.
Egenskaper
| Namn | Typ | Åtkomst | Beskrivning |
|---|---|---|---|
default_view | `` | Läs | Per-dokument Window-objekt (lat, cachat). |
location | `` | Läs | Returnera det associerade Window-objektets Location-objekt, eller None. |
implementation | "DOMImplementation" | Läs | Per-dokument DOMImplementation-objekt (lat, cachat). |
dom_config | DOMConfiguration | Läs | Per-dokument DOMConfiguration-objekt (lat, cachat). |
url | str | Läs | Dokument-URL (WHATWG Document.URL), standard "about:blank". |
document_uri | str | Läs | Dokumentets URL som en sträng (WHATWG DOM §4.5 documentURI). |
base_uri | str | Läs | Uppslaget bas-URL för detta dokument (WHATWG DOM Node.baseURI). |
referrer | str | Läs | Refererande dokument-URL (WHATWG HTML Standard §document). |
domain | str | Läs | Hostname-komponent i dokumentets URL (WHATWG HTML Standard §document). |
last_modified | str | Läs | Sträng för senaste ändringstidstämpel (WHATWG HTML Standard §document). |
cookie | str | Läs/Skriv | Read-only cookie-sträng-stub — returnerar alltid "" (WHATWG HTML §8.11.1). |
hidden | bool | Läs | Om dokumentet är dolt — alltid False i huvudlöst läge. |
visibility_state | str | Läs | Dokumentets synlighetstillstånd — alltid "visible" i huvudlöst läge. |
design_mode | str | Läs/Skriv | Om dokumentet är i designläge (WHATWG HTML §7.6.4). |
dir | str | Läs/Skriv | Dokumentets textriktning (WHATWG HTML §3.3.2). |
current_script | None | Läs | Det för närvarande körande skriptelementet (WHATWG HTML §8.1.3.4). |
character_set | str | Läs | Teckenkodning som används under parsning (WHATWG DOM §3.1). |
charset | str | Läs | Alias för :attr:character_set (HTML standardnamn). |
input_encoding | str | Läs | Alias för :attr:character_set (WHATWG DOM-kompatibilitetsnamn). |
content_type | str | Läs | Dokumentets MIME-typ; alltid "text/html" för HTML-dokument. |
style_sheets | "StyleSheetList" | Läs | Lista över live-dokumentstilmallar. |
adopted_style_sheets | list["CSSStyleSheet"] | Läs/Skriv | Lista över konstruerbara stilmallar på dokumentnivå. |
node_name | str | Läs | '#document' |
document_element | `Element | None` | Läs |
document_type | `DocumentType | None` | Läs |
compat_mode | str | Läs/Skriv | 'BackCompat' (quirks) eller 'CSS1Compat' (no-quirks). |
ready_state | str | Läs | Dokumentets laddningsstatus. |
parse_errors | list[ParseError] | Läs | Parse-fel från den senaste parse-operationen. |
head | `Element | None` | Läs |
body | `Element | None` | Läs |
forms | "HTMLCollection" | Läs | Live-samling av alla <form> element i dokumentet. |
images | "HTMLCollection" | Läs | Live-samling av alla <img> element i dokumentet. |
links | "HTMLCollection" | Läs | Live-samling av <a href> och <area href> element. |
scripts | "HTMLCollection" | Läs | Live-samling av alla <script>-element i dokumentet. |
embeds | "HTMLCollection" | Läs | Live-samling av alla <embed>-efterkommande. |
applets | "HTMLCollection" | Läs | Live-samling av alla <applet>-efterkommande. |
anchors | "HTMLCollection" | Läs | Levande samling av <a name=...> element (äldre namngivna ankare). |
title | str | Läs/Skriv | Textinnehållet i det första <title> elementet i <head>. |
compatible_mode | str | Läs | Quirks-mode-indikator (WHATWG HTML §3.2.1). |
strict_error_checking | bool | Läs/Skriv | Alltid True i huvudlöst läge (DOM3 Core §1.1.1). |
first_element_child | `“Element | None”` | Läs |
last_element_child | `“Element | None”` | Läs |
child_element_count | int | Läs | Antalet direkta barn som är Element-noder. |
active_element | `“Element | None”` | Läs |
full_screen_enabled | bool | Läs | Alltid False — ingen display i headless-läge (Fullscreen API §7). |
fullscreen_element | None | Läs | Alltid None — ingen fullskärms-element i headless-läge (Fullscreen API §7). |
pointer_lock_element | None | Läs | Alltid None — ingen pekarlås i headless-läge (Pointer Lock API §4). |
timeline | "_DocumentTimeline" | Läs | Stub för dokumenttidslinje; current_time är alltid 0.0 (Web Animations API §6.2). |
all | "_AllCollection" | Läs | Alla element i trädordning (WHATWG HTML §legacy document layout interface). |
plugins | "HTMLCollection" | Läs | Alias för :attr:embeds enligt WHATWG HTML §4.1 legacy interface. |
children | "HTMLCollection" | Läs | Direkta elementbarn till dokumentet (WHATWG DOM §4.2.6 ParentNode). |
origin | str | Läs | Opak ursprungssträng — alltid 'null' i huvudlöst läge (WHATWG DOM §4.5). |
fg_color | str | Läs/Skriv | Avspeglar föråldrat fgColor dokumentnivåattribut via <body> text-attribut. |
bg_color | str | Läs/Skriv | Återspeglar föråldrat bgColor dokumentnivåattribut via <body> bgcolor attribut. |
link_color | str | Läs/Skriv | Återspeglar föråldrat linkColor dokumentnivåattribut via <body> link attribut. |
v_link_color | str | Läs/Skriv | Återspeglar föråldrat vlinkColor dokumentnivåattribut via <body> vlink attribut. |
a_link_color | str | Läs/Skriv | Återspeglar föråldrat alinkColor dokumentnivåattribut via <body> alink attribut. |
fonts | `` | Läs | Alltid None i huvudlöst läge. |
picture_in_picture_enabled | bool | Läs | Alltid False i huvudlöst läge. |
picture_in_picture_element | `` | Läs | Alltid None i headless mode. |
prerendering | bool | Läs | Alltid False i headless mode. |
node_type | int | Läs | Heltalsnodtypkonstant från NodeType. |
node_value | `str | None` | Läs/Skriv |
text_content | `str | None` | Läs/Skriv |
parent_node | `Node | None` | Läs |
parent_element | `Element | None` | Läs |
is_connected | bool | Läs | Om den här noden är en del av ett dokuments nodträd (WHATWG DOM §4.4). |
owner_document | `Document | None` | Läs |
child_nodes | NodeList | Läs | En live NodeList av alla barnnoder. |
first_child | `Node | None` | Läs |
last_child | `Node | None` | Läs |
previous_sibling | `Node | None` | Läs |
next_sibling | `Node | None` | Läs |
Metoder
| Signatur | Beskrivning |
|---|---|
__init__() | Calls init på detta Document-instans. |
normalize_document() | Normalisera detta dokument med befintlig Node.normalize semantik. |
has_focus() → bool | Returnera om dokumentet har fokus — alltid False i huvudlöst läge. |
open(type: str, replace: str) → "Document" | Öppna dokumentet för skrivning (WHATWG HTML §7.7). |
close() | Stäng dokumentet efter att ha skrivit (WHATWG HTML §7.7). |
write() | Skriv en sträng till dokumentströmmen (WHATWG HTML §7.7). |
writeln() | Skriv en sträng följt av en ny rad (WHATWG HTML §7.7). |
attach_style_sheet(sheet: "CSSStyleSheet") | Bifoga en stylesheet till detta dokument. |
detach_style_sheet(sheet: "CSSStyleSheet") | Koppla bort en tidigare bifogad stilmall. |
| `save(path: “str | pathlib.Path”, encoding: str)` |
create_element(tag_name: str) → "HTMLElement" | Skapa ett HTMLElement som ägs av detta dokument. |
create_element_ns(namespace_uri: str, qualified_name: str) → Element | Skapa ett Element i ett specifikt namnrum, som ägs av detta dokument. |
create_text_node(data: str) → Text | Skapa en Text-nod med den angivna teckendatan. |
create_comment(data: str) → Comment | Skapa en Kommentar-nod med den angivna teckendatan. |
create_cdata_section(data: str) → "CDATASection" | Skapa en CDATASection-nod som ägs av detta dokument. |
create_document_fragment() → DocumentFragment | Skapa ett tomt DocumentFragment som ägs av detta dokument. |
create_event(interface: str) → "Event" | Skapa ett legacy event object för interface. |
create_range() → "Range" | Skapa ett nytt Range som är kollapsat i detta dokument. |
get_selection() → "Selection" | Returnera detta dokuments singleton selection-objekt. |
create_processing_instruction(target: str, data: str) → "ProcessingInstruction" | Skapa en ProcessingInstruction-nod som ägs av detta dokument. |
create_attribute(local_name: str) → "Attr" | Skapa en icke-namnrymds Attr som ägs av detta dokument. |
| `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 till detta dokument, genom att flytta det från dess nuvarande träd. |
import_node(node: Node, deep: bool) → Node | Returnera en klon av node ägda av detta dokument. |
get_element_by_id(id: str) → `Element | None` |
get_elements_by_tag_name(name: str) → HTMLCollection | Returnera alla underordnade element med det angivna taggnamnet. |
get_elements_by_class_name(names: str) → HTMLCollection | Returnera alla underordnade element med alla de angivna klassnamnen. |
filter_fn(el: Element) → bool | Anropar filter_fn(el) på detta Document-instans. |
get_elements_by_name(name: str) → NodeList | Returnera alla underordnade element vars name attributet är lika med name. |
| `get_elements_by_tag_name_ns(namespace: “str | None”, local_name: str)→list` |
prepend() | Insert nodes före det första barnet i detta dokument. |
append() | Append nodes som de sista barnen i detta dokument. |
replace_children() | Ta bort alla barn i detta dokument, och lägg sedan till nodes. |
query_selector(selector: str) → `Element | None` |
query_selector_all(selector: str) → NodeList | Returnera en statisk NodeList av alla element som matchar CSS-selektorn. |
get_animations() → list[object] | Returnera dokumentnivåanimationer (headless-stub: alltid []). |
element_from_point(x: float, y: float) | Alltid None — headless har ingen layoutmotor för träfftestning (CSSOM View §11.6). |
elements_from_point(x: float, y: float) → list | Alltid [] — headless har ingen layoutmotor för träfftestning (CSSOM View §11.6). |
exec_command(command_id: str, show_ui: bool, value: str) → bool | Alltid False — äldre redigeringskommando; ingen pipeline i huvudlös (WHATWG HTML §8.6.1). |
query_command_enabled(command_id: str) → bool | Alltid False — ingen redigeringspipeline i headless (WHATWG HTML §8.6.1). |
has_storage_access() → bool | Alltid True — headless origin behandlas som samma origin (Storage Access API). |
request_storage_access() | No-op stub — headless har alltid lagringsåtkomst; ingen asynkron beviljning behövs (Storage Access API). |
get_root_node(composed: bool) → "Node" | Returnera roten av nodens träd. |
has_child_nodes() → bool | Returnera om den här noden har minst ett direkt barnnod. |
| `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 som det sista barnet i den här noden. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node från barnlistan och returnera den. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | Returnera en kopia av den här noden. |
normalize() | Placera den här noden och hela dess underträd i normaliserad form. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | Returnera en bitmask som beskriver positionen för other relativt den här noden. |
| `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 händelser av type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | Avregistrera en tidigare registrerad lyssnare. |
dispatch_event(event: "Event") → bool | Dispatch event genom förfädersträdet. |