Document
Document
Genel Bakış
Document, Python için Aspose.Html FOSS içinde bir sınıftır. Şuradan miras alır: Node.
Bir DOM ağacının kökü.
Bu sınıf, Python programlarında Document nesneleriyle çalışmak için 66 yöntem sağlar. Kullanılabilir yöntemler şunlardır: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns ve 54 ek yöntem. Tüm ortak üyeler, Aspose.Html FOSS for Python paketini kurduktan sonra herhangi bir Python uygulaması tarafından erişilebilir. Özellikler: a_link_color, active_element, adopted_style_sheets, all, anchors, applets ve 67 tane daha.
Özellikler
| Ad | Tür | Erişim | Açıklama |
|---|---|---|---|
default_view | `` | Okuma | Belge başına Window nesnesi (tembel, önbelleğe alınmış). |
location | `` | Okuma | İlişkili Window’ın Location nesnesini döndür, ya da None. |
implementation | "DOMImplementation" | Okuma | Belge başına DOMImplementation nesnesi (tembel, önbelleğe alınmış). |
dom_config | DOMConfiguration | Okuma | Belge başına DOMConfiguration nesnesi (tembel, önbelleğe alınmış). |
url | str | Okuma | Belge URL’si (WHATWG Document.URL), varsayılan "about:blank". |
document_uri | str | Okuma | Belgenin URL’si bir dize olarak (WHATWG DOM §4.5 documentURI). |
base_uri | str | Okuma | Bu belge için çözümlenmiş temel URL (WHATWG DOM Node.baseURI). |
referrer | str | Okuma | Başvuran belge URL’si (WHATWG HTML Standard §document). |
domain | str | Okuma | Belge URL’sinin ana bilgisayar bileşeni (WHATWG HTML Standard §document). |
last_modified | str | Okuma | Son değiştirilmiş zaman damgası dizesi (WHATWG HTML Standard §document). |
cookie | str | Okuma/Yazma | Yalnızca okunabilir çerez dizesi taslağı — her zaman "" döndürür (WHATWG HTML §8.11.1). |
hidden | bool | Okuma | Belge gizli olup olduğu — başsız modda her zaman False. |
visibility_state | str | Okuma | Belge görünürlük durumu — başsız modda her zaman "visible". |
design_mode | str | Okuma/Yazma | Belge tasarım modunda mı (WHATWG HTML §7.6.4). |
dir | str | Okuma/Yazma | Belge metin yönü (WHATWG HTML §3.3.2). |
current_script | None | Okuma | Şu anda yürütülen script öğesi (WHATWG HTML §8.1.3.4). |
character_set | str | Okuma | Ayrıştırma sırasında kullanılan karakter kodlaması (WHATWG DOM §3.1). |
charset | str | Okuma | Takma adı :attr:character_set (HTML Standard adı). |
input_encoding | str | Okuma | Takma adı :attr:character_set (WHATWG DOM uyumluluk adı). |
content_type | str | Okuma | Belge MIME türü; HTML belgeleri için her zaman "text/html". |
style_sheets | "StyleSheetList" | Okuma | Canlı belge stil sayfası listesi. |
adopted_style_sheets | list["CSSStyleSheet"] | Okuma/Yazma | Belge düzeyinde oluşturulabilir stil sayfası benimseme listesi. |
node_name | str | Okuma | '#document' |
document_element | `Element | None` | Okuma |
document_type | `DocumentType | None` | Okuma |
compat_mode | str | Okuma/Yazma | 'BackCompat' (quirks) veya 'CSS1Compat' (no-quirks). |
ready_state | str | Okuma | Belge yükleme durumu. |
parse_errors | list[ParseError] | Okuma | Son ayrıştırma işleminden gelen ayrıştırma hataları. |
head | `Element | None` | Okuma |
body | `Element | None` | Okuma |
forms | "HTMLCollection" | Okuma | Belgedeki tüm <form> öğelerinin canlı koleksiyonu. |
images | "HTMLCollection" | Okuma | Belgedeki tüm <img> öğelerinin canlı koleksiyonu. |
links | "HTMLCollection" | Okuma | <a href> ve <area href> öğelerinin canlı koleksiyonu. |
scripts | "HTMLCollection" | Okuma | Belgedeki tüm <script> öğelerinin canlı koleksiyonu. |
embeds | "HTMLCollection" | Okuma | Tüm <embed> nesillerinin canlı koleksiyonu. |
applets | "HTMLCollection" | Okuma | Tüm <applet> nesillerinin canlı koleksiyonu. |
anchors | "HTMLCollection" | Okuma | Canlı <a name=...> öğeleri koleksiyonu (eski adlandırılmış bağlar). |
title | str | Okuma/Yazma | İlk <title> öğesinin <head> içindeki metin içeriği. |
compatible_mode | str | Okuma | Quirks-modu göstergesi (WHATWG HTML §3.2.1). |
strict_error_checking | bool | Okuma/Yazma | Her zaman True başsız modda (DOM3 Core §1.1.1). |
first_element_child | `“Element | None”` | Okuma |
last_element_child | `“Element | None”` | Okuma |
child_element_count | int | Okuma | Element düğümleri olan doğrudan çocukların sayısı. |
active_element | `“Element | None”` | Okuma |
full_screen_enabled | bool | Okuma | Her zaman False — başsız modda display yok (Fullscreen API §7). |
fullscreen_element | None | Okuma | Her zaman None — başsız modda fullscreen element yok (Fullscreen API §7). |
pointer_lock_element | None | Okuma | Her zaman None — başsız modda pointer lock yok (Pointer Lock API §4). |
timeline | "_DocumentTimeline" | Okuma | Belge zaman çizelgesi taslağı; current_time her zaman 0.0 olur (Web Animations API §6.2). |
all | "_AllCollection" | Okuma | Ağaç sırasındaki tüm öğeler (WHATWG HTML §legacy document layout interface). |
plugins | "HTMLCollection" | Okuma | WHATWG HTML §4.1 legacy interface’e göre :attr:embeds takma adı. |
children | "HTMLCollection" | Okuma | Belgenin doğrudan element alt öğeleri (WHATWG DOM §4.2.6 ParentNode). |
origin | str | Okuma | Opak kaynak dizesi — başsız modda her zaman 'null' (WHATWG DOM §4.5). |
fg_color | str | Okuma/Yazma | Eski fgColor belge düzeyinde niteliği, <body> text niteliği aracılığıyla yansıtır. |
bg_color | str | Okuma/Yazma | Eski bgColor belge düzeyindeki özniteliği <body> bgcolor özniteliği aracılığıyla yansıtır. |
link_color | str | Okuma/Yazma | Eski linkColor belge düzeyindeki özniteliği <body> link özniteliği aracılığıyla yansıtır. |
v_link_color | str | Okuma/Yazma | Eski vlinkColor belge düzeyindeki özniteliği <body> vlink özniteliği aracılığıyla yansıtır. |
a_link_color | str | Okuma/Yazma | Eski alinkColor belge düzeyindeki özniteliği, <body> alink özniteliği aracılığıyla yansıtır. |
fonts | `` | Okuma | Her zaman None başsız modda. |
picture_in_picture_enabled | bool | Okuma | Her zaman False başsız modda. |
picture_in_picture_element | `` | Okuma | Her zaman None başsız modda. |
prerendering | bool | Okuma | Her zaman False başsız modda. |
node_type | int | Okuma | Tam sayı düğüm türü sabiti NodeType kaynağından. |
node_value | `str | None` | Okuma/Yazma |
text_content | `str | None` | Okuma/Yazma |
parent_node | `Node | None` | Okuma |
parent_element | `Element | None` | Okuma |
is_connected | bool | Okuma | Bu düğümün bir belgenin düğüm ağacının parçası olup olmadığı (WHATWG DOM §4.4). |
owner_document | `Document | None` | Okuma |
child_nodes | NodeList | Okuma | Tüm alt düğümlerin canlı NodeList. |
first_child | `Node | None` | Okuma |
last_child | `Node | None` | Okuma |
previous_sibling | `Node | None` | Okuma |
next_sibling | `Node | None` | Okuma |
Yöntemler
| İmza | Açıklama |
|---|---|
__init__() | Calls init bu Document örneğinde. |
normalize_document() | Bu belgeyi mevcut Node.normalize semantiklerini kullanarak normalleştirin. |
has_focus() → bool | Belgenin odaklanıp odaklanmadığını döndür — başsız modda her zaman False. |
open(type: str, replace: str) → "Document" | Belgeyi yazma için aç (WHATWG HTML §7.7). |
close() | Yazdıktan sonra belgeyi kapat (WHATWG HTML §7.7). |
write() | Bir dizeyi belge akışına yaz (WHATWG HTML §7.7). |
writeln() | Bir dizeyi ardından yeni satır ekleyerek yaz (WHATWG HTML §7.7). |
attach_style_sheet(sheet: "CSSStyleSheet") | Bu belgeye bir stil sayfası ekle. |
detach_style_sheet(sheet: "CSSStyleSheet") | Daha önce eklenmiş bir stil sayfasını ayır. |
| `save(path: “str | pathlib.Path”, encoding: str)` |
create_element(tag_name: str) → "HTMLElement" | Bu belgeye ait bir HTMLElement oluştur. |
create_element_ns(namespace_uri: str, qualified_name: str) → Element | Belirli bir ad alanında, bu belgeye ait bir Element oluştur. |
create_text_node(data: str) → Text | Verilen karakter verisiyle bir Metin düğümü oluşturun. |
create_comment(data: str) → Comment | Verilen karakter verisiyle bir Yorum düğümü oluşturun. |
create_cdata_section(data: str) → "CDATASection" | Bu belgeye ait bir CDATASection düğümü oluşturun. |
create_document_fragment() → DocumentFragment | Bu belgeye ait boş bir DocumentFragment oluşturun. |
create_event(interface: str) → "Event" | Şunun için bir legacy event object oluştur interface. |
create_range() → "Range" | Bu belgede çökmüş yeni bir Range oluştur. |
get_selection() → "Selection" | Bu belgenin tekil selection object’ini döndür. |
create_processing_instruction(target: str, data: str) → "ProcessingInstruction" | Bu belgeye ait bir ProcessingInstruction düğümü oluştur. |
create_attribute(local_name: str) → "Attr" | Bu belgeye ait ad alanı olmayan bir Attr oluştur. |
| `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 bu belgeye, mevcut ağacından taşıyarak. |
import_node(node: Node, deep: bool) → Node | Bir klonunu döndür node bu belgeye ait. |
get_element_by_id(id: str) → `Element | None` |
get_elements_by_tag_name(name: str) → HTMLCollection | Verilen etiket adına sahip tüm alt öğeleri döndür. |
get_elements_by_class_name(names: str) → HTMLCollection | Verilen tüm sınıf adlarına sahip tüm alt öğeleri döndür. |
filter_fn(el: Element) → bool | Bu Document örneğinde filter_fn(el) metodunu çağırır. |
get_elements_by_name(name: str) → NodeList | Alt öğelerin tümünü döndür, bunların name özniteliği eşittir name. |
| `get_elements_by_tag_name_ns(namespace: “str | None”, local_name: str)→list` |
prepend() | Insert nodes bu belgenin ilk çocuğundan önce. |
append() | Append nodes bu belgenin son çocukları olarak. |
replace_children() | Bu belgenin tüm çocuklarını kaldırın, ardından ekleyin nodes. |
query_selector(selector: str) → `Element | None` |
query_selector_all(selector: str) → NodeList | Tüm öğeleri CSS seçicisine uyan statik bir NodeList döndür. |
get_animations() → list[object] | Belge düzeyindeki animasyonları döndür (headless stub: her zaman []). |
element_from_point(x: float, y: float) | Her zaman None — headless, vurma testi için bir yerleşim motoruna sahip değildir (CSSOM View §11.6). |
elements_from_point(x: float, y: float) → list | Her zaman [] — headless, vurma testi için bir yerleşim motoruna sahip değildir (CSSOM View §11.6). |
exec_command(command_id: str, show_ui: bool, value: str) → bool | Her zaman False — eski düzenleme komutu; başsızda pipeline yok (WHATWG HTML §8.6.1). |
query_command_enabled(command_id: str) → bool | Her zaman False — başsızda düzenleme boru hattı yok (WHATWG HTML §8.6.1). |
has_storage_access() → bool | Her zaman True — başsız köken aynı köken gibi ele alınır (Storage Access API). |
request_storage_access() | İşlevsiz taslak — başsız her zaman depolama erişimine sahiptir; asenkron izin gerekmez (Storage Access API). |
get_root_node(composed: bool) → "Node" | Düğümün ağacının kökünü döndür. |
has_child_nodes() → bool | Bu düğümün en az bir doğrudan alt düğümü olup olmadığını döndür. |
| `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 bu düğümün son çocuğu olarak. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node çocuk listesinden al ve döndür. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | Bu düğümün bir kopyasını döndür. |
normalize() | Bu düğümü ve tüm alt ağacını normalleştirilmiş forma yerleştir. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | Pozisyonunu tanımlayan bir bitmask döndürün other bu düğüme göre. |
| `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 olayların type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | Daha önce kaydedilmiş bir dinleyiciyi kayıttan çıkar. |
dispatch_event(event: "Event") → bool | Dispatch event ata ağacı üzerinden. |