Element
Element
סקירה כללית
Element היא מחלקה ב-Aspose.Html FOSS עבור Python. יורשת מ-: Node.
צומת אלמנט של HTML או XML.
מחלקה זו מספקת 72 שיטות לעבודה עם אובייקטי Element בתוכניות Python. השיטות הזמינות כוללות: __init__, add_event_listener, after, append, append_child, attach_shadow, before, check_visibility, clone_node, closest, compare_document_position, contains, ו-60 שיטות נוספות. כל החברים הציבוריים נגישים לכל יישום Python לאחר התקנת חבילת Aspose.Html FOSS עבור Python. מאפיינים: assigned_slot, attributes, child_element_count, child_nodes, children, class_list, ו-43 נוספים.
מאפיינים
| שם | סוג | גישה | תיאור |
|---|---|---|---|
node_name | str | קריאה | שם התג המוסמך (אותיות גדולות עבור אלמנטים של HTML). |
tag_name | str | קריאה | שם התג המוסמך באותיות גדולות (אלמנטים של HTML). |
local_name | str | קריאה | החלק המקומי של השם המוסמך (אותיות קטנות). |
namespace_uri | `str | None` | קריאה |
style_sheets | "StyleSheetList" | קריאה | רשימת גיליונות סגנון חיה החלה על המסמך של אלמנט זה. |
prefix | `str | None` | קריאה |
id | str | קריאה | הערך של התכונה id, או '' אם אינה קיימת. |
class_name | str | קריאה | הערך של התכונה class, או ''. |
class_list | "DOMTokenList" | קריאה | קבוצה חיה ניתנת לשינוי של אסימוני מחלקה CSS המבוססת על המאפיין class. |
dataset | "DOMStringMap" | קריאה | תצוגה חיה בסגנון מילון של המאפיינים המותאמים data-* של האלמנט. |
attributes | NamedNodeMap | קריאה | המפה הממוינת של אובייקטי Attr עבור אלמנט זה. |
children | HTMLCollection | קריאה | אוסף HTMLCollection חי של ילדים מסוג Element בלבד. |
first_element_child | `Element | None` | קריאה |
last_element_child | `Element | None` | קריאה |
next_element_sibling | `Element | None` | קריאה |
previous_element_sibling | `Element | None` | קריאה |
child_element_count | int | קריאה | מספר הילדים של Element. |
inner_html | str | קריאה/כתיבה | התוכן הממוּז של HTML של כל הילדים (innerHTML). |
outer_html | str | קריאה/כתיבה | ה-HTML הממוּז של אלמנט זה וכל הצאצאים שלו (outerHTML). |
text_content | `str | None` | קריאה/כתיבה |
style | "CSSStyleDeclaration" | קריאה | הסגנון המוטבע של אלמנט זה כהצהרת CSSStyleDeclaration חיה. |
scroll_width | int | קריאה | רוחב גלילת התוכן ב-CSS פיקסלים (stub: 0). |
scroll_height | int | קריאה | גובה גלילת התוכן בפיקסלים של CSS (תבנית: 0). |
client_width | int | קריאה | רוחב פנימי כולל ריפוד, למעט גבול (תבנית: 0). |
client_height | int | קריאה | גובה פנימי כולל ריפוד, ללא גבול (stub: 0). |
scroll_top | int | קריאה/כתיבה | הזחה אנכית של הגלילה ב-CSS פיקסלים (stub: 0). |
scroll_left | int | קריאה/כתיבה | הזחה אופקית של הגלילה ב-CSS פיקסלים (stub: 0). |
offset_width | int | קריאה | רוחב תיבת-גבול של הפריסה ב-CSS פיקסלים (stub: 0). |
offset_height | int | קריאה | גובה תיבת-גבול של הפריסה ב-CSS פיקסלים (stub: 0). |
offset_top | int | קריאה | היסט עליון מ-offsetParent ב-CSS פיקסלים (stub: 0). |
offset_left | int | קריאה | ההזחה שמאלית מ-offsetParent ב-CSS פיקסלים (stub: 0). |
offset_parent | None | קריאה | אלמנט האב של ההזחה; תמיד None במצב headless mode. |
client_top | int | קריאה | רוחב הגבול העליון של CSS בפיקסלים; תמיד 0 במצב headless. |
client_left | int | קריאה | רוחב הגבול השמאלי של CSS בפיקסלים; תמיד 0 במצב headless. |
part | "DOMTokenList" | קריאה | DOMTokenList חי המשקף את המאפיין part של האלמנט. |
shadow_root | `` | קריאה | תמיד None במצב headless. |
slot | str | קריאה/כתיבה | משקף את תכונת התוכן slot (DOM §4.2.3). |
assigned_slot | `` | קריאה | תמיד None במצב headless. |
node_type | int | קריאה | קבוע של סוג צומת שלם מ-NodeType. |
node_value | `str | None` | קריאה/כתיבה |
parent_node | `Node | None` | קריאה |
parent_element | `Element | None` | קריאה |
is_connected | bool | קריאה | האם צומת זה הוא חלק מעץ הצמתים של המסמך (WHATWG DOM §4.4). |
owner_document | `Document | None` | קריאה |
child_nodes | NodeList | קריאה | תצוגה חיה של NodeList של כל צמתים צאצאים. |
first_child | `Node | None` | קריאה |
last_child | `Node | None` | קריאה |
previous_sibling | `Node | None` | קריאה |
next_sibling | `Node | None` | קריאה |
שיטות
| חתימה | תיאור |
|---|---|
| `init(local_name: str, namespace_uri: str | None, prefix: str |
get_computed_style() → "ComputedStyleDeclaration" | החזר הצהרות cascade-resolved של שלב-2 עבור אלמנט זה. |
insert_adjacent_html(position: str, html: str) | הכנס סימון HTML מפוענח ביחס לאלמנט זה. |
insert_adjacent_text(position: str, text: str) | הכנס צומת טקסט ביחס לאלמנט זה. |
| `insert_adjacent_element(position: str, element: “Element | None”)→“Element |
get_attribute(name: str) → `str | None` |
set_attribute(name: str, value: str) | הגדר תכונה name to value, יוצר אותו אם אינו קיים. |
remove_attribute(name: str) | הסר תכונה name. |
has_attribute(name: str) → bool | Return True אם תכונה name קיים באלמנט זה. |
get_attribute_node(name: str) → `“Attr | None”` |
set_attribute_node(attr: "Attr") → `“Attr | None”` |
remove_attribute_node(attr: "Attr") → "Attr" | Remove attr מתוך מערך המאפיינים של אלמנט זה ולהחזיר אותו. |
| `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] | החזר את השמות המלאים של כל המאפיינים בסדר האיסוף. |
has_attributes() → bool | החזר True כאשר אלמנט זה מכיל תכונה אחת או יותר. |
| `scroll_into_view(arg: bool | dict |
| `scroll(x_or_options: float | dict |
scroll_into_view_if_needed(center_if_needed: bool) | גלול אלמנט זה לתצוגה אם הוא עדיין אינו נראה (no-op in headless mode). |
set_pointer_capture(pointer_id: int) | הצב אלמנט זה כיעד לכידת סמן עבור הסמן הנתון (no-op). |
release_pointer_capture(pointer_id: int) | שחרר לכידת סמן עבור מזהה הסמן הנתון (no-op). |
has_pointer_capture(pointer_id: int) → bool | החזר האם לאלמנט זה יש לכידת סמן עבור המזהה הנתון. |
request_pointer_lock() | בקש שהסמן ינעל לאלמנט זה (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 | החזר NodeList סטטי של כל האלמנטים המתאימים selector. |
matches(selector: str) → bool | Return True אם אלמנט זה תואם ל-CSS selector. |
webkit_matches_selector(selector: str) → bool | שם חלופי לתאימות לדפדפן של :meth:matches. |
closest(selector: str) → `“Element | None”` |
get_elements_by_tag_name(qualified_name: str) → HTMLCollection | החזר את כל רכיבי הצאצאים ששמות התגים שלהם תואמים qualified_name. |
get_elements_by_class_name(class_names: str) → HTMLCollection | החזר את כל אלמנטי הצאצאים שנושאים את כל אסימוני המחלקה הנתונים. |
filter_fn(el: "Element") → bool | קורא ל-filter_fn(el) על מופע Element זה. |
remove() | הסר אלמנט זה מהצומת ההורה שלו. |
before() | Insert nodes מייד לפני אלמנט זה במבנה ההורה שלו. |
after() | Insert nodes מייד אחרי אלמנט זה במבנה ההורה. |
replace_with() | החלף אלמנט זה ב nodes במבנה ההורה. |
prepend() | Insert nodes לפני הילד הראשון של אלמנט זה. |
append() | Append nodes כילדים האחרונים של אלמנט זה. |
replace_children() | הסר את כל הילדים, ואז הוסף nodes כילדים חדשים. |
get_bounding_client_rect() → "DOMRect" | החזר את מלבן הגבול של הלקוח (תבנית כל-אפס). |
get_client_rects() → "DOMRectList" | החזר את רשימת מלבני הלקוח (ריקה בהקשר של צד השרת). |
get_animations() → list[object] | החזר את האנימציות הפעילות עבור אלמנט זה (תבנית ללא ראש: תמיד []). |
| `attach_shadow(init: “dict | None”)` |
get_root_node(composed: bool) → "Node" | החזר את השורש של עץ הצומת. |
has_child_nodes() → bool | החזר האם לצומת זה יש לפחות צומת ילד ישיר אחד. |
| `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 כילד האחרון של צומת זה. |
| `insert_before(node: Node, reference: Node | None)→Node` |
remove_child(node: Node) → Node | Remove node מרשימת הילדים והחזר אותו. |
replace_child(new_child: Node, old_child: Node) → Node | Replace old_child with new_child. |
clone_node(deep: bool) → Node | החזר עותק של הצומת הזה. |
normalize() | הציב את הצומת הזה ואת כל תת-העץ שלו במצב מנורמל. |
| `contains(other: Node | None)→bool` |
compare_document_position(other: "Node") → int | החזר מסכת ביטים המתארת את המיקום של other ביחס לצומת הזה. |
| `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 לאירועים של type. |
remove_event_listener(type: str, listener: Callable, capture: bool) | הסר רישום של מאזין שנרשם בעבר. |
dispatch_event(event: "Event") → bool | Dispatch event דרך עץ האבות. |