HTMLInputElement

نظرة عامة

HTMLInputElement هي فئة في Aspose.Html FOSS لـ Python. ترث من: _ConstraintValidationMixin, HTMLElement.

HTML <input> عنصر تحكم النموذج.

توفر هذه الفئة 84 طريقة للعمل مع كائنات HTMLInputElement في برامج Python. تشمل الطرق المتاحة: __init__، add_event_listener، after، append، append_child، attach_shadow، before، blur، check_visibility، click، clone_node، closest، و72 طريقة إضافية. جميع الأعضاء العامين يمكن الوصول إليهم من أي تطبيق Python بعد تثبيت حزمة Aspose.Html FOSS لـ Python. الخصائص: accept، access_key، access_key_label، alt، assigned_slot، attributes، و111 أخرى.

خصائص

اسم	النوع	الوصول	وصف
`type`	`str`	قراءة/كتابة	قيمة السمة `type`; تُرجِع `'text'` عندما تكون غير موجودة (القيمة الافتراضية لـ WHATWG).
`value`	`str`	قراءة/كتابة	قيمة السمة `value`, أو `''` عندما تكون غير موجودة.
`default_value`	`str`	قراءة/كتابة	القيمة الافتراضية من سمة المحتوى `value`.
`name`	`str`	قراءة/كتابة	قيمة السمة `name`، أو `''` عندما تكون غائبة.
`checked`	`bool`	قراءة/كتابة	سمة الوجود البوليانية `checked`.
`disabled`	`bool`	قراءة/كتابة	سمة التواجد المنطقية `disabled`.
`required`	`bool`	قراءة/كتابة	خاصية الوجود البوليانية `required`.
`pattern`	`str`	قراءة/كتابة	قيمة سمة `pattern`، أو `''` عندما تكون غير موجودة.
`max_length`	`int`	قراءة/كتابة	سمة `maxlength` كعدد صحيح (الإعداد الافتراضي `-1`).
`min_length`	`int`	قراءة/كتابة	السمة `minlength` كعدد صحيح (الافتراضي `-1`).
`placeholder`	`str`	قراءة/كتابة	قيمة السمة `placeholder`، أو `''` إذا لم تكن موجودة.
`read_only`	`bool`	قراءة/كتابة	سمة وجود منطقية تعكس سمة HTML `readonly`.
`autocomplete`	`str`	قراءة/كتابة	قيمة السمة `autocomplete`، أو `''` عندما تكون غير موجودة.
`autofocus`	`bool`	قراءة/كتابة	سمة وجود منطقية تعكس سمة HTML `autofocus`.
`form_action`	`str`	قراءة/كتابة	يعكس سمة `formaction`، أو `''` عند عدم وجودها.
`form_enctype`	`str`	قراءة/كتابة	يعكس سمة `formenctype`، أو `''` عند عدم وجودها.
`form_method`	`str`	قراءة/كتابة	يعكس السمة `formmethod`، أو `''` عندما تكون غير موجودة.
`form_no_validate`	`bool`	قراءة/كتابة	سمة وجود منطقية تعكس `formnovalidate`.
`form_target`	`str`	قراءة/كتابة	يعكس خاصية `formtarget`، أو `''` عندما تكون غير موجودة.
`dirname`	`str`	قراءة/كتابة	يعكس خاصية `dirname`، أو `''` عندما تكون غير موجودة.
`accept`	`str`	قراءة/كتابة	قيمة السمة `accept`، أو `''` عندما تكون غير موجودة.
`size`	`int`	قراءة/كتابة	السمة `size` كعدد صحيح (الإعداد الافتراضي لـ WHATWG: `20`).
`step`	`str`	قراءة/كتابة	قيمة سمة المحتوى `step`، أو `""` عندما تكون غير موجودة.
`min`	`str`	قراءة/كتابة	قيمة سمة المحتوى `min`، أو `""` عندما تكون غير موجودة.
`max`	`str`	قراءة/كتابة	قيمة سمة المحتوى `max`، أو `""` عندما تكون غير موجودة.
`multiple`	`bool`	قراءة/كتابة	خاصية وجود `multiple` من نوع Boolean.
`value_as_number`	`float`	قراءة/كتابة	القيمة الحالية للعنصر كعدد نقطي عائم (WHATWG §4.10.18.6).
`files`	`None`	قراءة	الـ `FileList` لمدخلات اختيار الملف — دائمًا `None` في وضع headless.
`list`	`None`	قراءة	العنصر `<datalist>` المرتبط — دائمًا `None` في هذا الـ stub.
`selection_start`	`int`	قراءة	فهرس بداية النص المحدد (دائمًا `0` في وضع بدون رأس).
`selection_end`	`int`	قراءة	فهرس نهاية النص المحدد (دائمًا `0` في وضع بدون رأس).
`selection_direction`	`str`	قراءة	اتجاه الاختيار (دائمًا `"none"` في وضع بدون رأس).
`indeterminate`	`bool`	قراءة/كتابة	علامة اختيار زمن التنفيذ غير محدد (WHATWG §4.10.18.6.1).
`width`	`int`	قراءة/كتابة	سمة IDL عددية تعكس سمة المحتوى `width`.
`height`	`int`	قراءة/كتابة	سمة IDL عددية تعكس سمة المحتوى `height`.
`will_validate`	`bool`	قراءة	يحصل على `willValidate`.
`form`	`“HTMLElement	None”`	قراءة
`default_checked`	`bool`	قراءة/كتابة	يعكس سمة المحتوى `checked` (الافتراضي للترميز).
`capture`	`str`	قراءة/كتابة	قيمة السمة `capture`، أو `''` عندما تكون غائبة.
`src`	`str`	قراءة/كتابة	يعكس سمة المحتوى `src` (WHATWG HTML §4.10.5.1.3).
`alt`	`str`	قراءة/كتابة	يعكس خاصية المحتوى `alt` (WHATWG HTML §4.10.5.1.3).
`labels`	`"_StaticNodeList"`	قراءة	العناصر المرتبطة بـ `<label>` (قالب بدون رأس: دائمًا فارغ).
`list_`	`None`	قراءة	يعكس سمة `list`؛ دائمًا `None` في وضع بدون رأس.
`value_as_date`	`None`	قراءة/كتابة	يرجع `None` في الوضع بدون رأس (بدون تحليل التاريخ).
`autocorrect`	`str`	قراءة	يعكس سمة المحتوى `autocorrect`.
`incremental`	`bool`	قراءة	يعكس سمة المحتوى `incremental` البوليانية.
`webkitdirectory`	`bool`	قراءة	يعكس سمة المحتوى `webkitdirectory` البوليانية.
`dir_name`	`str`	قراءة/كتابة	IDL snake_case اسم مستعار لـ `dirname` (سمة IDL `dirName`).
`hidden`	`bool`	قراءة/كتابة	ما إذا كان العنصر مخفيًا (يعكس سمة `hidden` المنطقية).
`title`	`str`	قراءة/كتابة	عنوان تلميح الأدوات لهذا العنصر (يعكس الخاصية `title`).
`lang`	`str`	قراءة/كتابة	لغة محتوى العنصر (تعكس الخاصية `lang`).
`tab_index`	`int`	قراءة/كتابة	فهرس ترتيب علامات التبويب لهذا العنصر (يعكس الخاصية `tabindex`).
`access_key`	`str`	قراءة/كتابة	مفتاح الاختصار لهذا العنصر (يعكس `accesskey`

    attribute). |

