العنصر <dl>

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

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

بطاقة العنصر

تصنيفات المحتوى لا يوجد.
المحتوى المسموح مجموعة أو أكثر من عناصر <dt> متبوعة بعنصر <dd> واحد أو أكثر؛ ويُسمَح باستخدام العنصر <div> فيه.
الوسم المختصر لا يمكن حذف أيّ من وسمَي البداية أو النهاية.
العناصر الأب أي عنصر يقبل المحتوى التنظيمي.
واجهة DOM HTMLDListElement

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

Chrome Firefox Edge Safari Opera
مدعوم مدعوم مدعوم مدعوم مدعوم

الخاصيات

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

ملاحظات

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

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

أمثلة

مصطلح وحيد وشرحٌ عنه

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

عدِّة مصطلحات وشرحٌ وحيدٌ عنها

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

مصطلحٌ وحيد وأكثر من شرح عنه

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

أكثر من مصطلح ويرتبط بكل مصطلح شرحٌ خاصٌ

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

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

وضع كل مصطلح وشرحه ضمن عنصر <div>

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

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

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

تعرض أغلبية المتصفحات العنصر <dl> مع ضبط الخاصية display إلى block، والهوامش العلوية (margin-top) والسفلية (margin-bottom) إلى 1em، والهامش اليساري (margin-left) واليميني (margin-right) إلى 0:
dl {
  display: block;
  margin-top: 1em;
  margin-bottom: 1em;
  margin-left: 0;
  margin-right: 0;
}

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