عرض مصدر HTML/dl

<noinclude>{{DISPLAYTITLE:العنصر <code><dl></code>}}</noinclude>
يُمثِّل العنصر <code><nowiki><dl></nowiki></code> قائمة وصف (description list)، وهذا العنصر يتضمن مجموعةً من المصطلحات وشرحها. يستخدم هذا العنصر عادةً في القواميس أو شرح المصطلحات، أو لعرض البيانات الوصفية (قائمة من أزواج «مفاتيح-قيم»).

== بطاقة العنصر ==
{| class="wikitable" style="width: 100%;"
|-
! scope="row" style="width: 20%;" | تصنيفات المحتوى
| لا يوجد.
|-
! scope="row" | المحتوى المسموح
| مجموعة أو أكثر من عناصر <code>[[HTML/dt|<nowiki><dt></nowiki>]]</code> متبوعة بعنصر [[HTML/dd|<nowiki><dd></nowiki>]] واحد أو أكثر؛ ويُسمَح باستخدام العنصر <code>[[HTML/div|<nowiki><div></nowiki>]]</code> فيه.
|-
! scope="row" | الوسم المختصر
| لا يمكن حذف أيّ من وسمَي البداية أو النهاية.
|-
! scope="row" | العناصر الأب
| أي عنصر يقبل المحتوى التنظيمي.
|-
! scope="row" | واجهة DOM
| <code>HTMLDListElement</code>
|}

== دعم المتصفحات ==
{| class="wikitable" style="width: 50%;"
 !| Chrome
 ! Firefox
 ! Edge
 ! Safari
 ! Opera
|-
|مدعوم
|مدعوم
|مدعوم
|مدعوم
|مدعوم
|}
== الخاصيات ==
يمكن استخدام [[HTML/Global Attributes|الخاصيات العامة]] في هذا العنصر.

== ملاحظات ==
لا تستعمل هذا العنصر (ولا عنصر <code>[[HTML/ul|<nowiki><ul></nowiki>]]</code>) لمحاذاة بعض عناصر الصفحة، وعلى الرغم من أنَّ ذلك قابل للتطبيق، لكن لا ينصح بذلك وسيؤدي ذلك إلى فقدان معنى هذا العنصر.

لتغيير محاذاة محتوى عنصر <code><nowiki><dl></nowiki></code> فاستخدم خاصية <code>margin</code> في لغة [[CSS]].

== أمثلة ==

=== مصطلح وحيد وشرحٌ عنه ===
هذا مثالٌ عن قائمة وصف فيها مصطلح وحيد وشرحٌ عنه:<syntaxhighlight lang="html">
<dl>
  <dt>موسوعة حسوب</dt>
  <dd>
    تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. تعتمد الموسوعة على فريق من المحررين والمساهمين المتطوعين أولي الخبرة البرمجية واللغوية، وترحّب بكل من يرغب بالمساهمة فيها. اعرف المزيد عن موسوعة حسوب بتصفح محتواها واطلع على دليل المساهمين.
  </dd>
  <!-- تعاريف أخرى -->
</dl>
</syntaxhighlight>

=== عدِّة مصطلحات وشرحٌ وحيدٌ عنها ===
هذا مثالٌ عن قائمة وصف فيها عدِّة مصطلحات وشرحٌ وحيدٌ عنها:<syntaxhighlight lang="html">
<dl>
  <dt>موسوعة حسوب</dt>
  <dt>Hsoub Wiki</dt>
  <dd>
    تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. تعتمد الموسوعة على فريق من المحررين والمساهمين المتطوعين أولي الخبرة البرمجية واللغوية، وترحّب بكل من يرغب بالمساهمة فيها. اعرف المزيد عن موسوعة حسوب بتصفح محتواها واطلع على دليل المساهمين.
  </dd>
  <!-- تعاريف أخرى -->
</dl>

</syntaxhighlight>

