Document

Przegląd

Document jest klasą w Aspose.Html FOSS dla Python. Dziedziczy po: Node.

Korzeń drzewa DOM.

Ta klasa udostępnia 66 metod do pracy z obiektami Document w programach Python. Dostępne metody to: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns oraz 54 dodatkowe metody. Wszystkie publiczne elementy są dostępne dla każdej aplikacji Python po zainstalowaniu pakietu Aspose.Html FOSS dla Python. Właściwości: a_link_color, active_element, adopted_style_sheets, all, anchors, applets oraz 67 kolejnych.

Właściwości

Nazwa	Typ	Dostęp	Opis
`default_view`	``	Odczyt	Obiekt Window per dokument (leniwy, buforowany).
`location`	``	Odczyt	Zwróć powiązany obiekt Location okna, lub `None`.
`implementation`	`"DOMImplementation"`	Odczyt	Obiekt DOMImplementation per dokument (leniwy, buforowany).
`dom_config`	`DOMConfiguration`	Odczyt	Obiekt DOMConfiguration per-dokumentu (leniwy, buforowany).
`url`	`str`	Odczyt	Adres URL dokumentu (WHATWG `Document.URL`), domyślnie `"about:blank"`.
`document_uri`	`str`	Odczyt	Adres URL dokumentu jako ciąg znaków (WHATWG DOM §4.5 `documentURI`).
`base_uri`	`str`	Odczyt	Rozwiązany podstawowy URL dla tego dokumentu (WHATWG DOM `Node.baseURI`).
`referrer`	`str`	Odczyt	URL odwołującego się dokumentu (WHATWG HTML Standard §document).
`domain`	`str`	Odczyt	Składnik nazwy hosta w adresie URL dokumentu (WHATWG HTML Standard §document).
`last_modified`	`str`	Odczyt	Ciąg znacznika czasu ostatniej modyfikacji (WHATWG HTML Standard §document).
`cookie`	`str`	Odczyt/zapis	Szablon łańcucha ciasteczka tylko do odczytu — zawsze zwraca `""` (WHATWG HTML §8.11.1).
`hidden`	`bool`	Odczyt	Czy dokument jest ukryty — zawsze `False` w trybie headless.
`visibility_state`	`str`	Odczyt	Stan widoczności dokumentu — zawsze `"visible"` w trybie headless.
`design_mode`	`str`	Odczyt/zapis	Czy dokument jest w trybie projektowania (WHATWG HTML §7.6.4).
`dir`	`str`	Odczyt/zapis	Kierunek tekstu dokumentu (WHATWG HTML §3.3.2).
`current_script`	`None`	Odczyt	Aktualnie wykonywany element skryptu (WHATWG HTML §8.1.3.4).
`character_set`	`str`	Odczyt	Kodowanie znaków używane podczas parsowania (WHATWG DOM §3.1).
`charset`	`str`	Odczyt	Alias dla :attr:`character_set` (HTML standardowa nazwa).
`input_encoding`	`str`	Odczyt	Alias dla :attr:`character_set` (nazwa zgodności WHATWG DOM).
`content_type`	`str`	Odczyt	Typ MIME dokumentu; zawsze `"text/html"` dla dokumentów HTML.
`style_sheets`	`"StyleSheetList"`	Odczyt	Lista arkuszy stylów dokumentu na żywo.
`adopted_style_sheets`	`list["CSSStyleSheet"]`	Odczyt/zapis	Lista przyjmowania konstrukcyjnych arkuszy stylów na poziomie dokumentu.
`node_name`	`str`	Odczyt	`'#document'`
`document_element`	`Element	None`	Odczyt
`document_type`	`DocumentType	None`	Odczyt
`compat_mode`	`str`	Odczyt/zapis	`'BackCompat'` (quirks) lub `'CSS1Compat'` (no-quirks).
`ready_state`	`str`	Odczyt	Stan ładowania dokumentu.
`parse_errors`	`list[ParseError]`	Odczyt	Błędy parsowania z ostatniej operacji parsowania.
`head`	`Element	None`	Odczyt
`body`	`Element	None`	Odczyt
`forms`	`"HTMLCollection"`	Odczyt	Dynamiczna kolekcja wszystkich elementów `<form>` w dokumencie.
`images`	`"HTMLCollection"`	Odczyt	Dynamiczna kolekcja wszystkich elementów `<img>` w dokumencie.
`links`	`"HTMLCollection"`	Odczyt	Dynamiczna kolekcja elementów `<a href>` i `<area href>`.
`scripts`	`"HTMLCollection"`	Odczyt	Żywa kolekcja wszystkich elementów `<script>` w dokumencie.
`embeds`	`"HTMLCollection"`	Odczyt	Aktualna kolekcja wszystkich `<embed>` potomków.
`applets`	`"HTMLCollection"`	Odczyt	Aktualna kolekcja wszystkich `<applet>` potomków.
`anchors`	`"HTMLCollection"`	Odczyt	Żywa kolekcja elementów `<a name=...>` (starsze nazwane kotwice).
`title`	`str`	Odczyt/zapis	Zawartość tekstowa pierwszego elementu `<title>` w `<head>`.
`compatible_mode`	`str`	Odczyt	Wskaźnik trybu quirks (WHATWG HTML §3.2.1).
`strict_error_checking`	`bool`	Odczyt/zapis	Zawsze `True` w trybie bezgłowym (DOM3 Core §1.1.1).
`first_element_child`	`“Element	None”`	Odczyt
`last_element_child`	`“Element	None”`	Odczyt
`child_element_count`	`int`	Odczyt	Liczba bezpośrednich dzieci będących węzłami Element.
`active_element`	`“Element	None”`	Odczyt
`full_screen_enabled`	`bool`	Odczyt	Zawsze `False` — brak wyświetlacza w trybie headless (Fullscreen API §7).
`fullscreen_element`	`None`	Odczyt	Zawsze `None` — brak elementu fullscreen w trybie headless (Fullscreen API §7).
`pointer_lock_element`	`None`	Odczyt	Zawsze `None` — brak blokady wskaźnika w trybie headless (Pointer Lock API §4).
`timeline`	`"_DocumentTimeline"`	Odczyt	Stub linii czasu dokumentu; `current_time` jest zawsze `0.0` (Web Animations API §6.2).
`all`	`"_AllCollection"`	Odczyt	Wszystkie elementy w kolejności drzewa (WHATWG HTML §legacy document layout interface).
`plugins`	`"HTMLCollection"`	Odczyt	Alias dla :attr:`embeds` zgodnie z WHATWG HTML §4.1 legacy interface.
`children`	`"HTMLCollection"`	Odczyt	Bezpośrednie elementy potomne dokumentu (WHATWG DOM §4.2.6 ParentNode).
`origin`	`str`	Odczyt	Nieprzezroczysty ciąg origin — zawsze `'null'` w trybie headless (WHATWG DOM §4.5).
`fg_color`	`str`	Odczyt/zapis	Odbija przestarzały atrybut dokumentu `fgColor` przy użyciu atrybutu `<body>` `text`.
`bg_color`	`str`	Odczyt/zapis	Odzwierciedla przestarzały atrybut dokumentu `bgColor` poprzez atrybut `<body>` `bgcolor`.
`link_color`	`str`	Odczyt/zapis	Odzwierciedla przestarzały atrybut dokumentu `linkColor` poprzez atrybut `<body>` `link`.
`v_link_color`	`str`	Odczyt/zapis	Odzwierciedla przestarzały atrybut dokumentu `vlinkColor` poprzez atrybut `<body>` `vlink`.
`a_link_color`	`str`	Odczyt/zapis	Odbija przestarzały atrybut dokumentu `alinkColor` za pomocą atrybutu `<body>` `alink`.
`fonts`	``	Odczyt	Zawsze `None` w trybie headless.
`picture_in_picture_enabled`	`bool`	Odczyt	Zawsze `False` w trybie headless.
`picture_in_picture_element`	``	Odczyt	Zawsze `None` w trybie bezgłowym.
`prerendering`	`bool`	Odczyt	Zawsze `False` w trybie bezgłowym.
`node_type`	`int`	Odczyt	Stała typu węzła całkowitego z `NodeType`.
`node_value`	`str	None`	Odczyt/zapis
`text_content`	`str	None`	Odczyt/zapis
`parent_node`	`Node	None`	Odczyt
`parent_element`	`Element	None`	Odczyt
`is_connected`	`bool`	Odczyt	Czy ten węzeł jest częścią drzewa węzłów dokumentu (WHATWG DOM §4.4).
`owner_document`	`Document	None`	Odczyt
`child_nodes`	`NodeList`	Odczyt	Żywy NodeList wszystkich węzłów potomnych.
`first_child`	`Node	None`	Odczyt
`last_child`	`Node	None`	Odczyt
`previous_sibling`	`Node	None`	Odczyt
`next_sibling`	`Node	None`	Odczyt

