Back to site

Definition List

Lists term/definition pairs for structured content.

Monday
8am – 5pm
Tuesday
8am – 5pm
Wednesday
8am – 4:30pm
Thursday
9am – 4:45pm
Friday
9am – 5pm
Saturday
Closed
Sunday
Closed 
---
blocks:
  - _component: building-blocks/core-elements/definition-list
    items:
      - title: Monday
        text: 8am – 5pm
      - title: Tuesday
        text: 8am – 5pm
      - title: Wednesday
        text: 8am – 4:30pm
      - title: Thursday
        text: 9am – 4:45pm
      - title: Friday
        text: 9am – 5pm
      - title: Saturday
        text: Closed
      - title: Sunday
        text: Closed
    alignmentHorizontal: start
---

Overview #

A semantic <dl> component for displaying term/definition pairs. Ideal for glossaries, FAQs, and other label–description content. Supports markdown formatting in definitions.

Properties #

items array | default: array

Item Properties:

title string | default: My definition title

A bolded title for the list item.

text string | default: My definition content

The text content of the list item.

alignmentHorizontal enum | default: start

The horizontal alignment of the definition list items.

Accepted values:
  • start
  • center
  • end

Slots #

default

The content inside the DefinitionList. Used only when the items property is not set.

Child Component:
<DefinitionListItem>
Properties (documented under the items property above):
  • title
  • text

Examples #

AlignX #

Brand
TechCorp
Model
ProBook X1
Color
Space Gray
Weight
2.8 lbs
Dimensions
13.3" x 9.2" x 0.6"
Warranty
2 years
SKU
TB-X1-2024 
---
blocks:
  - _component: building-blocks/core-elements/definition-list
    items:
      - title: Brand
        text: TechCorp
      - title: Model
        text: ProBook X1
      - title: Color
        text: Space Gray
      - title: Weight
        text: 2.8 lbs
      - title: Dimensions
        text: 13.3" x 9.2" x 0.6"
      - title: Warranty
        text: 2 years
      - title: SKU
        text: TB-X1-2024
    alignmentHorizontal: start
---
Brand
TechCorp
Model
ProBook X1
Color
Space Gray
Weight
2.8 lbs
Dimensions
13.3" x 9.2" x 0.6"
Warranty
2 years
SKU
TB-X1-2024 
---
blocks:
  - _component: building-blocks/core-elements/definition-list
    items:
      - title: Brand
        text: TechCorp
      - title: Model
        text: ProBook X1
      - title: Color
        text: Space Gray
      - title: Weight
        text: 2.8 lbs
      - title: Dimensions
        text: 13.3" x 9.2" x 0.6"
      - title: Warranty
        text: 2 years
      - title: SKU
        text: TB-X1-2024
    alignmentHorizontal: center
---
Brand
TechCorp
Model
ProBook X1
Color
Space Gray
Weight
2.8 lbs
Dimensions
13.3" x 9.2" x 0.6"
Warranty
2 years
SKU
TB-X1-2024 
---
blocks:
  - _component: building-blocks/core-elements/definition-list
    items:
      - title: Brand
        text: TechCorp
      - title: Model
        text: ProBook X1
      - title: Color
        text: Space Gray
      - title: Weight
        text: 2.8 lbs
      - title: Dimensions
        text: 13.3" x 9.2" x 0.6"
      - title: Warranty
        text: 2 years
      - title: SKU
        text: TB-X1-2024
    alignmentHorizontal: end
---