=== مصطلحٌ وحيد وأكثر من شرح عنه ===
هذا مثالٌ عن قائمة وصف فيها مصطلحٌ وحيد وأكثر من شرح عنه:<syntaxhighlight lang="html">
<dl>
  <dt>موسوعة حسوب</dt>
  <dd>
    تهدف موسوعة حسوب لتوفير توثيق عربي كامل وعالي الجودة، مدعّم بالأمثلة لمختلف لغات البرمجة وتقنيات تطوير الويب والجوال. تعتمد الموسوعة على فريق من المحررين والمساهمين المتطوعين أولي الخبرة البرمجية واللغوية، وترحّب بكل من يرغب بالمساهمة فيها. اعرف المزيد عن موسوعة حسوب بتصفح محتواها واطلع على دليل المساهمين.
  </dd>
  <dd>
    موسوعة حسوب هي جزءٌ من البرنامج التعليمي الذي تقوده شركة حسوب.
  </dd>
  <!-- تعاريف أخرى -->
</dl>
</syntaxhighlight>

=== أكثر من مصطلح ويرتبط بكل مصطلح شرحٌ خاصٌ ===
هذا مثالٌ عن قائمة وصف فيها أكثر من مصطلح ويرتبط بكل مصطلح شرحٌ خاصٌ به:<syntaxhighlight lang="html">
<dl>
  <dt>القهوة</dt>
  <dd>مشروب ساخن أسود</dd>
  
  <dt>الحليب</dt>
  <dd>مشروب بارد أبيض</dd>

  <dt>اليانسون</dt>
  <dd>مشروب ساخن أخضر</dd>
  
  <!-- تعاريف أخرى -->
</dl>
</syntaxhighlight>قد تستفيد أحيانًا من تعريف فاصل بين المصطلح وشرحه، وذلك عبر CSS، مثلًا:<syntaxhighlight lang="css">
dt::after {
  content: ": ";
}
</syntaxhighlight>

=== وضع كل مصطلح وشرحه ضمن عنصر <code>[[HTML/div|<nowiki><div></nowiki>]]</code> ===
أما هذا المثال فهو عن قائمة الوصف السابقة لكن مع وضع كل مصطلح وشرحه ضمن عنصر <code>[[HTML/div|<nowiki><div></nowiki>]]</code>:<syntaxhighlight lang="html">
<dl>
  <div>
    <dt>القهوة</dt>
    <dd>مشروب ساخن أسود</dd>
  </div>
  
  <div>
    <dt>الحليب</dt>
    <dd>مشروب بارد أبيض</dd>
  </div>

  <div>
    <dt>اليانسون</dt>
    <dd>مشروب ساخن أخضر</dd>
  </div>
  
    <!-- تعاريف أخرى -->
</dl>
</syntaxhighlight>

== التنسيق الافتراضي ==
تعرض أغلبية المتصفحات العنصر <code><nowiki><dl></nowiki></code> مع ضبط الخاصية <code>[[CSS/display|display]]</code> إلى <code>block</code>، والهوامش العلوية (<code>[[CSS/margin-top|margin-top]]</code>) والسفلية (<code>[[CSS/margin-bottom|margin-bottom]]</code>) إلى <code>1em</code>، والهامش اليساري (<code>[[CSS/margin-left|margin-left]]</code>) واليميني (<code>[[CSS/margin-right|margin-right]]</code>) إلى <code>0</code>:<syntaxhighlight lang="css">
dl {
  display: block;
  margin-top: 1em;
  margin-bottom: 1em;
  margin-left: 0;
  margin-right: 0;
}
</syntaxhighlight>

==مصادر ومواصفات==
*معيار [https://html.spec.whatwg.org/multipage/semantics.html#the-dl-element HTML Living Standard].
*مواصفة [http://www.w3.org/TR/html5/grouping-content.html#the-dl-element HTML5].
*مواصفة [http://www.w3.org/TR/html401/struct/lists.html#h-10.3 HTML 4.01].
[[تصنيف:HTML|{{SUBPAGENAME}}]]
[[تصنيف:HTML Elements|{{SUBPAGENAME}}]]
[[تصنيف:HTML Text Content|{{SUBPAGENAME}}]]