Theme

Bullets

Group related points.

Clear inputs Predictable results Useful examples

Numbered

Use numbers when order matters.

Read the contract. Check the implementation. Write down the trade-offs.

Compact bullets

A borderless list with less space between items.

Clear inputs Predictable results Useful examples

Compact numbered

Circled numbers without row borders.

Read the contract. Check the implementation. Write down the trade-offs.

With links

Put your link in the action slot. The whole row is the link; the arrow is decorative.

With an action

A bordered row with a native button and your click handler.

React and routing

Put your router’s Link in slot="action". It remains the actual link, including open-in-new-tab behavior. Use a button when an action needs to run before navigation.

Composition

Use the default slot for text. The action slot accepts one native anchor or button, including router components that render one. It takes precedence over href; no nested control is created. Set disabled and current states on your control.

Static items are not focusable. Native anchors, including server-rendered router links, also work before JavaScript loads.

Astro

With the Astro adapter, spread the native slot attribute so Astro does not consume it. With cad-list-item directly, use slot="action" as usual.

API reference: <cad-list>

compactcompactbooleanfalselabellabelstring'List'variantvariantCadListVariant'bullet'compactbooleancompactyeslabelstringlabelnovariantCadListVariantvariantyes(default)Direct `cad-list-item` children.listAccessible list container.

API reference: <cad-list-item>

currentcurrentbooleanfalsedisableddisabledbooleanfalsehrefhrefstring''relrelstring''targettargetstring''valuevaluestring''compactbooleannocurrentbooleancurrentyesdisabledbooleandisabledyeshrefstringhrefnoindexnumbernorelstringrelnotargetstringtargetnovaluestringvaluenovariantCadListVariantno(default)Item content, including consumer-owned links or buttons.actionOne native link or button owning the entire interactive row.arrowDecorative trailing arrow on interactive rows.itemAccessible list item.labelVisible item label.markerBullet or number marker.rowNative link or static row.
Back to top