Metody

Sygnatura	Opis
`__init__()`	Calls init na tej instancji Document.
`normalize_document()`	Znormalizuj ten dokument przy użyciu istniejących semantyk `Node.normalize`.
`has_focus()` → `bool`	Zwróć, czy dokument ma fokus — zawsze `False` w trybie bezgłowym.
`open(type: str, replace: str)` → `"Document"`	Otwórz dokument do zapisu (WHATWG HTML §7.7).
`close()`	Zamknij dokument po zapisaniu (WHATWG HTML §7.7).
`write()`	Zapisz ciąg znaków do strumienia dokumentu (WHATWG HTML §7.7).
`writeln()`	Zapisz ciąg znaków, po którym następuje znak nowej linii (WHATWG HTML §7.7).
`attach_style_sheet(sheet: "CSSStyleSheet")`	Dołącz arkusz stylów do tego dokumentu.
`detach_style_sheet(sheet: "CSSStyleSheet")`	Odłącz wcześniej dołączony arkusz stylów.
`save(path: “str	pathlib.Path”, encoding: str)`
`create_element(tag_name: str)` → `"HTMLElement"`	Utwórz HTMLElement należący do tego dokumentu.
`create_element_ns(namespace_uri: str, qualified_name: str)` → `Element`	Utwórz Element w określonej przestrzeni nazw, należący do tego dokumentu.
`create_text_node(data: str)` → `Text`	Utwórz węzeł Text z podanymi danymi znakowymi.
`create_comment(data: str)` → `Comment`	Utwórz węzeł Comment z podanymi danymi znakowymi.
`create_cdata_section(data: str)` → `"CDATASection"`	Utwórz węzeł CDATASection należący do tego dokumentu.
`create_document_fragment()` → `DocumentFragment`	Utwórz pusty DocumentFragment należący do tego dokumentu.
`create_event(interface: str)` → `"Event"`	Utwórz obiekt zdarzenia legacy dla interface.
`create_range()` → `"Range"`	Utwórz nowy zakres zwinięty w tym dokumencie.
`get_selection()` → `"Selection"`	Zwróć jedyny obiekt zaznaczenia tego dokumentu.
`create_processing_instruction(target: str, data: str)` → `"ProcessingInstruction"`	Utwórz węzeł ProcessingInstruction należący do tego dokumentu.
`create_attribute(local_name: str)` → `"Attr"`	Utwórz nieprzestrzenny `Attr` należący do tego dokumentu.
`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 do tego dokumentu, przenosząc go z bieżącego drzewa.
`import_node(node: Node, deep: bool)` → `Node`	Zwróć klon node należący do tego dokumentu.
`get_element_by_id(id: str)` → `Element	None`
`get_elements_by_tag_name(name: str)` → `HTMLCollection`	Zwróć wszystkie elementy potomne o podanej nazwie znacznika.
`get_elements_by_class_name(names: str)` → `HTMLCollection`	Zwróć wszystkie elementy potomne posiadające wszystkie podane nazwy klas.
`filter_fn(el: Element)` → `bool`	Wywołuje filter_fn(el) na tej instancji Document.
`get_elements_by_name(name: str)` → `NodeList`	Zwróć wszystkie elementy potomne, których `name` atrybut jest równy name.
`get_elements_by_tag_name_ns(namespace: “str	None”, local_name: str)`→`list`
`prepend()`	Insert nodes przed pierwszym dzieckiem tego dokumentu.
`append()`	Append nodes jako ostatnie dzieci tego dokumentu.
`replace_children()`	Usuń wszystkie dzieci tego dokumentu, a następnie dołącz nodes.
`query_selector(selector: str)` → `Element	None`
`query_selector_all(selector: str)` → `NodeList`	Zwróć statyczny NodeList wszystkich elementów pasujących do selektora CSS.
`get_animations()` → `list[object]`	Zwróć animacje na poziomie dokumentu (szkielet headless: zawsze `[]`).
`element_from_point(x: float, y: float)`	Zawsze `None` — headless nie ma silnika układu do testowania trafień (CSSOM View §11.6).
`elements_from_point(x: float, y: float)` → `list`	Zawsze `[]` — headless nie ma silnika układu do testowania trafień (CSSOM View §11.6).
`exec_command(command_id: str, show_ui: bool, value: str)` → `bool`	Zawsze `False` — starsze polecenie edycji; brak potoku w trybie bezgłowym (WHATWG HTML §8.6.1).
`query_command_enabled(command_id: str)` → `bool`	Zawsze `False` — brak pipeline edycji w trybie headless (WHATWG HTML §8.6.1).
`has_storage_access()` → `bool`	Zawsze `True` — pochodzenie headless jest traktowane jako to samo pochodzenie (Storage Access API).
`request_storage_access()`	Stub bez operacji — headless zawsze ma dostęp do pamięci; nie jest potrzebne asynchroniczne przyznanie (Storage Access API).
`get_root_node(composed: bool)` → `"Node"`	Zwróć korzeń drzewa węzła.
`has_child_nodes()` → `bool`	Zwróć, czy ten węzeł ma co najmniej jeden bezpośredni węzeł potomny.
`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 jako ostatnie dziecko tego węzła.
`insert_before(node: Node, reference: Node	None)`→`Node`
`remove_child(node: Node)` → `Node`	Remove node z listy dzieci i zwróć go.
`replace_child(new_child: Node, old_child: Node)` → `Node`	Replace old_child with new_child.
`clone_node(deep: bool)` → `Node`	Zwróć kopię tego węzła.
`normalize()`	Umieść ten węzeł i jego cały poddrzewo w formie znormalizowanej.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Zwróć maskę bitową opisującą pozycję other względem tego węzła.
`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 dla zdarzeń type.
`remove_event_listener(type: str, listener: Callable, capture: bool)`	Wyrejestruj wcześniej zarejestrowanego nasłuchiwacza.
`dispatch_event(event: "Event")` → `bool`	Dispatch event przez drzewo przodków.

Zobacz także

Aspose.HTML for Python — Enterprise API Reference