HTMLDialogElement
نمای کلی
HTMLDialogElement یک کلاس در Aspose.Html FOSS برای Python است. ارث میبرد از: HTMLElement.
HTML <dialog> عنصر گفتوگوی modal/non-modal.
این کلاس 81 متد برای کار با اشیاء HTMLDialogElement در برنامههای Python فراهم میکند. متدهای موجود شامل: __init__، add_event_listener، after، append، append_child، attach_shadow، before، blur، check_visibility، click، clone_node، close و 69 متد دیگر هستند. تمام اعضای عمومی پس از نصب Aspose.Html FOSS برای Python package به هر برنامه Python قابل دسترسی هستند. خصوصیات: access_key، access_key_label، assigned_slot، attributes، autocapitalize، autofocus و 66 مورد دیگر.
خواص
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
open | bool | خواندن/نوشتن | ویژگی حضور بولی open. |
return_value | str | خواندن/نوشتن | مقدار بازگشت دیالوگ که توسط close() تنظیم میشود. |
hidden | bool | خواندن/نوشتن | آیا عنصر مخفی است (بازتابدهنده ویژگی بولی hidden). |
title | str | خواندن/نوشتن | عنوان تولتیپ این عنصر (بازتابدهنده ویژگی title). |
lang | str | خواندن/نوشتن | زبان محتوای عنصر (بازتابدهنده ویژگی lang). |
tab_index | int | خواندن/نوشتن | شاخص ترتیب تب این عنصر (بازتابدهندهٔ ویژگی tabindex). |
access_key | str | خواندن/نوشتن | کلید میانبر صفحهکلید برای این عنصر (بازتابدهندهٔ accesskey |
attribute). || content_editable | str | خواندنی/نوشتنی | بازتابدهندهٔ ویژگی contenteditable (WHATWG HTML §6.6). | | is_content_editable | bool | خواندنی | آیا این عنصر در حال حاضر قابل ویرایش است (WHATWG HTML §6.5). | | dir | str | خواندنی/نوشتنی | جهتگیری متن عنصر (بازتابدهندهٔ ویژگی dir). | | draggable | bool | خواندنی/نوشتنی | آیا عنصر قابل کشیدن است (بازتابدهندهٔ ویژگی draggable). | | spell_check | bool | خواندنی/نوشتنی | آیا تصحیح املایی فعال است (بازتابدهندهٔ ویژگی spellcheck). | | spellcheck | bool | خواندنی/نوشتنی | آیا تصحیح املایی فعال است (بازتابدهندهٔ ویژگی spellcheck). | | autocapitalize | str | خواندنی/نوشتنی | راهنمای خودکار بزرگنویسی (بازتابدهندهٔ ویژگی autocapitalize). | | nonce | str | خواندنی/نوشتنی | عدد تصادفی رمزنگاری برای CSP (بازتابدهندهٔ ویژگی nonce). | | autofocus | bool | خواندنی/نوشتنی | آیا این عنصر باید هنگام بارگذاری صفحه فوکوس دریافت کند. | | access_key_label | str | خواندنی | برچسب کلید دسترسی اختصاص دادهشده توسط سیستم (نمونهٔ بدون سر: همیشه ''). | | input_mode | str | خواندنی/نوشتنی | راهنمای حالت ورودی صفحهکلید مجازی (بازتابدهندهٔ ویژگی inputmode). | | enter_key_hint | str | خواندنی/نوشتنی | راهنمای برچسب عمل کلید ورود (بازتابدهندهٔ ویژگی enterkeyhint). | | translate | bool | خواندنی/نوشتنی | آیا ترجمه برای این عنصر فعال است (WHATWG HTML §6.1.2). | | inner_text | str | خواندنی/نوشتنی | محتوای متنی رندر شده — فضاهای خالی فشردهشده text_content. | | outer_text | str | خواندنی/نوشتنی | همانند inner_text (گرفتنکنندهٔ بازتابدهندهٔ inner_text مطابق استاندارد HTML §3.2.7). | | popover | | Read/Write | Reflects thepopovercontent attribute (WHATWG HTML §6.12). | | node_name|str| Read | The qualified tag name (uppercase for HTML elements). | |tag_name|str| Read | The qualified tag name in uppercase (HTML elements). | |local_name|str| Read | The local part of the qualified name (lowercase). | |namespace_uri|str | None | Read | The namespace URI, orNonefor no namespace. | | style_sheets|“StyleSheetList”| Read | Live stylesheet list applicable to this element's document. | |prefix|str | None | Read | The namespace prefix, orNone. | | id|str| Read | The value of theidattribute, or’’if not present. | | class_name|str | Read | The value of theclassattribute, or’’. | | class_list|“DOMTokenList”| Read | Live mutable set of CSS class tokens backed by theclassattribute. | | dataset|“DOMStringMap” | Read | Live dict-like view of the element'sdata-*custom attributes. | | attributes|NamedNodeMap| Read | The ordered map of Attr objects for this element. | |children|HTMLCollection| Read | A live HTMLCollection of Element-type children only. | |first_element_child|Element | None | Read | The first Element child, orNone. | | last_element_child|Element | None| Read | The last Element child, orNone. | | next_element_sibling|Element | None| Read | The next sibling that is an Element, orNone. | | previous_element_sibling|Element | None| Read | The previous sibling that is an Element, orNone. | | child_element_count|int| Read | The number of Element children. | |inner_html|str| Read/Write | The serialised HTML content of all children (innerHTML). | |outer_html|str| Read/Write | The serialised HTML of this element and all its descendants (outerHTML). | |text_content|str | None| Read/Write | The concatenation of all descendant Text node data (DFS order). | |style|“CSSStyleDeclaration”| Read | The inline style of this element as a live CSSStyleDeclaration. | |scroll_width|int| Read | Content scroll width in CSS pixels (stub: 0). | |scroll_height|int| Read | Content scroll height in CSS pixels (stub: 0). | |client_width|int| Read | Inner width including padding, excluding border (stub: 0). | |client_height|int| Read | Inner height including padding, excluding border (stub: 0). | |scroll_top|int| Read/Write | Vertical scroll offset in CSS pixels (stub: 0). | |scroll_left|int| Read/Write | Horizontal scroll offset in CSS pixels (stub: 0). | |offset_width|int| Read | Layout border-box width in CSS pixels (stub: 0). | |offset_height|int| Read | Layout border-box height in CSS pixels (stub: 0). | |offset_top|int| Read | Top offset fromoffsetParentin CSS pixels (stub: 0). | | offset_left|int | Read | Left offset fromoffsetParentin CSS pixels (stub: 0). | | offset_parent|None | Read | The offset parent element; alwaysNonein headless mode. | | client_top|int | Read | Width of the top CSS border in pixels; always0in headless mode. | | client_left|int | Read | Width of the left CSS border in pixels; always0in headless mode. | | part|“DOMTokenList” | Read | Live DOMTokenList reflecting the elementpartattribute. | | shadow_root | | | | | خواندنی | همیشه None در حالت بدون سر. | | slot | str | خواندنی/نوشتنی | بازتابدهندهٔ ویژگی محتوا slot (DOM §4.2.3). | | assigned_slot | | Read | AlwaysNonein headless mode. | | node_type|int | Read | Integer node type constant fromNodeType. | | node_value|str | None| Read/Write | Character data for CharacterData nodes;Noneotherwise. | | parent_node|Node | None | Read | The parent node, orNoneif this node has no parent. | | parent_element|Element | None | Read | The parent node if it is an Element;Noneotherwise. | | is_connected|bool| Read | Whether this node is part of a document's node tree (WHATWG DOM §4.4). | |owner_document|Document | None | Read | The Document this node belongs to, orNonefor Document itself. | | child_nodes|NodeList| Read | A live NodeList of all child nodes. | |first_child|Node | None | Read | The first child node, orNone. | | last_child|Node | None| Read | The last child node, orNone. | | previous_sibling|Node | None| Read | The preceding sibling node, orNone. | | next_sibling|Node | None| Read | The following sibling node, orNone``. |
روش ها
| امضا | توضیح |
|---|---|
show() | عنصر دیالوگ را در حالت غیرمودال باز کنید (headless stub). |
show_modal() | عنصر دیالوگ را در حالت مودال باز کنید (headless stub). |
close(return_value: str) | دیالوگ را ببندید و بهصورت اختیاری مقدار بازگشتی را ثبت کنید. |
click() | یک رویداد کلیک مصنوعی را بر روی این عنصر ارسال کنید. |
| `focus(options: “dict | None”)` |
blur() | یک رویداد 'blur' غیر حبابی را بر روی این عنصر ارسال کنید. |
show_popover() | این عنصر را بهصورت popover نمایش دهید (no-op در حالت headless). |
hide_popover() | پاپاور این عنصر را مخفی کنید (no-op در حالت headless). |
| `toggle_popover(force: “bool | None”)→bool` |
| `init(local_name: str, namespace_uri: str | None, prefix: str |
get_computed_style() → "ComputedStyleDeclaration" | اعلانهای حلشده بهصورت cascade در فاز-۲ را برای این عنصر بازگردانید. |
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) | اگر این عنصر هنوز قابل مشاهده نیست، آن را به نمای صفحه اسکرول کنید (در حالت headless هیچ عملی انجام نمیشود). |
set_pointer_capture(pointer_id: int) | این عنصر را به عنوان هدف ضبط برای نشانگر دادهشده تعیین کنید (هیچ عملی انجام نمیشود). |
release_pointer_capture(pointer_id: int) | ضبط نشانگر برای شناسه نشانگر دادهشده را رها کنید (هیچ عملی انجام نمیشود). |
has_pointer_capture(pointer_id: int) → bool | بازگرداندن این که آیا این عنصر برای شناسهٔ داده شده، ضبط اشارهگر دارد یا خیر. |
request_pointer_lock() | درخواست قفل کردن اشارهگر به این عنصر (بدوناثر). |
| `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) را بر روی این نمونهٔ HTMLDialogElement فراخوانی میکند. |
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) | لغو ثبت یک listener که پیش از این ثبت شده بود. |
dispatch_event(event: "Event") → bool | Dispatch event از طریق درخت اجداد. |