HTMLImageElement
نمای کلی
HTMLImageElement یک کلاس در Aspose.Html FOSS برای Python است. ارث میبرد از: HTMLElement.
HTML <img> عنصر تصویر.
این کلاس ۷۹ متد برای کار با اشیاء HTMLImageElement در برنامههای Python فراهم میکند. متدهای موجود شامل: __init__, add_event_listener, after, append, append_child, attach_shadow, before, blur, check_visibility, click, clone_node, closest و ۶۷ متد دیگر. تمام اعضای عمومی پس از نصب بسته Aspose.Html FOSS برای Python برای هر برنامه Python قابل دسترسی هستند. خصوصیات: access_key, access_key_label, alt, assigned_slot, attributes, autocapitalize و ۸۳ مورد دیگر.
خواص
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
src | str | خواندن/نوشتن | مقدار ویژگی src یا '' در صورت عدم وجود. |
alt | str | خواندن/نوشتن | مقدار ویژگی alt یا '' در صورت عدم وجود. |
width | int | خواندن/نوشتن | ویژگی width بهصورت عدد صحیح (پیشفرض 0). |
height | int | خواندن/نوشتن | ویژگی height بهصورت عدد صحیح (پیشفرض 0). |
srcset | str | خواندن/نوشتن | مقدار ویژگی srcset، یا '' در صورت عدم وجود. |
sizes | str | خواندن/نوشتن | مقدار ویژگی sizes، یا '' در صورت عدم وجود. |
loading | str | خواندن/نوشتن | مقدار ویژگی loading، یا '' زمانی که موجود نیست. |
decoding | str | خواندن/نوشتن | مقدار ویژگی decoding، یا '' زمانی که موجود نیست. |
cross_origin | `str | None` | خواندن/نوشتن |
use_map | str | خواندن/نوشتن | مقدار ویژگی usemap، یا '' در صورت عدم حضور. |
is_map | bool | خواندن/نوشتن | آیا ویژگی بولی ismap موجود است. |
complete | bool | خواندن | همیشه False در حالت بدون سر (بدون دریافت شبکه). |
natural_width | int | خواندن | همیشه 0 در حالت بدون سر (بدون موتور چیدمان). |
natural_height | int | خواندن | همواره 0 در حالت بدون سر (بدون موتور قالببندی). |
current_src | str | خواندن | آدرس URL منبع انتخابشده فعلی (حالت بدون سر: ویژگی src را نشان میدهد). |
referrer_policy | str | خواندن/نوشتن | بازتاب ویژگی referrerpolicy؛ پیشفرض ''. |
fetch_priority | str | خواندن/نوشتن | بازتاب ویژگی fetchpriority؛ پیشفرض ''. |
x | int | خواندن | قطعهکد موقعیت چیدمان افقی — همیشه 0 در حالت بدون سر. |
y | int | خواندن | قطعه موقعیت چیدمان عمودی — همیشه 0 در حالت headless. |
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.6). | | 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 | خواندن/نوشتن | راهنمای برچسب عمل کلید Enter (بازتاب میدهد ویژگی 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``. |
روش ها
| امضا | توضیح |
|---|---|
decode() | تصویر را رمزگشایی کنید (در حالت بدون رابط کاربری پشتیبانی نمیشود). |
click() | یک رویداد click مصنوعی را روی این عنصر ارسال کنید. |
| `focus(options: “dict | None”)` |
blur() | یک رویداد 'blur' غیر حبابی را بر روی این عنصر ارسال کنید. |
show_popover() | این عنصر را بهصورت popover نمایش دهید (در حالت headless هیچ عملی انجام نمیشود). |
hide_popover() | popover این عنصر را مخفی کنید (در حالت headless هیچ عملی انجام نمیشود). |
| `toggle_popover(force: “bool | None”)→bool` |
| `init(local_name: str, namespace_uri: str | None, prefix: str |
get_computed_style() → "ComputedStyleDeclaration" | اعلامیههای phase-2 cascade-resolved را برای این عنصر برگردانید. |
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) را بر روی این نمونهٔ HTMLImageElement فراخوانی میکند. |
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 از طریق درخت اجداد. |