Element

Tổng quan

Element là một lớp trong Aspose.Html FOSS cho Python. Kế thừa từ: Node.

Một nút phần tử HTML hoặc XML.

Lớp này cung cấp 72 phương thức để làm việc với các đối tượng Element trong các chương trình Python. Các phương thức khả dụng bao gồm: __init__, add_event_listener, after, append, append_child, attach_shadow, before, check_visibility, clone_node, closest, compare_document_position, contains, và 60 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: assigned_slot, attributes, child_element_count, child_nodes, children, class_list, và 43 mục khác.

Thuộc tính

Tên	Kiểu	Truy cập	Mô tả
`node_name`	`str`	Đọc	Tên thẻ đủ điều kiện (chữ hoa cho các phần tử HTML).
`tag_name`	`str`	Đọc	Tên thẻ đủ điều kiện ở dạng chữ hoa (HTML phần tử).
`local_name`	`str`	Đọc	Phần cục bộ của tên đã định danh (chữ thường).
`namespace_uri`	`str	None`	Đọc
`style_sheets`	`"StyleSheetList"`	Đọc	Danh sách stylesheet trực tiếp áp dụng cho tài liệu của phần tử này.
`prefix`	`str	None`	Đọc
`id`	`str`	Đọc	Giá trị của thuộc tính `id`, hoặc `''` nếu không có.
`class_name`	`str`	Đọc	Giá trị của thuộc tính `class`, hoặc `''`.
`class_list`	`"DOMTokenList"`	Đọc	Tập hợp có thể thay đổi trực tiếp của các token lớp CSS được hỗ trợ bởi thuộc tính `class`.
`dataset`	`"DOMStringMap"`	Đọc	Cái nhìn dạng từ điển trực tiếp của các thuộc tính tùy chỉnh `data-*` của phần tử.
`attributes`	`NamedNodeMap`	Đọc	Bản đồ có thứ tự của các đối tượng Attr cho phần tử này.
`children`	`HTMLCollection`	Đọc	Một HTMLCollection động chỉ chứa các phần tử con kiểu Element.
`first_element_child`	`Element	None`	Đọc
`last_element_child`	`Element	None`	Đọc
`next_element_sibling`	`Element	None`	Đọc
`previous_element_sibling`	`Element	None`	Đọc
`child_element_count`	`int`	Đọc	Số lượng các phần tử con.
`inner_html`	`str`	Đọc/Ghi	Nội dung HTML đã được tuần tự hoá của tất cả các phần tử con (innerHTML).
`outer_html`	`str`	Đọc/Ghi	Đoạn HTML đã được tuần tự hoá của phần tử này và tất cả các phần tử con cháu (outerHTML).
`text_content`	`str	None`	Đọc/Ghi
`style`	`"CSSStyleDeclaration"`	Đọc	Kiểu nội tuyến của phần tử này dưới dạng một CSSStyleDeclaration đang hoạt động.
`scroll_width`	`int`	Đọc	Chiều rộng cuộn nội dung tính bằng CSS pixel (stub: 0).
`scroll_height`	`int`	Đọc	Chiều cao cuộn nội dung tính bằng CSS pixel (stub: 0).
`client_width`	`int`	Đọc	Chiều rộng nội bộ bao gồm phần đệm, không tính viền (stub: 0).
`client_height`	`int`	Đọc	Chiều cao nội bao gồm padding, không tính border (stub: 0).
`scroll_top`	`int`	Đọc/Ghi	Khoảng bù cuộn dọc tính bằng pixel CSS (stub: 0).
`scroll_left`	`int`	Đọc/Ghi	Khoảng bù cuộn ngang tính bằng pixel CSS (stub: 0).
`offset_width`	`int`	Đọc	Chiều rộng border-box của bố cục tính bằng CSS pixel (stub: 0).
`offset_height`	`int`	Đọc	Chiều cao border-box của bố cục tính bằng CSS pixel (stub: 0).
`offset_top`	`int`	Đọc	Khoảng cách trên từ `offsetParent` tính bằng CSS pixel (stub: 0).
`offset_left`	`int`	Đọc	Khoảng cách bên trái từ `offsetParent` trong CSS pixel (stub: 0).
`offset_parent`	`None`	Đọc	Phần tử cha offset; luôn luôn `None` trong chế độ không giao diện.
`client_top`	`int`	Đọc	Chiều rộng của viền CSS trên tính bằng pixel; luôn `0` trong chế độ không giao diện.
`client_left`	`int`	Đọc	Chiều rộng của viền CSS trái tính bằng pixel; luôn `0` trong chế độ headless.
`part`	`"DOMTokenList"`	Đọc	DOMTokenList trực tiếp phản ánh thuộc tính `part` của phần tử.
`shadow_root`	``	Đọc	Luôn `None` trong chế độ headless.
`slot`	`str`	Đọc/Ghi	Phản ánh thuộc tính nội dung `slot` (DOM §4.2.3).
`assigned_slot`	``	Đọc	Luôn `None` 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
`parent_node`	`Node	None`	Đọc
`parent_element`	`Element	None`	Đọc
`is_connected`	`bool`	Đọc	Liệu node này có phải là một phần của cây node của tài liệu (WHATWG DOM §4.4) hay không.
`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(local_name: str, namespace_uri: str	None, prefix: str
`get_computed_style()` → `"ComputedStyleDeclaration"`	Trả về các khai báo đã giải quyết cascade giai đoạn-2 cho phần tử này.
`insert_adjacent_html(position: str, html: str)`	Chèn mã đánh dấu HTML đã phân tích tương đối với phần tử này.
`insert_adjacent_text(position: str, text: str)`	Chèn một nút văn bản tương đối với phần tử này.
`insert_adjacent_element(position: str, element: “Element	None”)`→`“Element
`get_attribute(name: str)` → `str	None`
`set_attribute(name: str, value: str)`	Đặt thuộc tính name to value, tạo nó nếu không có.
`remove_attribute(name: str)`	Xóa thuộc tính name.
`has_attribute(name: str)` → `bool`	Return `True` nếu thuộc tính name tồn tại trên phần tử này.
`get_attribute_node(name: str)` → `“Attr	None”`
`set_attribute_node(attr: "Attr")` → `“Attr	None”`
`remove_attribute_node(attr: "Attr")` → `"Attr"`	Remove attr từ tập hợp thuộc tính của phần tử này và trả về nó.
`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]`	Trả về các tên đầy đủ của tất cả các thuộc tính theo thứ tự thu thập.
`has_attributes()` → `bool`	Trả về `True` khi phần tử này có một hoặc nhiều thuộc tính.
`scroll_into_view(arg: bool	dict
`scroll(x_or_options: float	dict
`scroll_into_view_if_needed(center_if_needed: bool)`	Cuộn phần tử này vào vùng hiển thị nếu nó chưa hiển thị (không thực hiện gì trong chế độ không giao diện).
`set_pointer_capture(pointer_id: int)`	Chỉ định phần tử này làm mục tiêu bắt cho con trỏ đã cho (no-op).
`release_pointer_capture(pointer_id: int)`	Giải phóng việc bắt con trỏ cho ID con trỏ đã cho (no-op).
`has_pointer_capture(pointer_id: int)` → `bool`	Trả về liệu phần tử này có bắt con trỏ cho ID đã cho hay không.
`request_pointer_lock()`	Yêu cầu khóa con trỏ vào phần tử này (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`	Trả về một NodeList tĩnh của tất cả các phần tử khớp selector.
`matches(selector: str)` → `bool`	Return `True` nếu phần tử này khớp với CSS selector.
`webkit_matches_selector(selector: str)` → `bool`	Bí danh tương thích trình duyệt cho :meth:`matches`.
`closest(selector: str)` → `“Element	None”`
`get_elements_by_tag_name(qualified_name: str)` → `HTMLCollection`	Trả về tất cả các phần tử con có tên thẻ phù hợp qualified_name.
`get_elements_by_class_name(class_names: str)` → `HTMLCollection`	Trả về tất cả các phần tử con mà mang tất cả các token lớp đã cho.
`filter_fn(el: "Element")` → `bool`	Gọi filter_fn(el) trên thể hiện Element này.
`remove()`	Xóa phần tử này khỏi nút cha của nó.
`before()`	Insert nodes ngay trước phần tử này trong nút cha của nó.
`after()`	Insert nodes ngay sau phần tử này trong cha của nó.
`replace_with()`	Thay thế phần tử này bằng nodes trong cha của nó.
`prepend()`	Insert nodes trước đứa con đầu tiên của phần tử này.
`append()`	Append nodes như là các phần tử con cuối cùng của phần tử này.
`replace_children()`	Xóa tất cả các phần tử con, sau đó thêm nodes như các phần tử con mới.
`get_bounding_client_rect()` → `"DOMRect"`	Trả về hình chữ nhật client bao quanh (mẫu all-zero).
`get_client_rects()` → `"DOMRectList"`	Trả về danh sách hình chữ nhật client (trống trong ngữ cảnh phía máy chủ).
`get_animations()` → `list[object]`	Trả về các hoạt ảnh đang hoạt động cho phần tử này (mẫu headless: luôn `[]`).
`attach_shadow(init: “dict	None”)`
`get_root_node(composed: bool)` → `"Node"`	Trả về gốc của cây của nút.
`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à nút 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()`	Đặt nút này và toàn bộ cây con của nó vào dạng chuẩn hoá.
`contains(other: Node	None)`→`bool`
`compare_document_position(other: "Node")` → `int`	Trả về một mặt nạ bit 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 đã đăng ký trước đó.
`dispatch_event(event: "Event")` → `bool`	Dispatch event qua cây tổ tiên.

Xem thêm

Aspose.HTML for Python — Enterprise API Reference