Document

Panoramica

Document è una classe in Aspose.Html FOSS per Python. Eredita da: Node.

La radice di un albero DOM.

Questa classe fornisce 66 metodi per lavorare con gli oggetti Document nei programmi Python. I metodi disponibili includono: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns e 54 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione Python dopo aver installato il pacchetto Aspose.Html FOSS per Python. Proprietà: a_link_color, active_element, adopted_style_sheets, all, anchors, applets e 67 in più.

Proprietà

Nome	Tipo	Accesso	Descrizione
`default_view`	``	Lettura	Oggetto Window per documento (lazy, cached).
`location`	``	Lettura	Restituisce l’oggetto Location della Window associata, o `None`.
`implementation`	`"DOMImplementation"`	Lettura	Oggetto DOMImplementation per documento (lazy, cached).
`dom_config`	`DOMConfiguration`	Lettura	Oggetto DOMConfiguration per documento (lazy, cached).
`url`	`str`	Lettura	URL del documento (WHATWG `Document.URL`), predefinito `"about:blank"`.
`document_uri`	`str`	Lettura	L’URL del documento come stringa (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	Lettura	URL base risolta per questo documento (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	Lettura	URL del documento di riferimento (WHATWG HTML Standard §document).
`domain`	`str`	Lettura	Componente hostname dell’URL del documento (Standard WHATWG HTML §document).
`last_modified`	`str`	Lettura	Stringa di timestamp dell’ultima modifica (Standard WHATWG HTML §document).
`cookie`	`str`	Lettura/Scrittura	Stub di stringa di cookie in sola lettura — restituisce sempre `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	Lettura	Se il documento è nascosto — sempre `False` in modalità headless.
`visibility_state`	`str`	Lettura	Stato di visibilità del documento — sempre `"visible"` in modalità headless.
`design_mode`	`str`	Lettura/Scrittura	Se il documento è in modalità design (WHATWG HTML §7.6.4).
`dir`	`str`	Lettura/Scrittura	Direzione del testo del documento (WHATWG HTML §3.3.2).
`current_script`	`None`	Lettura	L’elemento script attualmente in esecuzione (WHATWG HTML §8.1.3.4).
`character_set`	`str`	Lettura	Codifica dei caratteri utilizzata durante l’analisi (WHATWG DOM §3.1).
`charset`	`str`	Lettura	Alias per :attr:`character_set` (HTML nome standard).
`input_encoding`	`str`	Lettura	Alias per :attr:`character_set` (nome di compatibilità DOM WHATWG).
`content_type`	`str`	Lettura	Tipo MIME del documento; sempre `"text/html"` per i documenti HTML.
`style_sheets`	`"StyleSheetList"`	Lettura	Elenco dei fogli di stile del documento live.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	Lettura/Scrittura	Elenco di adozione dei fogli di stile costruttibili a livello di documento.
`node_name`	`str`	Lettura	`'#document'`
`document_element`	`Element	None`	Lettura
`document_type`	`DocumentType	None`	Lettura
`compat_mode`	`str`	Lettura/Scrittura	`'BackCompat'` (quirks) oppure `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	Lettura	Stato di caricamento del documento.
`parse_errors`	`list[ParseError]`	Lettura	Errori di parsing dell’ultima operazione di parsing.
`head`	`Element	None`	Lettura
`body`	`Element	None`	Lettura
`forms`	`"HTMLCollection"`	Lettura	Raccolta live di tutti gli elementi `<form>` nel documento.
`images`	`"HTMLCollection"`	Lettura	Raccolta live di tutti gli elementi `<img>` nel documento.
`links`	`"HTMLCollection"`	Lettura	Raccolta live di elementi `<a href>` e `<area href>`.
`scripts`	`"HTMLCollection"`	Lettura	Raccolta live di tutti gli elementi `<script>` nel documento.
`embeds`	`"HTMLCollection"`	Lettura	Raccolta in tempo reale di tutti i discendenti di `<embed>`.
`applets`	`"HTMLCollection"`	Lettura	Raccolta in tempo reale di tutti i discendenti di `<applet>`.
`anchors`	`"HTMLCollection"`	Lettura	Raccolta live di elementi `<a name=...>` (ancore con nome legacy).
`title`	`str`	Lettura/Scrittura	Il contenuto testuale del primo elemento `<title>` in `<head>`.
`compatible_mode`	`str`	Lettura	Indicatore della modalità quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	Lettura/Scrittura	Sempre `True` in modalità headless (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	Lettura
`last_element_child`	`“Element	None”`	Lettura
`child_element_count`	`int`	Lettura	Numero di figli diretti che sono nodi Element.
`active_element`	`“Element	None”`	Lettura
`full_screen_enabled`	`bool`	Lettura	Sempre `False` — nessuna visualizzazione in modalità headless (Fullscreen API §7).
`fullscreen_element`	`None`	Lettura	Sempre `None` — nessun elemento fullscreen in modalità headless (Fullscreen API §7).
`pointer_lock_element`	`None`	Lettura	Sempre `None` — nessun pointer lock in modalità headless (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	Lettura	Bozza di timeline del documento; `current_time` è sempre `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	Lettura	Tutti gli elementi in ordine ad albero (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	Lettura	Alias per :attr:`embeds` secondo WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	Lettura	Elementi figlio diretti del documento (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	Lettura	Stringa di origine opaca — sempre `'null'` in modalità headless (WHATWG DOM §4.5).
`fg_color`	`str`	Lettura/Scrittura	Riflette l’attributo a livello di documento `fgColor` obsoleto tramite l’attributo `<body>` `text`.
`bg_color`	`str`	Lettura/Scrittura	Riflette l’attributo a livello di documento obsoleto `bgColor` tramite l’attributo `<body>` `bgcolor`.
`link_color`	`str`	Lettura/Scrittura	Riflette l’attributo a livello di documento obsoleto `linkColor` tramite l’attributo `<body>` `link`.
`v_link_color`	`str`	Lettura/Scrittura	Riflette l’attributo a livello di documento obsoleto `vlinkColor` tramite l’attributo `<body>` `vlink`.
`a_link_color`	`str`	Lettura/Scrittura	Riflette l’attributo a livello di documento `alinkColor` obsoleto tramite l’attributo `<body>` `alink`.
`fonts`	``	Lettura	Sempre `None` in modalità headless.
`picture_in_picture_enabled`	`bool`	Lettura	Sempre `False` in modalità headless.
`picture_in_picture_element`	``	Lettura	Sempre `None` in modalità headless.
`prerendering`	`bool`	Lettura	Sempre `False` in modalità headless.
`node_type`	`int`	Lettura	Costante di tipo nodo intero da `NodeType`.
`node_value`	`str	None`	Lettura/Scrittura
`text_content`	`str	None`	Lettura/Scrittura
`parent_node`	`Node	None`	Lettura
`parent_element`	`Element	None`	Lettura
`is_connected`	`bool`	Lettura	Indica se questo nodo fa parte dell’albero dei nodi di un documento (WHATWG DOM §4.4).
`owner_document`	`Document	None`	Lettura
`child_nodes`	`NodeList`	Lettura	Una NodeList live di tutti i nodi figli.
`first_child`	`Node	None`	Lettura
`last_child`	`Node	None`	Lettura
`previous_sibling`	`Node	None`	Lettura
`next_sibling`	`Node	None`	Lettura

Metodi

Firma	Descrizione
`__init__()`	Calls init su questa istanza di Document.
`normalize_document()`	Normalizza questo documento usando le semantiche esistenti di `Node.normalize`.
`has_focus()` → `bool`	Restituisci se il documento ha il focus — sempre `False` in modalità headless.
`open(type: str, replace: str)` → `"Document"`	Apri il documento per scrittura (WHATWG HTML §7.7).
`close()`	Chiudi il documento dopo la scrittura (WHATWG HTML §7.7).
`write()`	Scrivi una stringa nello stream del documento (WHATWG HTML §7.7).
`writeln()`	Scrivi una stringa seguita da una nuova riga (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	Allega un foglio di stile a questo documento.
`detach_style_sheet(sheet: "CSSStyleSheet")`	Scollega un foglio di stile precedentemente allegato.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	Crea un HTMLElement appartenente a questo documento.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	Crea un Element in uno spazio dei nomi specifico, appartenente a questo documento.
`create_text_node(data: str)` → `Text`	Crea un nodo Text con i dati di carattere forniti.
`create_comment(data: str)` → `Comment`	Crea un nodo Comment con i dati di carattere forniti.
`create_cdata_section(data: str)` → `"CDATASection"`	Crea un nodo CDATASection di proprietà di questo documento.
`create_document_fragment()` → `DocumentFragment`	Crea un DocumentFragment vuoto di proprietà di questo documento.
`create_event(interface: str)` → `"Event"`	Crea un oggetto evento legacy per interface.
`create_range()` → `"Range"`	Crea un nuovo Range ridotto in questo documento.
`get_selection()` → `"Selection"`	Restituisci l’oggetto di selezione singleton di questo documento.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	Crea un nodo ProcessingInstruction di proprietà di questo documento.
`create_attribute(local_name: str)` → `"Attr"`	Crea un `Attr` non-namespaced di proprietà di questo documento.
`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 questo documento, spostandolo dal suo albero corrente.
`import_node(node: Node, deep: bool)` → `Node`	Restituisci un clone di node di proprietà di questo documento.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	Restituisci tutti gli elementi discendenti con il nome di tag specificato.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	Restituisci tutti gli elementi discendenti con tutti i nomi di classe specificati.
`filter_fn(el: Element)` → `bool`	Chiama filter_fn(el) su questa istanza di Document.
`get_elements_by_name(name: str)` → `NodeList`	Restituisce tutti gli elementi discendenti il cui `name` l’attributo è uguale a name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes prima del primo figlio di questo documento.
`append()`	Append nodes come gli ultimi figli di questo documento.
`replace_children()`	Rimuovi tutti i figli di questo documento, quindi aggiungi nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Restituisci un NodeList statico di tutti gli elementi che corrispondono al selettore CSS.
`get_animations()` → `list[object]`	Restituisci le animazioni a livello di documento (stub headless: sempre `[]`).
`element_from_point(x: float, y: float)`	Sempre `None` — headless non ha un motore di layout per il hit testing (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	Sempre `[]` — headless non ha un motore di layout per il hit testing (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	Sempre `False` — comando di modifica legacy; nessuna pipeline in modalità headless (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	Sempre `False` — nessun pipeline di editing in headless (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	Sempre `True` — l’origine headless è trattata come stessa origine (Storage Access API).
`request_storage_access()`	Stub no-op — headless ha sempre accesso allo storage; non è necessario alcun grant asincrono (Storage Access API).
`get_root_node(composed: bool)` → `"Node"`	Restituisci la radice dell’albero del nodo.
`has_child_nodes()` → `bool`	Restituisci se questo nodo ha almeno un nodo figlio diretto.
`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 come ultimo figlio di questo nodo.
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node dalla lista dei figli e restituirlo.
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	Restituisci una copia di questo nodo.
`normalize()`	Inserisci questo nodo e l’intero sottoalbero in forma normalizzata.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Restituisce una maschera di bit che descrive la posizione di other relativo a questo nodo.
`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 per eventi di type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	Annulla la registrazione di un listener precedentemente registrato.
`dispatch_event(event: "Event")` → `bool`	Dispatch event attraverso l’albero degli antenati.

Vedi anche

Aspose.HTML for Python — Enterprise API Reference