Description lists in HTML

Introduction

Description lists help organize pairs of terms and their explanations clearly on a webpage.

Listing glossary terms with their definitions.

Showing questions and answers in a FAQ section.

Displaying product features with descriptions.

Presenting metadata like names and values in a profile.

Syntax

HTML

<dl>
  <dt>Term</dt>
  <dd>Description of the term.</dd>
</dl>

<dl> wraps the whole list.

<dt> is for the term or name.

<dd> is for the description or details.

Examples

Multiple terms with their descriptions in one list.

HTML

<dl>
  <dt>HTML</dt>
  <dd>Language for web pages.</dd>
  <dt>CSS</dt>
  <dd>Styles web pages.</dd>
</dl>

One term with multiple descriptions.

HTML

<dl>
  <dt>JavaScript</dt>
  <dd>A programming language for the web.</dd>
  <dd>Used to make pages interactive.</dd>
</dl>

Simple single term and description.

HTML

<dl>
  <dt>FAQ</dt>
  <dd>Frequently Asked Questions.</dd>
</dl>

Sample Program

This example shows a description list with three web terms and their explanations. It uses semantic HTML and simple styling for clarity and accessibility.

HTML

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Description List Example</title>
  <style>
    body {
      font-family: Arial, sans-serif;
      padding: 1rem;
      max-width: 600px;
      margin: auto;
    }
    dl {
      background-color: #f9f9f9;
      border: 1px solid #ccc;
      padding: 1rem;
      border-radius: 0.5rem;
    }
    dt {
      font-weight: bold;
      margin-top: 1rem;
      color: #2a2a2a;
    }
    dd {
      margin-left: 1.5rem;
      margin-bottom: 0.5rem;
      color: #555;
    }
  </style>
</head>
<body>
  <h1>Web Development Terms</h1>
  <dl aria-label="Glossary of web development terms">
    <dt>HTML</dt>
    <dd>Standard language for creating web pages.</dd>
    <dt>CSS</dt>
    <dd>Styles the appearance of web pages.</dd>
    <dt>JavaScript</dt>
    <dd>Makes web pages interactive and dynamic.</dd>
  </dl>
</body>
</html>

Important Notes

Description lists are great for pairing terms and explanations in a clear, readable way.

They improve accessibility by using semantic tags that screen readers understand.

Use <dt> and <dd> in pairs inside <dl> for best structure.

Summary

Description lists organize terms and their descriptions clearly.

Use <dl>, <dt>, and <dd> tags together.

They help both sighted users and screen readers understand content better.

Practice

1. What is the main purpose of the <dl> element in HTML?

easy

A. To add a paragraph of text

B. To create a numbered list of items

C. To create a table with rows and columns

D. To create a description list that pairs terms with their descriptions

Solution

1. Step 1: Understand the role of <dl>

   The <dl> tag is used to group terms and their descriptions in a list format.

2. Step 2: Compare with other list types

   Unlike ordered (<ol>) or unordered (<ul>) lists, <dl> is specifically for description lists.

3. Final Answer:

   To create a description list that pairs terms with their descriptions -> Option D

4. Quick Check:

   Description list = <dl> [OK]

Hint: Remember: dl = description list, dt = term, dd = description [OK]

Common Mistakes:

• Confusing <dl> with <ul> or <ol>
• Thinking <dl> creates tables
• Using <dl> for paragraphs

2. Which of the following is the correct syntax to start a description list in HTML?

easy

A. <dl>

B. <dt>

C. <dd>

D. <list>

Solution

1. Step 1: Identify the container tag for description lists

   The <dl> tag is the container that starts a description list.

2. Step 2: Understand roles of <dt> and <dd>

   <dt> defines a term, and <dd> defines its description, but they do not start the list.

3. Final Answer:

   <dl> -> Option A

4. Quick Check:

   Start description list = <dl> [OK]

Hint: Description lists always start with <dl> tag [OK]

Common Mistakes:

• Using <dt> or <dd> as the list container
• Using non-existent <list> tag
• Confusing with unordered list tags

3. What will the following HTML code display in a browser?

<dl>
  <dt>HTML</dt>
  <dd>HyperText Markup Language</dd>
  <dt>CSS</dt>
  <dd>Cascading Style Sheets</dd>
</dl>

medium

A. A numbered list with descriptions

B. A bulleted list with HTML and CSS as items

C. A list showing 'HTML' with 'HyperText Markup Language' below it, then 'CSS' with 'Cascading Style Sheets' below it

D. Plain text without any list formatting

Solution

1. Step 1: Understand the structure of the description list

   The <dl> contains pairs of <dt> (terms) and <dd> (descriptions).

2. Step 2: Visualize the browser rendering

   Each term appears on its own line, with its description indented below it, forming a clear term-description pair.

3. Final Answer:

   A list showing 'HTML' with 'HyperText Markup Language' below it, then 'CSS' with 'Cascading Style Sheets' below it -> Option C

4. Quick Check:

   dl shows terms with indented descriptions [OK]

Hint: dt = term, dd = description shown indented below [OK]

Common Mistakes:

• Thinking it creates bulleted or numbered lists
• Expecting terms and descriptions on the same line
• Ignoring indentation of descriptions

4. Identify the error in this description list code:

<dl>
  <dt>JavaScript</dt>
  <dt>A programming language</dt>
</dl>

medium

A. Missing closing </dl> tag

B. Using two <dt> tags without a <dd> for description

C. Using <dd> instead of <dt> for term

D. No error, code is correct

Solution

1. Step 1: Check tag usage in description lists

   <dt> is for terms, <dd> is for descriptions. Terms should be followed by descriptions.

2. Step 2: Identify the problem in the code

   The code uses two <dt> tags in a row without a <dd> describing the first term.

3. Final Answer:

   Using two <dt> tags without a <dd> for description -> Option B

4. Quick Check:

   Term must have description after it [OK]

Hint: Each <dt> term needs a following <dd> description [OK]

Common Mistakes:

• Using multiple <dt> tags without <dd>
• Confusing <dt> and <dd> roles
• Forgetting to close <dl>

5. You want to create a description list where some terms have multiple descriptions. Which is the correct way to write it?

hard

A.
Fruit
Apple
Banana
Vegetable
Carrot

B.
Fruit
Apple
Banana
Vegetable
Carrot

C.
Fruit
Apple
Banana
Vegetable
Carrot

D.
Fruit
Apple
Banana
Vegetable
Carrot

Solution

1. Step 1: Understand multiple descriptions for one term

   A term (<dt>) can have multiple descriptions (<dd>) listed below it.

2. Step 2: Analyze each option's structure

   Fruit

   Apple

   Banana

   Vegetable

   Carrot

   correctly groups multiple <dd> tags under one <dt> term. Other options misuse tags or mix terms and descriptions incorrectly.

3. Final Answer:

   Option A shows correct multiple descriptions for one term -> Option A

4. Quick Check:

   Multiple
   under one
   is valid [OK]

Hint: Use multiple <dd> tags after one <dt> for several descriptions [OK]

Common Mistakes:

• Using multiple <dt> tags for descriptions
• Placing <dd> before <dt>
• Using only <dd> without <dt>