Class HTMLFormElement

HTMLFormElement class

ملفاستمارة يشتمل العنصر على سلوك مشابه لمجموعة وعنصر. يوفر وصولاً مباشرًا إلى عناصر تحكم النموذج المضمنة بالإضافة إلى سمات عنصر النموذج. راجع تعريف عنصر FORM في HTML 4.01.

انظر أيضانموذج كائن المستند (DOM) المستوى 2 مواصفات HTML .

public class HTMLFormElement : HTMLElement, IHTMLFormElement

الخصائص

اسموصف
AcceptCharset { get; set; }قائمة مجموعات الأحرف التي يدعمها الخادم. راجع تعريف السمة Accept-charset في HTML 4.01.
Action { get; set; }معالج النموذج من جانب الخادم. راجع تعريف سمة الإجراء في HTML 4.01.
override Attributes { get; }خريطة NamedNodeMap تحتوي على سمات هذه العقدة (إذا كانت عنصرًا) أو خالية بخلاف ذلك.
virtual BaseURI { get; }URI الأساسي المطلق لهذه العقدة أو فارغ إذا لم يتمكن التطبيق من الحصول على URI مطلق.
ChildElementCount { get; }إرجاع العدد الحالي لعقد العناصر التي هي عناصر فرعية لهذا العنصر. 0 إذا كان هذا العنصر لا يحتوي على عقد فرعية من نوع العقدة 1.
ChildNodes { get; }قائمة NodeList التي تحتوي على كافة توابع هذه العقدة. إذا لم يكن هناك أطفال ، فهذه قائمة NodeList لا تحتوي على عقد ..
Children { get; }إرجاع العناصر الفرعية للعنصر الحالي.
ClassList { get; }إرجاع قائمة DOMTokenList الحية التي تحتوي على الرموز المميزة المستلمة من تحليل سمة “class” .
ClassName { get; set; }سمة الفئة الخاصة بالعنصر. تمت إعادة تسمية هذه السمة بسبب لتعارضها مع الكلمة الأساسية “class” التي تعرضها العديد من اللغات. راجع تعريف سمة الفئة في HTML 4.01.
Dir { get; set; }يحدد الاتجاه الأساسي للنص المحايد الاتجاهي و اتجاه الجداول. راجع تعريف سمة dir في HTML 4.01.
Elements { get; }إرجاع مجموعة من كافة عناصر التحكم في النموذج في النموذج.
Enctype { get; set; }نوع محتوى النموذج المقدم ، بشكل عام “application / x-www-form-urlencoded”. راجع تعريف سمة enctype في HTML 4.01. لا يتم ضمان تشغيل معالج onsubmit حتى عند استدعاء هذا الأسلوب. السلوك غير متسق لأسباب تاريخية ويجب على المؤلفين عدم الاعتماد على واحد معين.
FirstChild { get; }الطفل الأول لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
FirstElementChild { get; }إرجاع أول عقدة عنصر فرعي لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عناصر فرعية.
Id { get; set; }معرف العنصر. راجع تعريف سمة المعرف في HTML 4.01.
InnerHTML { get; set; }إرجاع جزء من HTML أو XML يمثل محتويات العنصر. يمكن تعيينه لاستبدال محتويات العنصر بالعقد التي تم تحليلها من السلسلة المحددة.
Lang { get; set; }رمز اللغة المحدد في RFC 1766. راجع تعريف سمة lang في HTML 4.01.
LastChild { get; }آخر تابع لهذه العقدة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
LastElementChild { get; }إرجاع آخر عقدة عنصر فرعي لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عناصر فرعية.
Length { get; }عدد عناصر التحكم في النموذج .
override LocalName { get; }إرجاع الجزء المحلي من الاسم المؤهل لهذه العقدة . بالنسبة للعقد من أي نوع بخلاف ELEMENT_NODE و ATTRIBUTE_NODE والعقد التي تم إنشاؤها باستخدام طريقة DOM من المستوى 1 ، مثل Document.createElement () ، يكون هذا دائمًا فارغًا.
Method { get; set; }طريقة HTTP [IETF RFC 2616 تستخدم لتقديم النموذج. راجع تعريف سمة الأسلوب في HTML 4.01.
Name { get; set; }يسمي النموذج.
override NamespaceURI { get; }معرف مساحة الاسم لهذه العقدة ، أو فارغ إذا كانت غير محددة.
NextElementSibling { get; }إرجاع عقدة العنصر الشقيقة التالية لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عقد شقيقة لعنصر تأتي بعد هذا في شجرة المستند.
NextSibling { get; }العقدة التي تلي هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
override NodeName { get; }اسم هذه العقدة حسب نوعها.
override NodeType { get; }رمز يمثل نوع الكائن الأساسي.
virtual NodeValue { get; set; }قيمة هذه العقدة حسب نوعها.
OuterHTML { get; set; }إرجاع جزء من HTML أو XML يمثل العنصر ومحتوياته. يمكن تعيينه لاستبدال العنصر بالعقد التي تم تحليلها من السلسلة المحددة.
virtual OwnerDocument { get; }كائن المستند المرتبط بهذه العقدة. هذا هو أيضًا كائن المستند المستخدم لإنشاء عقد جديدة. عندما تكون هذه العقدة عبارة عن مستند أو نوع مستند لم يتم استخدامه مع أي مستند حتى الآن ، يكون هذا فارغًا.
ParentElement { get; }يحصل على الوالدElement من هذه العقدة.
ParentNode { get; }أصل هذه العقدة. قد يكون لجميع العقد ، باستثناء Attr و Document و DocumentFragment و Entity و Notation ، أصل. ومع ذلك ، إذا تم إنشاء عقدة للتو ولم تتم إضافتها بعد إلى الشجرة ، أو إذا تمت إزالتها من الشجرة ، فسيكون ذلك فارغًا.
override Prefix { get; }بادئة مساحة الاسم لهذه العقدة ، أو فارغة إذا كانت غير محددة. عندما يتم تعريفه على أنه فارغ ، فإن الإعداد ليس له تأثير
PreviousElementSibling { get; }إرجاع عقدة العنصر الشقيقة السابقة لهذا العنصر. خالية إذا كان هذا العنصر لا يحتوي على عقد شقيقة لعنصر تأتي قبل هذا في شجرة الوثيقة.
PreviousSibling { get; }العقدة التي تسبق هذه العقدة مباشرة. إذا لم يكن هناك مثل هذه العقدة ، فإن هذا يعيد قيمة خالية.
SchemaTypeInfo { get; }نوع المعلومات المرتبطة بهذا العنصر .
ShadowRoot { get; }تُرجع shadowRoot المخزنة في هذا العنصر أو تُرجع فارغة إذا كان مغلقًا.
Style { get; }يمثل سمة نمط تسمح للمؤلف بتطبيق معلومات النمط مباشرة على عنصر معين.
TagName { get; }اسم العنصر .
Target { get; set; }إطار لعرض المورد فيه. راجع تعريف السمة الهدف في HTML 4.01.
override TextContent { get; set; }تقوم هذه السمة بإرجاع المحتوى النصي لهذه العقدة وتوابعها. عندما يتم تعريفه على أنه فارغ ، فإن تعيينه ليس له أي تأثير. عند الإعداد ، تتم إزالة أي أطفال محتملين قد تكون هذه العقدة لديهم ، وإذا لم تكن السلسلة الجديدة فارغة أو فارغة ، فسيتم استبدالها بعقدة نصية واحدة تحتوي على السلسلة التي تم تعيين هذه السمة عليها.
Title { get; set; }العنوان الاستشاري للعنصر. راجع تعريف سمة العنوان في HTML 4.01.

طُرق

اسموصف
AddEventListener(string, IEventListener)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, DOMEventHandler, bool)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AddEventListener(string, IEventListener, bool)تسمح هذه الطريقة بتسجيل مستمعي الحدث على هدف الحدث.
AppendChild(Node)يضيف العقدة newChild إلى نهاية قائمة العناصر الفرعية لهذه العقدة. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
AttachShadow(ShadowRootMode)لإنشاء جذر الظل وإرفاقه بالعنصر الحالي.
CloneNode()إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
CloneNode(bool)إرجاع نسخة مكررة من هذه العقدة ، على سبيل المثال ، بمثابة مُنشئ نسخة عام للعقد. لا تحتوي العقدة المكررة على أصل (العقدة الأم خالية) ولا توجد بيانات مستخدم.
DispatchEvent(Event)تسمح هذه الطريقة بإرسال الأحداث إلى نموذج حدث عمليات التنفيذ.
Dispose()تنفيذ مهام محددة بواسطة التطبيق مرتبطة بتحرير الموارد غير المُدارة أو تحريرها أو إعادة تعيينها.
GetAttribute(string)استرداد قيمة سمة بالاسم.
GetAttributeNode(string)استرداد عقدة سمة بالاسم.
GetAttributeNodeNS(string, string)استرداد عقدة Attr بالاسم المحلي ومساحة URI.
GetAttributeNS(string, string)استرداد قيمة سمة حسب الاسم المحلي ومساحة URI.
GetElementsByClassName(string)إرجاع كائن NodeList مباشر يحتوي على جميع العناصر في المستند التي تحتوي على جميع الفئات المحددة في الوسيطة . http://www.w3.org/TR/dom/
GetElementsByTagName(string)إرجاع NodeList لجميع العناصر التابعة مع اسم علامة محدد ، بترتيب المستند.
GetElementsByTagNameNS(string, string)إرجاع NodeList لجميع العناصر التابعة مع اسم محلي محدد ومساحة URI بترتيب المستند.
virtual GetPlatformType()تُستخدم هذه الطريقة لاسترداد كائن ECMAScriptType .
HasAttribute(string)إرجاع صحيح عندما يتم تحديد سمة تحمل اسمًا معينًا في هذا العنصر أو عندما تكون لها قيمة افتراضية ، أو خطأ بخلاف ذلك.
HasAttributeNS(string, string)إرجاع صحيح عندما يتم تحديد سمة ذات اسم محلي ومساحة اسم URI على هذا العنصر أو لها قيمة افتراضية ، خطأ بخلاف ذلك.
override HasAttributes()إرجاع ما إذا كانت هذه العقدة (إذا كانت عنصرًا) لها أي سمات
HasChildNodes()إرجاع ما إذا كان لهذه العقدة أي توابع.
InsertBefore(Node, Node)يقوم بإدراج العقدة قبل تابع العقدة الفرعية الموجودة. إذا كان الطفل فارغًا ، فقم بإدراج العقدة في نهاية قائمة العناصر الفرعية . إذا كان الكائن الفرعي عبارة عن كائن DocumentFragment ، فسيتم إدراج جميع توابعه ، بالترتيب نفسه ، قبل التابع. إذا كان الطفل موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
IsDefaultNamespace(string)يتحقق هذا الأسلوب مما إذا كانت مساحة الاسم المحددة هي مساحة الاسم الافتراضية أم لا.
IsEqualNode(Node)اختبار ما إذا كانت العقدتان متساويتان. تختبر هذه الطريقة المساواة بين العقد ، وليس التماثل (أي ما إذا كانت العقدتان مرجعيتان لنفس الكائن) والتي يمكن اختبارها باستخدام Node.isSameNode (). جميع العقد التي هي نفسها ستكون متساوية أيضًا ، على الرغم من أن العكس قد لا يكون صحيحًا.
IsSameNode(Node)إرجاع ما إذا كانت هذه العقدة هي نفس العقدة المحددة. توفر هذه الطريقة طريقة لتحديد ما إذا كان مرجعان للعقدة يتم إرجاعهما بواسطة مرجع التطبيق نفس الكائن. عندما يكون مراجعان للعقدة مراجع لنفس الكائن ، حتى لو كان ذلك من خلال وكيل ، يمكن استخدام المراجع بشكل تبادلي تمامًا ، بحيث يكون لجميع السمات نفس القيم واستدعاء نفس طريقة DOM على أي مرجع يكون له نفس التأثير دائمًا.
LookupNamespaceURI(string)ابحث عن مساحة الاسم URI المرتبطة بالبادئة المحددة ، بدءًا من هذه العقدة.
LookupPrefix(string)ابحث عن البادئة المرتبطة بمساحة الاسم المحددة URI ، بدءًا من هذه العقدة. يتم تجاهل تعريفات مساحة الاسم الافتراضية بهذه الطريقة. راجع بحث بادئة مساحة الاسم للحصول على تفاصيل حول الخوارزمية المستخدمة بواسطة هذه الطريقة.
Normalize()وضع جميع العقد النصية في العمق الكامل للشجرة الفرعية أسفل هذه العقدة ، بما في ذلك عقد السمات ، في نموذج “عادي” حيث تفصل البنية فقط (على سبيل المثال ، العناصر والتعليقات وتعليمات المعالجة وأقسام CDATA ومراجع الكيانات) النص العقد ، أي لا توجد عقد نصية متجاورة ولا عقد نصية فارغة. يمكن استخدام هذا للتأكد من أن عرض DOM للمستند هو نفسه كما لو تم حفظه وإعادة تحميله ، ويكون مفيدًا عندما تكون العمليات (مثل عمليات بحث XPointer [XPointer]) التي تعتمد على بنية شجرة وثيقة معينة يستخدم. إذا كانت المعلمة “تطبيع الأحرف” لكائن DOMConfiguration المرفقة بـ Node.ownerDocument صحيحة ، فإن هذه الطريقة ستعمل أيضًا على تسوية أحرف العقد النصية بشكل كامل.
QuerySelector(string)إرجاع العنصر الأول في المستند الذي يتطابق مع selector
QuerySelectorAll(string)إرجاع قائمة NodeList لجميع العناصر الموجودة في المستند ، والتي تطابق selector
Remove()يزيل هذا المثيل.
RemoveAttribute(string)يزيل سمة بالاسم .
RemoveAttributeNode(Attr)يزيل عقدة السمة المحددة.
RemoveAttributeNS(string, string)يزيل سمة حسب الاسم المحلي ومساحة URI.
RemoveChild(Node)يزيل العقدة الفرعية التي أشار إليها oldChild من قائمة الأطفال ، ويعيدها .
RemoveEventListener(string, IEventListener)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, DOMEventHandler, bool)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
RemoveEventListener(string, IEventListener, bool)تسمح هذه الطريقة بإزالة مستمعي الحدث من هدف الحدث. إذا كانIEventListener تمت إزالته من ملفEventTarget أثناء معالجة حدث ، لن يتم تشغيله من خلال الإجراءات الحالية. لا يمكن استدعاء مستمعي الأحداث بعد إزالتها.
ReplaceChild(Node, Node)يستبدل العقدة الفرعية oldChild بـ newChild في قائمة الأطفال ، ويعيد العقدة oldChild. إذا كان newChild هو كائن DocumentFragment ، فسيتم استبدال oldChild بكافة العناصر الفرعية DocumentFragment ، والتي يتم إدراجها بنفس الترتيب. إذا كان الطفل الجديد موجودًا بالفعل في الشجرة ، فسيتم إزالته أولاً.
Reset()يستعيد القيم الافتراضية لعنصر النموذج. يقوم بنفس الإجراء كزر إعادة تعيين.
SetAttribute(string, string)إضافة سمة جديدة. إذا كانت السمة التي تحمل هذا الاسم موجودة بالفعل في العنصر ، فسيتم تغيير قيمتها لتصبح قيمة معلمة القيمة
SetAttributeNode(Attr)إضافة عقدة سمة جديدة. إذا كانت السمة بهذا الاسم (nodeName) موجودة بالفعل في العنصر ، فسيتم استبدالها بالسمة الجديدة.
SetAttributeNodeNS(Attr)إضافة سمة جديدة. إذا كانت هناك سمة بهذا الاسم المحلي ومساحة URI موجودة بالفعل في العنصر ، فسيتم استبدالها بالسمة الجديدة.
SetAttributeNS(string, string, string)إضافة سمة جديدة. إذا كانت سمة تحمل نفس الاسم المحلي ومساحة URI موجودة بالفعل على العنصر ، فسيتم تغيير بادئتها لتكون جزء البادئة من الاسم المؤهل ، ويتم تغيير قيمتها لتكون معلمة القيمة.
SetIdAttribute(string, bool)إذا كانت المعلمة isId صحيحة ، فإن هذه الطريقة تعلن أن السمة المحددة هي سمة معرف يحددها المستخدم.
SetIdAttributeNode(Attr, bool)إذا كانت المعلمة isId صحيحة ، فإن هذه الطريقة تعلن أن السمة المحددة هي سمة معرف يحددها المستخدم.
SetIdAttributeNS(string, string, bool)إذا كانت المعلمة isId صحيحة ، فإن هذه الطريقة تعلن أن السمة المحددة هي سمة معرف يحددها المستخدم.
Submit()يرسل النموذج. يؤدي نفس الإجراء مثل زر الإرسال.
override ToString()إرجاع أString الذي يمثل هذا المثال.

