dom

يستضيف هذا المستودع معيار DOM.

مدونة لقواعد السلوك

نحن ملتزمون بتوفير بيئة ودية وآمنة ومرحبة للجميع. يرجى قراءة واحترام قواعد السلوك.

فرص المساهمة

يلاحظ الأشخاص مشكلات بسيطة وكبيرة في DOM Standard طوال الوقت ونود مساعدتك في إصلاحها. نرحب أيضًا بطلبات السحب الخاصة بالأخطاء المطبعية والنحوية.

تعد الإصدارات التي تحمل عنوان "الإصدار الأول الجيد" مكانًا جيدًا للتعرف على كيفية تحرير معيار DOM. لاحظ أننا لا نقوم بتعيين المشكلات وليس هناك سبب لطلب التوفر أيضًا، ما عليك سوى تقديم طلب سحب.

إذا كنت تفكر في اقتراح ميزة جديدة، فاقرأ مستندات الأسئلة الشائعة ووضع العمل لتتعرف على العملية.

سنكون سعداء بمساعدتك في كل هذا عبر الدردشة.

سحب الطلبات

باختصار، قم بتغيير dom.bs وأرسل التصحيح الخاص بك، مع رسالة التزام جيدة.

الرجاء إضافة اسمك إلى قسم الشكر والتقدير في طلب السحب الأول، حتى بالنسبة للإصلاحات التافهة. يتم فرز الأسماء معجميا.

للتأكد من أن التصحيح الخاص بك يلبي جميع المتطلبات الضرورية، يرجى أيضًا مراجعة إرشادات المساهمين. من المتوقع أن يتبع محررو معيار DOM إرشادات المشرف.

الاختبارات

تعد الاختبارات جزءًا أساسيًا من عملية التقييس ويجب إنشاؤها أو تعديلها عند إجراء تغييرات على المعيار. يمكن العثور على اختبارات معيار DOM في دليل dom/ الخاص بـ web-platform-tests/wpt .

يمكن رؤية لوحة المعلومات التي تعرض الاختبارات الجارية ضد محركات المتصفح على wpt.fyi/results/dom.

البناء "محلياً"

للتكرار المحلي السريع، قم بتشغيل make ; سيؤدي هذا إلى استخدام خدمة ويب لإنشاء المعيار، بحيث لا يتعين عليك تثبيت أي شيء. شاهد المزيد في إرشادات المساهمين.

التنسيق

استخدم عرض عمود يبلغ 100 حرف.

لا تستخدم الأسطر الجديدة داخل العناصر "المضمّنة"، حتى لو كان ذلك يعني تجاوز متطلبات عرض العمود.

 < p > The
< dfn method for = DOMTokenList lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > &hellip;) </ code > </ dfn >
method, when invoked, must run these steps:

على ما يرام و

 < p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > &hellip;) </ code > </ dfn > method, when
invoked, must run these steps:

ليس كذلك.

يُحظر أيضًا استخدام الأسطر الجديدة بين أسماء علامات العناصر "المضمنة" ومحتواها. (وهذا في الواقع يغير المحتوى، عن طريق إضافة مسافات.) هذا هو

 < a > token </ a >

بخير و

 < a > token
</ a >

ليس كذلك.

يحتوي العنصر <li> دائمًا على عنصر <p> بداخله، إلا إذا كان فرعًا للعنصر <ul class=brief> .

إذا كان عنصر "كتلة" يحتوي على عنصر "كتلة" واحد، فلا تضعه في سطر جديد.

لا تضع مسافة بادئة لأي شيء باستثناء عنصر "كتلة" جديد. على سبيل المثال

 < li > < p > For each < var > token </ var > in < var > tokens </ var > , in given order, that is not in
 < a > tokens </ a > , append < var > token </ var > to < a > tokens </ a > .

ليست مسافة بادئة، ولكن

 < ol >
 < li >
  < p > For each < var > token </ var > in < var > tokens </ var > , run these substeps:

  < ol >
   < li > < p > If < var > token </ var > is the empty string, < a > throw </ a > a {{SyntaxError}} exception.

يكون.

قد يتم تضمين علامات النهاية (إذا تم ذلك بشكل متسق) وقد يتم اقتباس السمات (باستخدام علامات الاقتباس المزدوجة)، على الرغم من أن الموضوع السائد هو حذف علامات النهاية وعدم اقتباس السمات (ما لم تحتوي على مسافة).

ضع سطرًا جديدًا واحدًا بين الفقرات (بما في ذلك عناصر القائمة). ضع ثلاثة أسطر جديدة قبل <h2> ، وسطرين جديدين قبل العناوين الأخرى. لا ينطبق هذا عندما يتبع العنوان المتداخل العنوان الأصلي.

 < ul >
 < li > < p > Do not place a newline above.

 < li > < p > Place a newline above.
</ ul >

< p > Place a newline above.


< h3 > Place two newlines above. </ h3 >

< h4 > Placing one newline is OK here. </ h4 >


< h4 > Place two newlines above. </ h4 >

استخدم حالة الجمل لأسماء المتغيرات والأسماء "المتباعدة" للتعريفات والخوارزميات وما إلى ذلك.

 < p > A < a for = / > request </ a > has an associated
< dfn export for = request id = concept-request-redirect-mode > redirect mode </ dfn > ,...

 < p > Let < var > redirectMode </ var > be < var > request </ var > 's < a for = request > redirect mode </ a > .