الطرق

التوقيع	وصف
`set_selection_range(start: int, end: int, direction: str)`	تعيين حدود التحديد (عملية لا تفعل شيئًا في وضع headless).
`select()`	حدد كل محتوى النص (no-op في وضعية headless).
`step_up(n: int)`	نموذج no-op — تعديل الخطوة يتطلب محرك تخطيط (WHATWG HTML §4.10.5.1).
`step_down(n: int)`	نموذج no-op — تعديل الخطوة يتطلب محرك تخطيط (WHATWG HTML §4.10.5.1).
`set_range_text(replacement: str, start: “int	None”, end: “int
`show_picker()`	أطلق `NotSupportedError` — لا واجهة مستخدم في وضع headless.
`click()`	أرسل حدث click اصطناعي إلى هذا العنصر.
`focus(options: “dict	None”)`
`blur()`	أرسل حدث `'blur'` غير متصاعد إلى هذا العنصر.
`show_popover()`	اعرض هذا العنصر كنافذة منبثقة (لا تنفيذ في وضع headless).
`hide_popover()`	إخفاء النافذة المنبثقة لهذا العنصر (لا تنفيذ في وضع headless).
`toggle_popover(force: “bool	None”)`→`bool`
`init(local_name: str, namespace_uri: str	None, prefix: str
`get_computed_style()` → `"ComputedStyleDeclaration"`	إرجاع التصريحات التي تم حلها بالتسلسل في المرحلة الثانية لهذا العنصر.
`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)`	مرر هذا العنصر إلى العرض إذا لم يكن مرئياً بالفعل (لا عملية في وضع بدون رأس).
`set_pointer_capture(pointer_id: int)`	عيّن هذا العنصر كهدف الالتقاط للمؤشر المعطى (لا عملية).
`release_pointer_capture(pointer_id: int)`	أفرج عن التقاط المؤشر للمعرف المعطى للمؤشر (لا عملية).
`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) على هذه المثيلة من HTMLInputElement.
`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 من خلال شجرة الأجداد.

انظر أيضاً

Aspose.HTML for Python — Enterprise API Reference