Navigation
Everything that moves the reader somewhere, or changes what they are looking at. The rule that decides the markup is whether the destination is a location — a link if it is, a button if it is not. Get that wrong and you break the back button, or you promise one and never deliver it.
Breadcrumbs
An ordered list, because the order is the meaning. The final crumb is
aria-current="page" and is not a link — a link to where you already are
is a dead control that still takes a tab stop.
<ol class="av-breadcrumb" aria-label="Breadcrumb">
<li><a href="#breadcrumb">Home</a></li>
<li><a href="#breadcrumb">Commerce</a></li>
<li><a href="#breadcrumb">Orders</a></li>
<li aria-current="page">#1042</li>
</ol>
Tabs
The full ARIA tabs pattern: role="tablist", arrow keys to move between
tabs, Home and End to jump to the ends, and a roving tabindex so the
group is one tab stop rather than one per tab. Panels are hidden with the
hidden attribute, which is a real removal from the accessibility tree,
not a visual trick.
Order #1042, placed 12 August 2026, paid in full.
Two canvas backpacks and one mechanical keyboard.
Payment captured, then handed to the carrier the same day.
<div data-av-tabs style="max-inline-size: 40rem">
<div class="av-tabs" role="tablist" aria-label="Order views">
<button class="av-tabs__tab" type="button" role="tab" id="ui-tab-1"
aria-selected="true" aria-controls="ui-panel-1">Overview</button>
<button class="av-tabs__tab" type="button" role="tab" id="ui-tab-2"
aria-selected="false" aria-controls="ui-panel-2" tabindex="-1">Items</button>
<button class="av-tabs__tab" type="button" role="tab" id="ui-tab-3"
aria-selected="false" aria-controls="ui-panel-3" tabindex="-1">History</button>
</div>
<div class="av-pt-4" id="ui-panel-1" role="tabpanel" aria-labelledby="ui-tab-1" tabindex="0">
<p>Order #1042, placed 12 August 2026, paid in full.</p>
</div>
<div class="av-pt-4" id="ui-panel-2" role="tabpanel" aria-labelledby="ui-tab-2" tabindex="0"
hidden>
<p>Two canvas backpacks and one mechanical keyboard.</p>
</div>
<div class="av-pt-4" id="ui-panel-3" role="tabpanel" aria-labelledby="ui-tab-3" tabindex="0"
hidden>
<p>Payment captured, then handed to the carrier the same day.</p>
</div>
</div>
<div class="av-tabs av-tabs--line" role="tablist" aria-label="Line tabs">
<button class="av-tabs__tab" type="button" role="tab" aria-selected="true">Overview</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">Items</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">History</button>
</div>
<div class="av-tabs av-tabs--pill" role="tablist" aria-label="Pill tabs">
<button class="av-tabs__tab" type="button" role="tab" aria-selected="true">Overview</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">Items</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">History</button>
</div>
<div class="av-tabs av-tabs--enclosed" role="tablist" aria-label="Enclosed tabs">
<button class="av-tabs__tab" type="button" role="tab" aria-selected="true">Overview</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">Items</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">History</button>
</div>
<div class="av-tabs av-tabs--vertical" role="tablist" aria-label="Vertical tabs"
style="max-inline-size: 12rem">
<button class="av-tabs__tab" type="button" role="tab" aria-selected="true">Overview</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">Items</button>
<button class="av-tabs__tab" type="button" role="tab" aria-selected="false" tabindex="-1">History</button>
</div>
Dropdowns
Opening, outside-click, Escape and arrow-key roving all come from one delegated
handler on document, which is why a dropdown in markup that arrived after
boot works without being initialised. Use role="menu" only for a list of
commands; a panel of links carrying timestamps — the notification bell — deliberately
does not, because a menu promises actions.
<div class="av-dropdown">
<button class="av-btn av-btn--outline" type="button"
data-av-dropdown-toggle aria-expanded="false" aria-haspopup="menu">
Actions
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M6 9l6 6 6-6"/></svg>
</button>
<ul class="av-dropdown__menu av-dropdown__menu--start" role="menu">
<li role="none"><button class="av-dropdown__item" type="button" role="menuitem">Duplicate</button></li>
<li role="none"><button class="av-dropdown__item" type="button" role="menuitem">Export as CSV</button></li>
<li role="none"><button class="av-dropdown__item" type="button" role="menuitem">Print</button></li>
<li class="av-dropdown__divider" role="separator"></li>
<li role="none"><button class="av-dropdown__item av-dropdown__item--danger" type="button" role="menuitem">Delete</button></li>
</ul>
</div>
<div class="av-dropdown">
<button class="av-btn av-btn--ghost av-btn--icon" type="button"
data-av-dropdown-toggle aria-expanded="false" aria-haspopup="menu"
aria-label="Row actions">
<svg class="av-icon" aria-hidden="true" viewBox="0 0 24 24"><circle cx="12" cy="5" r="1.4"/><circle cx="12" cy="12" r="1.4"/><circle cx="12" cy="19" r="1.4"/></svg>
</button>
<ul class="av-dropdown__menu av-dropdown__menu--start" role="menu">
<li role="none"><button class="av-dropdown__item" type="button" role="menuitem">Edit</button></li>
<li role="none"><button class="av-dropdown__item" type="button" role="menuitem">Archive</button></li>
</ul>
</div>
<div class="av-dropdown">
<button class="av-btn av-btn--outline" type="button"
data-av-dropdown-toggle aria-expanded="false" aria-haspopup="true">
Columns
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M6 9l6 6 6-6"/></svg>
</button>
<div class="av-dropdown__menu av-dropdown__menu--start" data-av-dropdown-keep
style="padding: var(--av-space-3); display: grid; gap: var(--av-space-2)">
<label class="av-form-check"><input class="av-check" type="checkbox" checked name="option"> Reference</label>
<label class="av-form-check"><input class="av-check" type="checkbox" checked name="option"> Client</label>
<label class="av-form-check"><input class="av-check" type="checkbox" name="option"> Supplier</label>
<label class="av-form-check"><input class="av-check" type="checkbox" checked name="option"> Amount</label>
</div>
</div>
Pagination
Three arrangements over one element tree, so a list moves between them by changing a
single class. The count is aria-live on the data grid, so a filter that
changes the result set announces the new total rather than silently redrawing.
Previous and Next carry aria-disabled, never the disabled
property — a disabled button leaves the tab order, so Next onto the last page
would destroy the focus of the control that took you there.
<div class="av-pagination">
<span class="av-pagination__info">Showing 1–8 of 214</span>
<nav class="av-pagination__pages" aria-label="Pagination">
<button class="av-pagination__page" type="button" aria-disabled="true" aria-label="Previous page">
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M15 6l-6 6 6 6"/></svg>
</button>
<button class="av-pagination__page" type="button" aria-current="page">1</button>
<button class="av-pagination__page" type="button">2</button>
<button class="av-pagination__page" type="button">3</button>
<span class="av-pagination__ellipsis" aria-hidden="true">…</span>
<button class="av-pagination__page" type="button">27</button>
<button class="av-pagination__page" type="button" aria-label="Next page">
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M9 6l6 6-6 6"/></svg>
</button>
</nav>
</div>
<div class="av-pagination av-pagination--simple">
<nav class="av-pagination__pages" aria-label="Pagination">
<button class="av-pagination__page" type="button">Previous</button>
<span class="av-pagination__status" aria-live="polite">Page 2 of 27</span>
<button class="av-pagination__page" type="button">Next</button>
</nav>
</div>
<div class="av-pagination av-pagination--compact">
<nav class="av-pagination__pages" aria-label="Pagination">
<button class="av-pagination__page" type="button" aria-label="Previous page">
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M15 6l-6 6 6 6"/></svg>
</button>
<span class="av-pagination__status" aria-live="polite">2 / 27</span>
<button class="av-pagination__page" type="button" aria-label="Next page">
<svg class="av-icon av-icon--sm" aria-hidden="true" viewBox="0 0 24 24"><path d="M9 6l6 6-6 6"/></svg>
</button>
</nav>
</div>
Disclosure
data-av-collapse toggles the element named by
aria-controls and keeps aria-expanded in step. The pairing
is the component — a chevron that rotates without the attribute changing is a picture
of a disclosure rather than one.
Signature on delivery, a nominated safe place, and a delivery window are all set here. The panel stays in the DOM when closed, so nothing typed into it is lost.
<div style="max-inline-size: 34rem">
<button class="av-btn av-btn--outline av-btn--block" type="button" data-av-collapse
aria-expanded="false" aria-controls="ui-collapse-panel"
style="justify-content: space-between">
<span>Advanced delivery options</span>
<svg class="av-icon av-icon--sm av-disclosure__caret" aria-hidden="true" viewBox="0 0 24 24"><path d="M6 9l6 6 6-6"/></svg>
</button>
<div class="av-disclosure__panel av-pt-3" id="ui-collapse-panel" data-av-state="collapsed">
<p>
Signature on delivery, a nominated safe place, and a delivery window are all set
here. The panel stays in the DOM when closed, so nothing typed into it is lost.
</p>
</div>
</div>
Command palette
Press Ctrl + K, or
⌘ + K. It is a combobox, not a
dialog with a text field in it: DOM focus never leaves the input and the selection
travels by aria-activedescendant. That distinction is why typing keeps
working while the highlight moves.
The demo's own routes ship in the runtime, so a page declares only where the
repository root is. Declare sources to replace that set with your own —
an item either goes somewhere (href, resolved against
root) or does something (run):
window.AdminVoraConfig = {
root: '/',
palette: {
sources: [
{ id: 'pages', label: 'Pages', items: [{ label: 'Orders', href: 'orders' }] },
{ id: 'actions', label: 'Actions', items: [{ label: 'New invoice', run: () => openInvoice() }] }
]
}
};
Scrollspy and carousel
Two components that follow a scroll position without listening to one.
<nav class="av-jump" data-av-scrollspy aria-label="On this page">
<a class="av-jump__link" href="#breadcrumb">Breadcrumbs</a>
<a class="av-jump__link" href="#tabs">Tabs</a>
<a class="av-jump__link" href="#dropdown">Dropdowns</a>
<a class="av-jump__link" href="#pagination">Pagination</a>
</nav>
<div class="av-carousel" data-av-carousel style="--av-carousel-slide: 48%">
<div class="av-carousel__track" tabindex="0" role="group" aria-label="Featured reports">
<div class="av-carousel__slide">
<div class="av-panel" style="padding: var(--av-space-6)">Revenue by channel</div>
</div>
<div class="av-carousel__slide">
<div class="av-panel" style="padding: var(--av-space-6)">Cohort retention</div>
</div>
<div class="av-carousel__slide">
<div class="av-panel" style="padding: var(--av-space-6)">Inventory turnover</div>
</div>
<div class="av-carousel__slide">
<div class="av-panel" style="padding: var(--av-space-6)">Support backlog</div>
</div>
</div>
<button class="av-carousel__nav av-carousel__nav--prev" type="button" aria-label="Previous slide">
<svg class="av-icon" aria-hidden="true" viewBox="0 0 24 24"><path d="M15 6l-6 6 6 6"/></svg>
</button>
<button class="av-carousel__nav av-carousel__nav--next" type="button" aria-label="Next slide">
<svg class="av-icon" aria-hidden="true" viewBox="0 0 24 24"><path d="M9 6l6 6-6 6"/></svg>
</button>
<div class="av-carousel__dots">
<button class="av-carousel__dot" type="button" aria-current="true" aria-label="Slide 1"></button>
<button class="av-carousel__dot" type="button" aria-current="false" aria-label="Slide 2"></button>
<button class="av-carousel__dot" type="button" aria-current="false" aria-label="Slide 3"></button>
<button class="av-carousel__dot" type="button" aria-current="false" aria-label="Slide 4"></button>
</div>
</div>