الفرق بين المراجعتين لصفحة: «HTML/article»

من موسوعة حسوب
ط استبدال النص - ':(Content sectioning|Edits|Embedded content|Forms|Inline text semantics|Input Types|Interactive elements|Main Root|Metadata|Multimedia|Scripting|Table|Text Content)' ب':HTML $1'
إضافة قسمين ومثالين
 
سطر 2: سطر 2:
يُمثِّل العنصر <code><article></code> جزءًا من المستند أو الصفحة أو التطبيق أو الموقع الغرض منها هو القدرة على إعادة توزيعها واستخدامها بشكل مستقل، مثل موضوع في منتدى أو مقالة في صحيفة أو تدوينة.
يُمثِّل العنصر <code><article></code> جزءًا من المستند أو الصفحة أو التطبيق أو الموقع الغرض منها هو القدرة على إعادة توزيعها واستخدامها بشكل مستقل، مثل موضوع في منتدى أو مقالة في صحيفة أو تدوينة.
مثال عن استخدام عناصر <code><article></code> لتمثيل محتوى المنشور ولتمثيل التعليقات، ويبين هذا المثال كيف يستعمل العنصر <code><article></code> مع بقية عناصر HTML:<syntaxhighlight lang="html">
مثال عن استخدام عناصر <code><article></code> لتمثيل محتوى المنشور ولتمثيل التعليقات، ويبين هذا المثال كيف يستعمل العنصر <code><article></code> مع بقية عناصر HTML:<syntaxhighlight lang="html">
<article class="film_review">
<article>
   <header>
   <h1>موسوعة حسوب</h1>
    <h2>Jurassic Park</h2>
   <p>تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. تعتمد الموسوعة على فريق من المحررين والمساهمين المتطوعين أولي الخبرة البرمجية واللغوية، وترحّب بكل من يرغب بالمساهمة فيها. اعرف المزيد عن موسوعة حسوب بتصفح محتواها واطلع على دليل المساهمين.</p>
   </header>
  <section class="main_review">
    <p>Dinos were great!</p>
  </section>
  <section class="user_reviews">
    <article class="user_review">
      <p>Way too scary for me.</p>
      <footer>
        <p>
          Posted on
          <time datetime="2017-05-16 19:00">May 16</time>
          by Lisa.
        </p>
      </footer>
    </article>
    <article class="user_review">
      <p>I agree, dinos are my favorite.</p>
      <footer>
        <p>
          Posted on
          <time datetime="2017-05-17 19:00">May 17</time>
          by Tom.
        </p>
      </footer>
    </article>
  </section>
  <footer>
    <p>
      Posted on
      <time datetime="2017-05-15 19:00">May 15</time>
      by Staff.
    </p>
  </footer>
</article>
</article>
</syntaxhighlight>
</syntaxhighlight>


