Element

Visão geral

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

Um nó de elemento HTML ou XML.

Esta classe fornece 72 métodos para trabalhar com objetos Element em programas Python. Métodos disponíveis incluem: __init__, add_event_listener, after, append, append_child, attach_shadow, before, check_visibility, clone_node, closest, compare_document_position, contains e 60 métodos adicionais. Todos os membros públicos estão acessíveis a qualquer aplicação Python após a instalação do pacote Aspose.Html FOSS para Python. Propriedades: assigned_slot, attributes, child_element_count, child_nodes, children, class_list e mais 43.

Propriedades

Nome	Tipo	Acesso	Descrição
`node_name`	`str`	Leitura	O nome da tag qualificada (maiúsculas para elementos HTML).
`tag_name`	`str`	Leitura	O nome da tag qualificada em maiúsculas (elementos HTML).
`local_name`	`str`	Leitura	A parte local do nome qualificado (em minúsculas).
`namespace_uri`	`str	None`	Leitura
`style_sheets`	`"StyleSheetList"`	Leitura	Lista de folhas de estilo ao vivo aplicável ao documento deste elemento.
`prefix`	`str	None`	Leitura
`id`	`str`	Leitura	O valor do atributo `id`, ou `''` se não estiver presente.
`class_name`	`str`	Leitura	O valor do atributo `class`, ou `''`.
`class_list`	`"DOMTokenList"`	Leitura	Conjunto mutável ao vivo de tokens de classe CSS suportado pelo atributo `class`.
`dataset`	`"DOMStringMap"`	Leitura	Visão ao vivo semelhante a dicionário dos atributos personalizados `data-*` do elemento.
`attributes`	`NamedNodeMap`	Leitura	O mapa ordenado de objetos Attr para este elemento.
`children`	`HTMLCollection`	Leitura	Uma HTMLCollection ao vivo contendo apenas filhos do tipo Element.
`first_element_child`	`Element	None`	Leitura
`last_element_child`	`Element	None`	Leitura
`next_element_sibling`	`Element	None`	Leitura
`previous_element_sibling`	`Element	None`	Leitura
`child_element_count`	`int`	Leitura	O número de filhos do Element.
`inner_html`	`str`	Leitura/Escrita	O conteúdo HTML serializado de todos os filhos (innerHTML).
`outer_html`	`str`	Leitura/Escrita	O HTML serializado deste elemento e de todos os seus descendentes (outerHTML).
`text_content`	`str	None`	Leitura/Escrita
`style`	`"CSSStyleDeclaration"`	Leitura	O estilo inline deste elemento como um CSSStyleDeclaration ao vivo.
`scroll_width`	`int`	Leitura	Largura de rolagem do conteúdo em CSS pixels (esboço: 0).
`scroll_height`	`int`	Leitura	Altura de rolagem do conteúdo em CSS pixels (stub: 0).
`client_width`	`int`	Leitura	Largura interna incluindo padding, excluindo borda (stub: 0).
`client_height`	`int`	Leitura	Altura interna incluindo preenchimento, excluindo a borda (stub: 0).
`scroll_top`	`int`	Leitura/Escrita	Deslocamento vertical de rolagem em CSS pixels (stub: 0).
`scroll_left`	`int`	Leitura/Escrita	Deslocamento horizontal de rolagem em CSS pixels (stub: 0).
`offset_width`	`int`	Leitura	Largura do layout border-box em CSS pixels (stub: 0).
`offset_height`	`int`	Leitura	Altura do layout border-box em CSS pixels (stub: 0).
`offset_top`	`int`	Leitura	Deslocamento superior a partir de `offsetParent` em CSS pixels (stub: 0).
`offset_left`	`int`	Leitura	Deslocamento à esquerda de `offsetParent` em CSS pixels (stub: 0).
`offset_parent`	`None`	Leitura	O elemento pai de deslocamento; sempre `None` no modo headless.
`client_top`	`int`	Leitura	Largura da borda superior CSS em pixels; sempre `0` no modo headless.
`client_left`	`int`	Leitura	Largura da borda esquerda do CSS em pixels; sempre `0` no modo headless.
`part`	`"DOMTokenList"`	Leitura	DOMTokenList ao vivo que reflete o atributo `part` do elemento.
`shadow_root`	``	Leitura	Sempre `None` no modo headless.
`slot`	`str`	Leitura/Escrita	Reflete o atributo de conteúdo `slot` (DOM §4.2.3).
`assigned_slot`	``	Leitura	Sempre `None` no modo headless.
`node_type`	`int`	Leitura	Constante inteira de tipo de nó de `NodeType`.
`node_value`	`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(local_name: str, namespace_uri: str	None, prefix: str
`get_computed_style()` → `"ComputedStyleDeclaration"`	Retorne declarações phase-2 cascade-resolved para este elemento.
`insert_adjacent_html(position: str, html: str)`	Insira a marcação HTML analisada relativa a este elemento.
`insert_adjacent_text(position: str, text: str)`	Insira um nó de texto relativo a este elemento.
`insert_adjacent_element(position: str, element: “Element	None”)`→`“Element
`get_attribute(name: str)` → `str	None`
`set_attribute(name: str, value: str)`	Definir atributo name to value, criando-o se não estiver presente.
`remove_attribute(name: str)`	Remover atributo name.
`has_attribute(name: str)` → `bool`	Return `True` se atributo name existe neste elemento.
`get_attribute_node(name: str)` → `“Attr	None”`
`set_attribute_node(attr: "Attr")` → `“Attr	None”`
`remove_attribute_node(attr: "Attr")` → `"Attr"`	Remove attr do conjunto de atributos deste elemento e retorná-lo.
`get_attribute_node_ns(namespace_uri: str	None, local_name: str)`→`“Attr
`set_attribute_node_ns(attr: "Attr")` → `“Attr	None”`
`remove_attribute_node_ns(namespace_uri: str	None, local_name: str)`→`“Attr”`
`get_attribute_ns(namespace_uri: str	None, local_name: str)`→`str
`set_attribute_ns(namespace_uri: str	None, qualified_name: str, value: str)`
`has_attribute_ns(namespace_uri: str	None, local_name: str)`→`bool`
`remove_attribute_ns(namespace_uri: str	None, local_name: str)`
`toggle_attribute(name: str, force: bool	None)`→`bool`
`get_attribute_names()` → `list[str]`	Retorne os nomes qualificados de todos os atributos na ordem de coleta.
`has_attributes()` → `bool`	Retorne `True` quando este elemento possui um ou mais atributos.
`scroll_into_view(arg: bool	dict
`scroll(x_or_options: float	dict
`scroll_into_view_if_needed(center_if_needed: bool)`	Role este elemento para dentro da visualização se ainda não estiver visível (no-op em modo headless).
`set_pointer_capture(pointer_id: int)`	Designar este elemento como o alvo de captura para o ponteiro fornecido (no-op).
`release_pointer_capture(pointer_id: int)`	Liberar a captura do ponteiro para o id de ponteiro fornecido (no-op).
`has_pointer_capture(pointer_id: int)` → `bool`	Retornar se este elemento tem captura de ponteiro para o id fornecido.
`request_pointer_lock()`	Solicitar que o ponteiro seja bloqueado neste elemento (no-op).
`request_fullscreen(options: “dict	None”)`
`check_visibility(options: “dict	None”)`→`bool`
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Retorne um NodeList estático de todos os elementos que correspondam selector.
`matches(selector: str)` → `bool`	Return `True` se este elemento corresponde ao CSS selector.
`webkit_matches_selector(selector: str)` → `bool`	Alias de compatibilidade de navegador para :meth:`matches`.
`closest(selector: str)` → `“Element	None”`
`get_elements_by_tag_name(qualified_name: str)` → `HTMLCollection`	Retorna todos os elementos descendentes cujo nome da tag corresponde qualified_name.
`get_elements_by_class_name(class_names: str)` → `HTMLCollection`	Retorne todos os elementos descendentes que possuam todos os tokens de classe fornecidos.
`filter_fn(el: "Element")` → `bool`	Chama filter_fn(el) nesta instância de Element.
`remove()`	Remova este elemento do nó pai.
`before()`	Insert nodes imediatamente antes deste elemento em seu nó pai.
`after()`	Insert nodes imediatamente após este elemento no seu pai.
`replace_with()`	Substitua este elemento por nodes no seu pai.
`prepend()`	Insert nodes antes do primeiro filho deste elemento.
`append()`	Append nodes como os últimos filhos deste elemento.
`replace_children()`	Remova todos os filhos, então anexe nodes como novos filhos.
`get_bounding_client_rect()` → `"DOMRect"`	Retorne o retângulo de delimitação do cliente (stub com todos os valores zero).
`get_client_rects()` → `"DOMRectList"`	Retorne a lista de retângulos do cliente (vazia no contexto do servidor).
`get_animations()` → `list[object]`	Retorne as animações ativas para este elemento (stub sem interface: sempre `[]`).
`attach_shadow(init: “dict	None”)`
`get_root_node(composed: bool)` → `"Node"`	Retorna a raiz da árvore do nó.
`has_child_nodes()` → `bool`	Retorna 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 descrevendo 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)`	Cancelar o registro de um ouvinte previamente registrado.
`dispatch_event(event: "Event")` → `bool`	Dispatch event através da árvore ancestral.

Ver também

Aspose.HTML for Python — Enterprise API Reference