block · description-list
Description list
A responsive native description list for related terms and values.
Install with
npx @madojs/ui@latest add description-list.
Block
Description list
Single name-value pairs
- Repository
- madojs/ui
- License
- MIT
Several names and values
- Owner
- Maintainer
- Mado core team
- UI working group
Rich value content
- Release policy
-
Stable releases follow the reviewed registry contract.
Applications keep ownership of every installed source file.
Always stacked
- Support window
- The current minor Mado release.
Composition
- Use a native dl and group related dt/dd nodes in direct div children. Keep one or more terms before their associated values.
Public API
-
element
dl / dt / dd - Native name-value grouping.
-
class
mado-ui-description-list / group / term / value - Responsive list and group presentation.
-
attribute
data-layout="stacked" - Forces every group into the stacked visual layout.
Detected public classes
.mado-ui-description-list.mado-ui-description-list-group.mado-ui-description-list-term.mado-ui-description-list-value
Detected public CSS properties
--mado-ui-color-border--mado-ui-color-text--mado-ui-color-text-muted--mado-ui-description-list-color--mado-ui-description-list-divider--mado-ui-description-list-font-size--mado-ui-description-list-gap--mado-ui-description-list-group-padding--mado-ui-description-list-term-color--mado-ui-description-list-term-width--mado-ui-description-list-value-min--mado-ui-space-1--mado-ui-space-3--mado-ui-space-5
Accessibility contract
- Source order, not columns, defines each term/value relationship.
- Supporting prose inside a value does not need an additional dd unless it is genuinely another value for the same term.
Keyboard
- The recipe adds no composite keyboard model; native interactive descendants keep their browser-defined keys and Tab order.
Focus
- Focus remains on native links, buttons or controls. Presentational wrappers never become focusable.
Fallback
- Without the copied stylesheet, the semantic source HTML remains readable and operable.
Installation graph
Direct dependencies
-
Mado UI theme
theme
Resolved install order
-
Mado UI theme
theme
Copied source
The CLI resolves each registry source path into the configured project target. Links below point to the exact catalog build tag.
-
blocks/description-list/mado-ui-description-list.css{styles}/mado-ui-description-list.css