الأحداث

اسموصف
event OnAbortالحصول على معالج الحدث أو تعيينه لحدث OnAbort.
event OnBlurالحصول على معالج الحدث أو تعيينه لحدث OnBlur.
event OnCancelالحصول على أو تعيين معالج الأحداث لحدث OnCancel.
event OnCanplayالحصول على معالج الحدث أو تعيينه لحدث OnCanplay.
event OnCanPlayThroughالحصول على معالج الحدث أو تعيينه لحدث OnCanPlayThrough.
event OnChangeالحصول على معالج الحدث لحدث OnChange أو تعيينه.
event OnClickالحصول على معالج الحدث لحدث OnClick أو تعيينه.
event OnCueChangeالحصول على معالج الحدث أو تعيينه لحدث OnCueChange.
event OnDblClickالحصول على أو تعيين معالج الأحداث لحدث OnDblClick.
event OnDurationChangeالحصول على معالج الحدث لحدث OnDurationChange أو تعيينه.
event OnEmptiedالحصول على أو تعيين معالج الأحداث لحدث OnEmptied.
event OnEndedالحصول على معالج الأحداث أو تعيينه لحدث OnEnded.
event OnErrorالحصول على معالج الحدث لحدث OnError أو تعيينه.
event OnFocusالحصول على أو تعيين معالج الأحداث لحدث OnFocus.
event OnInputالحصول على أو تعيين معالج الأحداث لحدث OnInput.
event OnInvalidالحصول على معالج الحدث أو تعيينه لحدث OnInvalid .
event OnKeyDownالحصول على معالج الحدث أو تعيينه لحدث OnKeyDown.
event OnKeyPressالحصول على معالج الحدث أو تعيينه لحدث OnKeyPress.
event OnKeyUpالحصول على معالج الحدث أو تعيينه لحدث OnKeyUp.
event OnLoadالحصول على معالج الحدث أو تعيينه لحدث OnLoad.
event OnLoadedDataالحصول على معالج الحدث أو تعيينه لحدث OnLoadedData.
event OnLoadedMetadataالحصول على معالج الحدث لحدث OnLoadedMetadata أو تعيينه.
event OnLoadStartالحصول على أو تعيين معالج الأحداث لحدث OnLoadStart.
event OnMouseDownالحصول على معالج الحدث أو تعيينه لحدث OnMouseDown.
event OnMouseEnterالحصول على معالج الحدث أو تعيينه لحدث OnMouseEnter.
event OnMouseLeaveالحصول على معالج الأحداث أو تعيينه لحدث OnMouseLeave.
event OnMouseMoveالحصول على معالج الحدث أو تعيينه لحدث OnMouseMove.
event OnMouseOutالحصول على معالج الحدث أو تعيينه لحدث OnMouseOut.
event OnMouseOverالحصول على معالج الحدث أو تعيينه لحدث OnMouseOver.
event OnMouseUpالحصول على معالج الحدث أو تعيينه لحدث OnMouseUp.
event OnMouseWheelالحصول على معالج الحدث أو تعيينه لحدث OnMouseWheel.
event OnPauseالحصول على معالج الحدث أو تعيينه لحدث OnPause.
event OnPlayالحصول على معالج الحدث أو تعيينه لحدث OnPlay.
event OnPlayingالحصول على معالج الحدث أو تعيينه لحدث OnPlaying.
event OnProgressالحصول على معالج الحدث أو تعيينه لحدث OnProgress .
event OnRateChangeالحصول على معالج الحدث لحدث OnRateChange أو تعيينه.
event OnResetالحصول على معالج الحدث لحدث OnReset أو تعيينه.
event OnResizeالحصول على معالج الحدث لحدث OnResize أو تعيينه.
event OnScrollالحصول على أو تعيين معالج الأحداث لحدث OnScroll.
event OnSeekedالحصول على معالج الحدث لحدث OnSeeked أو تعيينه.
event OnSeekingالحصول على معالج الحدث لحدث OnSeeking أو تعيينه.
event OnSelectالحصول على معالج الحدث لحدث OnSelect أو تعيينه.
event OnShowالحصول على معالج الحدث لحدث OnShow أو تعيينه.
event OnStalledالحصول على معالج الحدث للحدث OnStalled أو تعيينه.
event OnSubmitالحصول على معالج الحدث أو تعيينه لحدث OnSubmit.
event OnSuspendالحصول على معالج الحدث أو تعيينه لحدث OnSuspend.
event OnTimeUpdateالحصول على أو تعيين معالج الأحداث لحدث OnTimeUpdate.
event OnToggleالحصول على أو تعيين معالج الأحداث لحدث OnToggle.
event OnVolumeChangeالحصول على معالج الحدث لحدث OnVolumeChange أو تعيينه.
event OnWaitingالحصول على معالج الحدث للحدث OnWaiting أو تعيينه.

أنظر أيضا