Document
Document
Tổng quan
Document là một lớp trong Aspose.Html FOSS cho Python. Kế thừa từ: Node.
Gốc của một cây DOM.
Lớp này cung cấp 66 phương thức để làm việc với các đối tượng Document trong các chương trình Python. Các phương thức có sẵn bao gồm: __init__, add_event_listener, adopt_node, append, append_child, attach_style_sheet, clone_node, close, compare_document_position, contains, create_attribute, create_attribute_ns, và 54 phương thức bổ sung. Tất cả các thành viên công khai đều có thể truy cập bởi bất kỳ ứng dụng Python nào sau khi cài đặt gói Aspose.Html FOSS cho Python. Thuộc tính: a_link_color, active_element, adopted_style_sheets, all, anchors, applets, và 67 mục nữa.
Thuộc tính
| Tên | Kiểu | Truy cập | Mô tả |
|---|---|---|---|
default_view | `` | Đọc | Đối tượng Window mỗi tài liệu (lazy, cached). |
location | `` | Đọc | Trả về đối tượng Location của Window liên quan, hoặc None. |
implementation | "DOMImplementation" | Đọc | Đối tượng DOMImplementation mỗi tài liệu (lazy, cached). |
dom_config | DOMConfiguration | Đọc | Đối tượng DOMConfiguration cho mỗi tài liệu (lười, được lưu trong bộ nhớ đệm). |
url | str | Đọc | URL tài liệu (WHATWG Document.URL), mặc định "about:blank". |
document_uri | str | Đọc | URL của tài liệu dưới dạng chuỗi (WHATWG DOM §4.5 documentURI). |
base_uri | str | Đọc | Đã giải quyết URL cơ sở cho tài liệu này (WHATWG DOM Node.baseURI). |
referrer | str | Đọc | URL tài liệu tham chiếu (WHATWG HTML Standard §document). |
domain | str | Đọc | Thành phần hostname của URL tài liệu (WHATWG HTML Standard §document). |
last_modified | str | Đọc | Chuỗi dấu thời gian lần sửa cuối (WHATWG HTML Standard §document). |
cookie | str | Đọc/Ghi | Đoạn mã chuỗi cookie chỉ đọc — luôn trả về "" (WHATWG HTML §8.11.1). |
hidden | bool | Đọc | Liệu tài liệu có bị ẩn — luôn False trong chế độ headless. |
visibility_state | str | Đọc | Trạng thái hiển thị tài liệu — luôn "visible" trong chế độ headless. |
design_mode | str | Đọc/Ghi | Liệu tài liệu có ở chế độ thiết kế (WHATWG HTML §7.6.4). |
dir | str | Đọc/Ghi | Hướng văn bản của tài liệu (WHATWG HTML §3.3.2). |
current_script | None | Đọc | Phần tử script đang được thực thi hiện tại (WHATWG HTML §8.1.3.4). |
character_set | str | Đọc | Mã ký tự được sử dụng trong quá trình phân tích (WHATWG DOM §3.1). |
charset | str | Đọc | Tên thay thế cho :attr:character_set (tên chuẩn HTML). |
input_encoding | str | Đọc | Tên thay thế cho :attr:character_set (tên tương thích WHATWG DOM). |
content_type | str | Đọc | Kiểu MIME tài liệu; luôn là "text/html" cho các tài liệu HTML. |
style_sheets | "StyleSheetList" | Đọc | Danh sách stylesheet tài liệu trực tiếp. |
adopted_style_sheets | list["CSSStyleSheet"] | Đọc/Ghi | Danh sách áp dụng stylesheet có thể tạo dựng ở cấp tài liệu. |
node_name | str | Đọc | '#document' |
document_element | `Element | None` | Đọc |
document_type | `DocumentType | None` | Đọc |
compat_mode | str | Đọc/Ghi | 'BackCompat' (quirks) hoặc 'CSS1Compat' (no-quirks). |
ready_state | str | Đọc | Trạng thái tải tài liệu. |
parse_errors | list[ParseError] | Đọc | Lỗi phân tích cú pháp từ thao tác phân tích cú pháp cuối cùng. |
head | `Element | None` | Đọc |
body | `Element | None` | Đọc |
forms | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của tất cả các phần tử <form> trong tài liệu. |
images | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của tất cả các phần tử <img> trong tài liệu. |
links | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của các phần tử <a href> và <area href>. |
scripts | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của tất cả các phần tử <script> trong tài liệu. |
embeds | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của tất cả các thế hệ con cháu <embed>. |
applets | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của tất cả các thế hệ con cháu <applet>. |
anchors | "HTMLCollection" | Đọc | Bộ sưu tập trực tiếp của các phần tử <a name=...> (các anchor có tên legacy). |
title | str | Đọc/Ghi | Nội dung văn bản của phần tử <title> đầu tiên trong <head>. |
compatible_mode | str | Đọc | Chỉ báo chế độ Quirks (WHATWG HTML §3.2.1). |
strict_error_checking | bool | Đọc/Ghi | Luôn True trong chế độ không giao diện (DOM3 Core §1.1.1). |
first_element_child | `“Element | None”` | Đọc |
last_element_child | `“Element | None”` | Đọc |
child_element_count | int | Đọc | Số lượng các nút con trực tiếp là các nút Element. |
active_element | `“Element | None”` | Đọc |
full_screen_enabled | bool | Đọc | Luôn False — không hiển thị trong chế độ headless (Fullscreen API §7). |
fullscreen_element | None | Đọc | Luôn None — không có phần tử fullscreen trong chế độ headless (Fullscreen API §7). |
pointer_lock_element | None | Đọc | Luôn None — không có pointer lock trong chế độ headless (Pointer Lock API §4). |
timeline | "_DocumentTimeline" | Đọc | Bản mẫu dòng thời gian tài liệu; current_time luôn là 0.0 (Web Animations API §6.2). |
all | "_AllCollection" | Đọc | Tất cả các phần tử theo thứ tự cây (WHATWG HTML §legacy document layout interface). |
plugins | "HTMLCollection" | Đọc | Bí danh cho :attr:embeds theo WHATWG HTML §4.1 legacy interface. |
children | "HTMLCollection" | Đọc | Các phần tử con trực tiếp của tài liệu (WHATWG DOM §4.2.6 ParentNode). |
origin | str | Đọc | Chuỗi nguồn gốc không trong suốt — luôn luôn 'null' trong chế độ không giao diện (WHATWG DOM §4.5). |
fg_color | str | Đọc/Ghi | Phản ánh thuộc tính cấp tài liệu fgColor đã lỗi thời thông qua thuộc tính <body> text. |
bg_color | str | Đọc/Ghi | Phản ánh thuộc tính cấp tài liệu bgColor lỗi thời thông qua thuộc tính <body> bgcolor. |
link_color | str | Đọc/Ghi | Phản ánh thuộc tính cấp tài liệu linkColor lỗi thời thông qua thuộc tính <body> link. |
v_link_color | str | Đọc/Ghi | Phản ánh thuộc tính cấp tài liệu vlinkColor lỗi thời thông qua thuộc tính <body> vlink. |
a_link_color | str | Đọc/Ghi | Phản ánh thuộc tính cấp tài liệu alinkColor lỗi thời thông qua thuộc tính <body> alink. |
fonts | `` | Đọc | Luôn None trong chế độ không giao diện. |
picture_in_picture_enabled | bool | Đọc | Luôn False trong chế độ không giao diện. |
picture_in_picture_element | `` | Đọc | Luôn None trong chế độ không giao diện. |
prerendering | bool | Đọc | Luôn False trong chế độ không giao diện. |
node_type | int | Đọc | Hằng số kiểu nút nguyên từ NodeType. |
node_value | `str | None` | Đọc/Ghi |
text_content | `str | None` | Đọc/Ghi |
parent_node | `Node | None` | Đọc |
parent_element | `Element | None` | Đọc |
is_connected | bool | Đọc | Liệu nút này có phải là một phần của cây nút của tài liệu hay không (WHATWG DOM §4.4). |
owner_document | `Document | None` | Đọc |
child_nodes | NodeList | Đọc | Một NodeList trực tiếp của tất cả các nút con. |
first_child | `Node | None` | Đọc |
last_child | `Node | None` | Đọc |
previous_sibling | `Node | None` | Đọc |
next_sibling | `Node | None` | Đọc |
Phương thức
| Chữ ký | Mô tả |
|---|---|
__init__() | Calls init trên thể hiện Document này. |
normalize_document() | Chuẩn hoá tài liệu này bằng cách sử dụng ngữ nghĩa Node.normalize hiện có. |
has_focus() → bool | Trả về việc tài liệu có tiêu điểm hay không — luôn luôn False trong chế độ không giao diện. |
open(type: str, replace: str) → "Document" | Mở tài liệu để ghi (WHATWG HTML §7.7). |
close() | Đóng tài liệu sau khi ghi (WHATWG HTML §7.7). |
write() | Ghi một chuỗi vào luồng tài liệu (WHATWG HTML §7.7). |
writeln() | Ghi một chuỗi kèm theo dấu xuống dòng (WHATWG HTML §7.7). |
attach_style_sheet(sheet: "CSSStyleSheet") | Gắn một stylesheet vào tài liệu này. |
detach_style_sheet(sheet: "CSSStyleSheet") | Tách một stylesheet đã được gắn trước đó. |
| `save(path: “str | pathlib.Path”, encoding: str)` |
create_element(tag_name: str) → "HTMLElement" | Tạo một HTMLElement thuộc sở hữu của tài liệu này. |
create_element_ns(namespace_uri: str, qualified_name: str) → Element | Tạo một Element trong một không gian tên cụ thể, thuộc sở hữu của tài liệu này. |
create_text_node(data: str) → Text | Tạo một nút Text với dữ liệu ký tự đã cho. |
create_comment(data: str) → Comment | Tạo một nút Comment với dữ liệu ký tự đã cho. |
create_cdata_section(data: str) → "CDATASection" | Tạo một nút CDATASection thuộc sở hữu của tài liệu này. |
create_document_fragment() → DocumentFragment | Tạo một DocumentFragment rỗng thuộc sở hữu của tài liệu này. |
create_event(interface: str) → "Event" | Tạo một đối tượng sự kiện kế thừa cho interface. |
create_range() → "Range" | Tạo một Range mới được thu gọn tại tài liệu này. |
get_selection() → "Selection" | Trả về đối tượng selection singleton của tài liệu này. |
create_processing_instruction(target: str, data: str) → "ProcessingInstruction" | Tạo một nút ProcessingInstruction thuộc sở hữu của tài liệu này. |
create_attribute(local_name: str) → "Attr" | Tạo một Attr không có không gian tên thuộc sở hữu của tài liệu này. |
| `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 vào tài liệu này, di chuyển nó từ cây hiện tại. |
import_node(node: Node, deep: bool) → Node | Trả về một bản sao của node thuộc tài liệu này. |
get_element_by_id(id: str) → `Element | None` |
get_elements_by_tag_name(name: str) → HTMLCollection | Trả về tất cả các phần tử con với tên thẻ đã cho. |
get_elements_by_class_name(names: str) → HTMLCollection | Trả về tất cả các phần tử con có tất cả các tên lớp đã cho. |
filter_fn(el: Element) → bool | Gọi filter_fn(el) trên đối tượng Document này. |
get_elements_by_name(name: str) → NodeList | Trả về tất cả các phần tử con mà name thuộc tính bằng name. |
| `get_elements_by_tag_name_ns(namespace: “str | None”, local_name: str)→list` |
prepend() | Insert nodes trước phần tử con đầu tiên của tài liệu này. |
append() | Append nodes như các phần tử con cuối cùng của tài liệu này. |
replace_children() | Xóa tất cả các phần tử con của tài liệu này, sau đó thêm vào nodes. |
query_selector(selector: str) → `Element | None` |
query_selector_all(selector: str) → NodeList | Trả về một NodeList tĩnh của tất cả các phần tử khớp với bộ chọn CSS. |
get_animations() → list[object] | Trả về các hoạt ảnh cấp tài liệu (đoạn mô phỏng headless: luôn []). |
element_from_point(x: float, y: float) | Luôn None — headless không có engine bố cục để kiểm tra va chạm (CSSOM View §11.6). |
elements_from_point(x: float, y: float) → list | Luôn [] — headless không có engine bố cục để kiểm tra va chạm (CSSOM View §11.6). |
exec_command(command_id: str, show_ui: bool, value: str) → bool | Luôn False — lệnh chỉnh sửa kế thừa; không có pipeline trong chế độ headless (WHATWG HTML §8.6.1). |
query_command_enabled(command_id: str) → bool | Luôn False — không có pipeline chỉnh sửa trong headless (WHATWG HTML §8.6.1). |
has_storage_access() → bool | Luôn True — origin headless được coi là cùng nguồn (Storage Access API). |
request_storage_access() | Stub không thực hiện gì — headless luôn có quyền truy cập lưu trữ; không cần cấp quyền bất đồng bộ (Storage Access API). |
get_root_node(composed: bool) → "Node" | Trả về nút gốc của cây node. |
has_child_nodes() → bool | Trả về liệu nút này có ít nhất một nút con trực tiếp hay không. |
| `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 là con cuối cùng của nút này. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node từ danh sách con và trả về nó. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | Trả về một bản sao của nút này. |
normalize() | Đưa nút này và toàn bộ cây con của nó vào dạng chuẩn. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | Trả về một bitmask mô tả vị trí của other so với nút này. |
| `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 cho các sự kiện của type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | Hủy đăng ký một listener đã được đăng ký trước đó. |
dispatch_event(event: "Event") → bool | Dispatch event qua cây tổ tiên. |
