Document

Prezentare generală

Document este o clasă în Aspose.Html FOSS pentru Python. Moștenește de la: Node.

Rădăcina unui arbore DOM.

Această clasă oferă 66 de metode pentru lucrul cu obiecte Document în programe Python. Metodele disponibile includ: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns, și 54 de metode suplimentare. Toți membrii publici sunt accesibili oricărei aplicații Python după instalarea pachetului Aspose.Html FOSS pentru Python. Proprietăți: a_link_color, active_element, adopted_style_sheets, all, anchors, applets, și încă 67.

Proprietăți

Nume	Tip	Acces	Descriere:
`default_view`	``	Citire	Obiect Window per-document (lazy, cached).
`location`	``	Citire	Returnează obiectul Location al ferestrei asociate, sau `None`.
`implementation`	`"DOMImplementation"`	Citire	Obiect DOMImplementation per-document (lazy, cached).
`dom_config`	`DOMConfiguration`	Citire	Obiect DOMConfiguration per-document (leneș, în cache).
`url`	`str`	Citire	URL-ul documentului (WHATWG `Document.URL`), implicit `"about:blank"`.
`document_uri`	`str`	Citire	URL-ul documentului ca șir de caractere (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	Citire	URL de bază rezolvat pentru acest document (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	Citire	URL-ul documentului de referință (WHATWG HTML Standard §document).
`domain`	`str`	Citire	Componenta hostname a URL-ului documentului (WHATWG HTML Standard §document).
`last_modified`	`str`	Citire	Șirul de marcaj temporal de ultimă modificare (WHATWG HTML Standard §document).
`cookie`	`str`	Citire/Scriere	Șablon de șir cookie doar în citire — întotdeauna returnează `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	Citire	Whether the document is hidden — always `False` in headless mode.
`visibility_state`	`str`	Citire	Document visibility state — always `"visible"` in headless mode.
`design_mode`	`str`	Citire/Scriere	Whether the document is in design mode (WHATWG HTML §7.6.4).
`dir`	`str`	Citire/Scriere	Direcția textului documentului (WHATWG HTML §3.3.2).
`current_script`	`None`	Citire	Elementul script în execuție curentă (WHATWG HTML §8.1.3.4).
`character_set`	`str`	Citire	Codificarea caracterelor utilizată în timpul parsării (WHATWG DOM §3.1).
`charset`	`str`	Citire	Alias pentru :attr:`character_set` (nume standard HTML).
`input_encoding`	`str`	Citire	Alias pentru :attr:`character_set` (nume de compatibilitate DOM WHATWG).
`content_type`	`str`	Citire	Tip MIME al documentului; întotdeauna `"text/html"` pentru documente HTML.
`style_sheets`	`"StyleSheetList"`	Citire	Listă de foi de stil a documentului live.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	Citire/Scriere	Listă de adoptare a foilor de stil constructibile la nivel de document.
`node_name`	`str`	Citire	`'#document'`
`document_element`	`Element	None`	Citire
`document_type`	`DocumentType	None`	Citire
`compat_mode`	`str`	Citire/Scriere	`'BackCompat'` (quirks) sau `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	Citire	Starea de încărcare a documentului.
`parse_errors`	`list[ParseError]`	Citire	Erori de parsare din ultima operație de parsare.
`head`	`Element	None`	Citire
`body`	`Element	None`	Citire
`forms`	`"HTMLCollection"`	Citire	Colecție live a tuturor elementelor `<form>` din document.
`images`	`"HTMLCollection"`	Citire	Colecție live a tuturor elementelor `<img>` din document.
`links`	`"HTMLCollection"`	Citire	Colecție live a elementelor `<a href>` și `<area href>`.
`scripts`	`"HTMLCollection"`	Citire	Colecție în timp real a tuturor elementelor `<script>` din document.
`embeds`	`"HTMLCollection"`	Citire	Colecție live a tuturor descendenților `<embed>`.
`applets`	`"HTMLCollection"`	Citire	Colecție live a tuturor descendenților `<applet>`.
`anchors`	`"HTMLCollection"`	Citire	Colecție live de elemente `<a name=...>` (ancore denumite învechite).
`title`	`str`	Citire/Scriere	Conținutul text al primului element `<title>` din `<head>`.
`compatible_mode`	`str`	Citire	Indicator de mod quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	Citire/Scriere	Întotdeauna `True` în modul headless (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	Citire
`last_element_child`	`“Element	None”`	Citire
`child_element_count`	`int`	Citire	Numărul de copii direcți care sunt noduri Element.
`active_element`	`“Element	None”`	Citire
`full_screen_enabled`	`bool`	Citire	Întotdeauna `False` — fără afișare în modul headless (Fullscreen API §7).
`fullscreen_element`	`None`	Citire	Întotdeauna `None` — niciun element fullscreen în modul headless (Fullscreen API §7).
`pointer_lock_element`	`None`	Citire	Întotdeauna `None` — fără blocare a cursorului în modul headless (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	Citire	Stub al cronologiei documentului; `current_time` este întotdeauna `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	Citire	Toate elementele în ordine de arbore (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	Citire	Alias pentru :attr:`embeds` conform WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	Citire	Copii direcți de elemente ai documentului (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	Citire	Șir de origine opac — întotdeauna `'null'` în modul headless (WHATWG DOM §4.5).
`fg_color`	`str`	Citire/Scriere	Reflectă atributul învechit `fgColor` la nivel de document prin atributul `<body>` `text`.
`bg_color`	`str`	Citire/Scriere	Reflectă atributul la nivel de document `bgColor` învechit prin atributul `<body>` `bgcolor`.
`link_color`	`str`	Citire/Scriere	Reflectă atributul la nivel de document `linkColor` învechit prin atributul `<body>` `link`.
`v_link_color`	`str`	Citire/Scriere	Reflectă atributul la nivel de document `vlinkColor` învechit prin atributul `<body>` `vlink`.
`a_link_color`	`str`	Citire/Scriere	Reflectă atributul la nivel de document `alinkColor` învechit prin atributul `<body>` `alink`.
`fonts`	``	Citire	Întotdeauna `None` în modul headless.
`picture_in_picture_enabled`	`bool`	Citire	Întotdeauna `False` în modul headless.
`picture_in_picture_element`	``	Citire	Întotdeauna `None` în modul headless.
`prerendering`	`bool`	Citire	Întotdeauna `False` în modul headless.
`node_type`	`int`	Citire	Constanta de tip nod întreg de la `NodeType`.
`node_value`	`str	None`	Citire/Scriere
`text_content`	`str	None`	Citire/Scriere
`parent_node`	`Node	None`	Citire
`parent_element`	`Element	None`	Citire
`is_connected`	`bool`	Citire	Indică dacă acest nod face parte din arborele de noduri al unui document (WHATWG DOM §4.4).
`owner_document`	`Document	None`	Citire
`child_nodes`	`NodeList`	Citire	Un NodeList în timp real al tuturor nodurilor copil.
`first_child`	`Node	None`	Citire
`last_child`	`Node	None`	Citire
`previous_sibling`	`Node	None`	Citire
`next_sibling`	`Node	None`	Citire

Metode

Semnătură	Descriere:
`__init__()`	Calls init pe această instanță Document.
`normalize_document()`	Normalizează acest document utilizând semantica existentă `Node.normalize`.
`has_focus()` → `bool`	Returnează dacă documentul are focalizare — întotdeauna `False` în modul headless.
`open(type: str, replace: str)` → `"Document"`	Deschide documentul pentru scriere (WHATWG HTML §7.7).
`close()`	Închide documentul după scriere (WHATWG HTML §7.7).
`write()`	Scrie un șir în fluxul documentului (WHATWG HTML §7.7).
`writeln()`	Scrie un șir urmat de o linie nouă (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	Atașează o foaie de stil la acest document.
`detach_style_sheet(sheet: "CSSStyleSheet")`	Dezleagă o foaie de stil atașată anterior.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	Creează un HTMLElement deținut de acest document.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	Creează un Element într-un spațiu de nume specific, deținut de acest document.
`create_text_node(data: str)` → `Text`	Creează un nod Text cu datele de caractere furnizate.
`create_comment(data: str)` → `Comment`	Creează un nod Comentariu cu datele de caractere furnizate.
`create_cdata_section(data: str)` → `"CDATASection"`	Creează un nod CDATASection deținut de acest document.
`create_document_fragment()` → `DocumentFragment`	Creează un DocumentFragment gol deținut de acest document.
`create_event(interface: str)` → `"Event"`	Creează un obiect de eveniment legacy pentru interface.
`create_range()` → `"Range"`	Creează un nou Range colapsat în acest document.
`get_selection()` → `"Selection"`	Returnează obiectul de selecție singleton al acestui document.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	Creează un nod ProcessingInstruction deținut de acest document.
`create_attribute(local_name: str)` → `"Attr"`	Creează un `Attr` fără spațiu de nume deținut de acest 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 în acest document, mutându-l din arborele său curent.
`import_node(node: Node, deep: bool)` → `Node`	Returnează o clonă a node deținut de acest document.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	Returnează toate elementele descendente cu numele de etichetă specificat.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	Returnează toate elementele descendente cu toate numele de clasă specificate.
`filter_fn(el: Element)` → `bool`	Apelează filter_fn(el) pe această instanță de Document.
`get_elements_by_name(name: str)` → `NodeList`	Returnează toate elementele descendente ale căror `name` atributul este egal cu name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes înainte de primul copil al acestui document.
`append()`	Append nodes ca ultimii copii ai acestui document.
`replace_children()`	Elimină toți copiii acestui document, apoi adaugă nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Returnați un NodeList static al tuturor elementelor care corespund selectorului CSS.
`get_animations()` → `list[object]`	Returnați animațiile la nivel de document (stub headless: întotdeauna `[]`).
`element_from_point(x: float, y: float)`	Întotdeauna `None` — headless nu are motor de layout pentru hit testing (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	Întotdeauna `[]` — headless nu are motor de layout pentru hit testing (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	Întotdeauna `False` — comandă de editare învechită; fără pipeline în headless (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	Întotdeauna `False` — nu există un pipeline de editare în headless (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	Întotdeauna `True` — originea headless este tratată ca aceeași origine (Storage Access API).
`request_storage_access()`	Stub fără efect — headless are întotdeauna acces la stocare; nu este necesară nicio acordare asincronă (Storage Access API).
`get_root_node(composed: bool)` → `"Node"`	Returnează rădăcina arborelui nodului.
`has_child_nodes()` → `bool`	Returnează dacă acest nod are cel puțin un nod copil direct.
`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 ca ultimul copil al acestui nod.
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node din lista de copii și o returnează.
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	Returnează o copie a acestui nod.
`normalize()`	Pune acest nod și întregul său subarbore în formă normalizată.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Returnaţi o mască de biţi care descrie poziţia other în raport cu acest nod.
`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 pentru evenimentele de type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	Anulează înregistrarea unui ascultător înregistrat anterior.
`dispatch_event(event: "Event")` → `bool`	Dispatch event prin arborele strămoșilor.

Vezi și:

Aspose.HTML for Python — Enterprise API Reference