Document

Visão geral

Document é uma classe em Aspose.Html FOSS para Python. Herda de: Node.

A raiz de uma árvore DOM.

Esta classe fornece 66 métodos para trabalhar com objetos Document em programas Python. Os métodos disponíveis incluem: __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 métodos adicionais. Todos os membros públicos são acessíveis a qualquer aplicação Python após a instalação do pacote Aspose.Html FOSS para Python. Propriedades: a_link_color, active_element, adopted_style_sheets, all, anchors, applets e mais 67.

Propriedades

Nome	Tipo	Acesso	Descrição
`default_view`	``	Leitura	Objeto Window por documento (preguiçoso, em cache).
`location`	``	Leitura	Retorna o objeto Location da Window associada, ou `None`.
`implementation`	`"DOMImplementation"`	Leitura	Objeto DOMImplementation por documento (preguiçoso, em cache).
`dom_config`	`DOMConfiguration`	Leitura	Objeto DOMConfiguration por documento (preguiçoso, em cache).
`url`	`str`	Leitura	URL do documento (WHATWG `Document.URL`), padrão `"about:blank"`.
`document_uri`	`str`	Leitura	A URL do documento como uma string (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	Leitura	URL base resolvida para este documento (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	Leitura	URL do documento de referência (WHATWG HTML Standard §document).
`domain`	`str`	Leitura	Componente de hostname da URL do documento (WHATWG HTML Standard §document).
`last_modified`	`str`	Leitura	String de carimbo de data/hora da última modificação (WHATWG HTML Standard §document).
`cookie`	`str`	Leitura/Escrita	Stub de string de cookie somente leitura — sempre retorna `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	Leitura	Se o documento está oculto — sempre `False` no modo headless.
`visibility_state`	`str`	Leitura	Estado de visibilidade do documento — sempre `"visible"` no modo headless.
`design_mode`	`str`	Leitura/Escrita	Se o documento está no modo de design (WHATWG HTML §7.6.4).
`dir`	`str`	Leitura/Escrita	Direção do texto do documento (WHATWG HTML §3.3.2).
`current_script`	`None`	Leitura	O elemento de script atualmente em execução (WHATWG HTML §8.1.3.4).
`character_set`	`str`	Leitura	Codificação de caracteres usada durante a análise (WHATWG DOM §3.1).
`charset`	`str`	Leitura	Alias para :attr:`character_set` (nome padrão HTML).
`input_encoding`	`str`	Leitura	Alias para :attr:`character_set` (nome de compatibilidade DOM WHATWG).
`content_type`	`str`	Leitura	Tipo MIME do documento; sempre `"text/html"` para documentos HTML.
`style_sheets`	`"StyleSheetList"`	Leitura	Lista de folhas de estilo ao vivo do documento.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	Leitura/Escrita	Lista de adoção de folhas de estilo construíveis ao nível do documento.
`node_name`	`str`	Leitura	`'#document'`
`document_element`	`Element	None`	Leitura
`document_type`	`DocumentType	None`	Leitura
`compat_mode`	`str`	Leitura/Escrita	`'BackCompat'` (quirks) ou `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	Leitura	Estado de carregamento do documento.
`parse_errors`	`list[ParseError]`	Leitura	Erros de análise da última operação de análise.
`head`	`Element	None`	Leitura
`body`	`Element	None`	Leitura
`forms`	`"HTMLCollection"`	Leitura	Coleção ao vivo de todos os elementos `<form>` no documento.
`images`	`"HTMLCollection"`	Leitura	Coleção ao vivo de todos os elementos `<img>` no documento.
`links`	`"HTMLCollection"`	Leitura	Coleção ao vivo de elementos `<a href>` e `<area href>`.
`scripts`	`"HTMLCollection"`	Leitura	Coleção ao vivo de todos os elementos `<script>` no documento.
`embeds`	`"HTMLCollection"`	Leitura	Coleção ao vivo de todos os descendentes de `<embed>`.
`applets`	`"HTMLCollection"`	Leitura	Coleção ao vivo de todos os descendentes de `<applet>`.
`anchors`	`"HTMLCollection"`	Leitura	Coleção ao vivo de elementos `<a name=...>` (âncoras nomeadas legadas).
`title`	`str`	Leitura/Escrita	O conteúdo de texto do primeiro elemento `<title>` em `<head>`.
`compatible_mode`	`str`	Leitura	Indicador de modo quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	Leitura/Escrita	Sempre `True` no modo headless (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	Leitura
`last_element_child`	`“Element	None”`	Leitura
`child_element_count`	`int`	Leitura	Número de filhos diretos que são nós Element.
`active_element`	`“Element	None”`	Leitura
`full_screen_enabled`	`bool`	Leitura	Sempre `False` — sem exibição no modo headless (Fullscreen API §7).
`fullscreen_element`	`None`	Leitura	Sempre `None` — sem elemento fullscreen no modo headless (Fullscreen API §7).
`pointer_lock_element`	`None`	Leitura	Sempre `None` — sem bloqueio de ponteiro no modo headless (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	Leitura	Stub da linha do tempo do documento; `current_time` é sempre `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	Leitura	Todos os elementos em ordem de árvore (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	Leitura	Alias para :attr:`embeds` conforme WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	Leitura	Filhos diretos de elementos do documento (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	Leitura	String de origem opaca — sempre `'null'` no modo headless (WHATWG DOM §4.5).
`fg_color`	`str`	Leitura/Escrita	Reflete o obsoleto atributo de nível de documento `fgColor` via atributo `<body>` `text`.
`bg_color`	`str`	Leitura/Escrita	Reflete o atributo de nível de documento `bgColor` obsoleto via o atributo `<body>` `bgcolor`.
`link_color`	`str`	Leitura/Escrita	Reflete o atributo de nível de documento `linkColor` obsoleto via o atributo `<body>` `link`.
`v_link_color`	`str`	Leitura/Escrita	Reflete o atributo de nível de documento `vlinkColor` obsoleto via o atributo `<body>` `vlink`.
`a_link_color`	`str`	Leitura/Escrita	Reflete o atributo obsoleto `alinkColor` a nível de documento via atributo `<body>` `alink`.
`fonts`	``	Leitura	Sempre `None` no modo sem interface.
`picture_in_picture_enabled`	`bool`	Leitura	Sempre `False` no modo sem interface.
`picture_in_picture_element`	``	Leitura	Sempre `None` no modo headless.
`prerendering`	`bool`	Leitura	Sempre `False` no modo headless.
`node_type`	`int`	Leitura	Constante de tipo de nó inteiro de `NodeType`.
`node_value`	`str	None`	Leitura/Escrita
`text_content`	`str	None`	Leitura/Escrita
`parent_node`	`Node	None`	Leitura
`parent_element`	`Element	None`	Leitura
`is_connected`	`bool`	Leitura	Se este nó faz parte da árvore de nós de um documento (WHATWG DOM §4.4).
`owner_document`	`Document	None`	Leitura
`child_nodes`	`NodeList`	Leitura	Um NodeList ao vivo de todos os nós filhos.
`first_child`	`Node	None`	Leitura
`last_child`	`Node	None`	Leitura
`previous_sibling`	`Node	None`	Leitura
`next_sibling`	`Node	None`	Leitura

Métodos

Assinatura	Descrição
`__init__()`	Calls init nesta instância de Document.
`normalize_document()`	Normalize este documento usando a semântica existente de `Node.normalize`.
`has_focus()` → `bool`	Retorne se o documento tem foco — sempre `False` no modo headless.
`open(type: str, replace: str)` → `"Document"`	Abra o documento para escrita (WHATWG HTML §7.7).
`close()`	Feche o documento após a escrita (WHATWG HTML §7.7).
`write()`	Escreva uma string no fluxo do documento (WHATWG HTML §7.7).
`writeln()`	Escreva uma string seguida por uma nova linha (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	Anexe uma folha de estilos a este documento.
`detach_style_sheet(sheet: "CSSStyleSheet")`	Desanexar uma folha de estilo previamente anexada.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	Criar um HTMLElement pertencente a este documento.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	Criar um Element em um namespace específico, pertencente a este documento.
`create_text_node(data: str)` → `Text`	Crie um nó de Texto com os dados de caracteres fornecidos.
`create_comment(data: str)` → `Comment`	Crie um nó de Comentário com os dados de caracteres fornecidos.
`create_cdata_section(data: str)` → `"CDATASection"`	Crie um nó CDATASection pertencente a este documento.
`create_document_fragment()` → `DocumentFragment`	Crie um DocumentFragment vazio pertencente a este documento.
`create_event(interface: str)` → `"Event"`	Criar um objeto de evento legado para interface.
`create_range()` → `"Range"`	Crie um novo Range colapsado neste documento.
`get_selection()` → `"Selection"`	Retorne o objeto de seleção singleton deste documento.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	Crie um nó ProcessingInstruction pertencente a este documento.
`create_attribute(local_name: str)` → `"Attr"`	Crie um `Attr` sem namespace pertencente a este 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 para dentro deste documento, movendo-o da sua árvore atual.
`import_node(node: Node, deep: bool)` → `Node`	Retorne um clone de node pertencente a este documento.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	Retorne todos os elementos descendentes com o nome de tag fornecido.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	Retorne todos os elementos descendentes com todos os nomes de classe fornecidos.
`filter_fn(el: Element)` → `bool`	Chama filter_fn(el) nesta instância de Document.
`get_elements_by_name(name: str)` → `NodeList`	Retorne todos os elementos descendentes cujo `name` atributo igual a name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes antes do primeiro filho deste documento.
`append()`	Append nodes como os últimos filhos deste documento.
`replace_children()`	Remova todos os filhos deste documento, então anexe nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Retorne um NodeList estático de todos os elementos que correspondem ao seletor CSS.
`get_animations()` → `list[object]`	Retorne animações de nível de documento (headless stub: sempre `[]`).
`element_from_point(x: float, y: float)`	Sempre `None` — headless não tem engine de layout para hit testing (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	Sempre `[]` — headless não tem engine de layout para hit testing (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	Sempre `False` — comando de edição legado; nenhum pipeline em headless (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	Sempre `False` — sem pipeline de edição em headless (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	Sempre `True` — a origem headless é tratada como mesma origem (Storage Access API).
`request_storage_access()`	Stub no-op — headless sempre tem acesso a storage; nenhum grant assíncrono é necessário (Storage Access API).
`get_root_node(composed: bool)` → `"Node"`	Retorne a raiz da árvore do nó.
`has_child_nodes()` → `bool`	Retorne se este nó tem ao menos um nó filho direto.
`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 como o último filho deste nó.
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node da lista de filhos e retorne-o.
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	Retorne uma cópia deste nó.
`normalize()`	Coloque este nó e toda a sua subárvore em forma normalizada.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Retorne uma máscara de bits que descreve a posição de other relativo a este nó.
`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 para eventos de type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	Desregistrar um listener previamente registrado.
`dispatch_event(event: "Event")` → `bool`	Dispatch event através da árvore de ancestrais.

Ver também

Aspose.HTML for Python — Enterprise API Reference