== بطاقة العنصر ==
{| class="wikitable" style="width: 100%;"
{| class="wikitable" style="width: 100%;"
|-
|-
سطر 82: سطر 50:
*يمكن توفير معلومات الكاتب ضمن عنصر <code><article></code> عبر العنصر <code>[[HTML/address|<address>]]</code>، لكن هذه المعلومات لن تُطبَّق على عناصر <code><article></code> المتشعبة داخل العنصر الأب.
*يمكن توفير معلومات الكاتب ضمن عنصر <code><article></code> عبر العنصر <code>[[HTML/address|<address>]]</code>، لكن هذه المعلومات لن تُطبَّق على عناصر <code><article></code> المتشعبة داخل العنصر الأب.
*يمكن وصف تاريخ ووقت النشر في عنصر <code><article></code> عبر استخدام الخاصية <code>datetime</code> التابعة للعنصر <code>[[HTML/time|<nowiki><time></nowiki>]]</code>.
*يمكن وصف تاريخ ووقت النشر في عنصر <code><article></code> عبر استخدام الخاصية <code>datetime</code> التابعة للعنصر <code>[[HTML/time|<nowiki><time></nowiki>]]</code>.
== أمثلة ==
مثال موسَّع يوضِّح كيفية استعمال العنصر <code><article></code> وداخله عناصر متشعبة مختلفة مثل <code>[[HTML/section|<section>]]</code> (والذي يحتوي بدوره على عناصر <code>[[HTML/article|<article>]]</code> أخرى)، وكيفية وصف وقت النشر باستخدام العنصر <code>[[HTML/time|<nowiki><time></nowiki>]]</code> (الذي يمكن أن يوجد داخل تذييل <code>[[HTML/footer|<footer>]]</code>):<syntaxhighlight lang="html">
<article>
  <h1>التفاح</h1>
  <section>
    <h2>أصناف التفاح</h2>
    <p>فقرة أو فقرات تشرح أنواع التفاح المختلفة</p>
  </section>
  <section>
    <article>
      <h2>تعليق لبروفيسور في علم النبات</h2>
      <p>فقرة توضِّح رأي البروفيسور</p>
      <footer>
        <p>
          نشر في
          <time datetime="2017-05-16 19:00">16 أيار/مايو</time>
        </p>
      </footer>
    </article>
    <article class="user_review">
      <h2>رأينا في تعليق البروفيسور</h2>
      <p>فقرة نوضح فيها رأينا فيما قاله البروفيسور</p>
      <time datetime="2017-05-17 19:00"></time>
    </article>
  </section>
  <footer>
    <p>
      نشر المقال في
      <time datetime="2017-05-15 19:00">20 أيار/مايو</time> من قبل عبد اللطيف.
    </p>
  </footer>
</article>
</syntaxhighlight>
== التنسيق الافتراضي ==
تعرض أغلبية المتصفحات العنصر <code><article></code> مع ضبط الخاصية <code>[[CSS/display|display]]</code> إلى <code>block</code>:<syntaxhighlight lang="css">
article {
  display: block;
}
</syntaxhighlight>
==مصادر ومواصفات==
==مصادر ومواصفات==
*معيار [https://html.spec.whatwg.org/multipage/semantics.html#the-article-element HTML Living Standard].
*معيار [https://html.spec.whatwg.org/multipage/semantics.html#the-article-element HTML Living Standard].

المراجعة الحالية بتاريخ 14:03، 17 فبراير 2018

يُمثِّل العنصر <article> جزءًا من المستند أو الصفحة أو التطبيق أو الموقع الغرض منها هو القدرة على إعادة توزيعها واستخدامها بشكل مستقل، مثل موضوع في منتدى أو مقالة في صحيفة أو تدوينة.

مثال عن استخدام عناصر <article> لتمثيل محتوى المنشور ولتمثيل التعليقات، ويبين هذا المثال كيف يستعمل العنصر <article> مع بقية عناصر HTML:

<article>
  <h1>موسوعة حسوب</h1>
  <p>تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. تعتمد الموسوعة على فريق من المحررين والمساهمين المتطوعين أولي الخبرة البرمجية واللغوية، وترحّب بكل من يرغب بالمساهمة فيها. اعرف المزيد عن موسوعة حسوب بتصفح محتواها واطلع على دليل المساهمين.</p>
</article>

بطاقة العنصر

تصنيفات المحتوى عنصر تنظيمي.
المحتوى المسموح المحتوى التنظيمي.
الوسم المختصر لا يمكن حذف أيّ من وسمَي البداية أو النهاية.
العناصر الأب أي عنصر يقبل المحتوى التنظيمي.

لاحظ أنَّ العنصر <article> لا يجوز أن يكون ابنًا للعنصر <address>.

واجهة DOM HTMLElement

دعم المتصفحات

Chrome Firefox Edge Safari Opera
5 4.0 مدعوم 4.1 11.10

الخاصيات

يمكن استخدام الخاصيات العامة في هذا العنصر.

ملاحظات الاستخدام

  • يجب أن يكون كل عنصر <article> مُعرَّفًا (identified)، ويتم ذلك عمومًا بتضمين ترويسة (العناصر <h1>‏-<h6>) ضمن العنصر <article>.
  • عند استخدام أكثر من عنصر <article> داخل بعضها، فالعنصر الداخلي يُمثِّل مقالًا متعلقًا بالعنصر الأب، فمثلًا تكون التعليقات على تدوينة ما محتواةً ضمن عناصر <article> والموجودة ضمن عنصر <article> الذي يمثِّل التدوينة نفسها.
  • يمكن توفير معلومات الكاتب ضمن عنصر <article> عبر العنصر <address>، لكن هذه المعلومات لن تُطبَّق على عناصر <article> المتشعبة داخل العنصر الأب.
  • يمكن وصف تاريخ ووقت النشر في عنصر <article> عبر استخدام الخاصية datetime التابعة للعنصر <time>.

أمثلة

مثال موسَّع يوضِّح كيفية استعمال العنصر <article> وداخله عناصر متشعبة مختلفة مثل <section> (والذي يحتوي بدوره على عناصر <article> أخرى)، وكيفية وصف وقت النشر باستخدام العنصر <time> (الذي يمكن أن يوجد داخل تذييل <footer>):

<article>
  <h1>التفاح</h1>
  <section>
    <h2>أصناف التفاح</h2>
    <p>فقرة أو فقرات تشرح أنواع التفاح المختلفة</p>
  </section>
  <section>
    <article>
      <h2>تعليق لبروفيسور في علم النبات</h2>
      <p>فقرة توضِّح رأي البروفيسور</p>
      <footer>
        <p>
          نشر في
          <time datetime="2017-05-16 19:00">16 أيار/مايو</time>
        </p>
      </footer>
    </article>
    <article class="user_review">
      <h2>رأينا في تعليق البروفيسور</h2>
      <p>فقرة نوضح فيها رأينا فيما قاله البروفيسور</p>
      <time datetime="2017-05-17 19:00"></time>
    </article>
  </section>
  <footer>
    <p>
      نشر المقال في
      <time datetime="2017-05-15 19:00">20 أيار/مايو</time> من قبل عبد اللطيف.
    </p>
  </footer>
</article>

التنسيق الافتراضي

تعرض أغلبية المتصفحات العنصر <article> مع ضبط الخاصية display إلى block:

article {
  display: block;
}

مصادر ومواصفات