Skip to content
wdj

AccountMenu

Implemented Navigation

Reusable account navigation with nested preference menus, persisted appearance and application-owned actions.

A wdj composition built from the existing component library.

Presentation commands show demo feedback. Read the interaction guide to connect real actions.

Account navigation

Account identity, Profile, Billing, theme selection, language and timezone submenus, and Log out.

Workspace account

Show template
{% load wdj %}
<div class="flex w-full flex-col gap-4" x-data="{ message: 'Open the account menu to explore its submenus.' }" @wdj:account-change="message = $event.detail.preference + ': ' + $event.detail.value" @wdj:account-action="message = 'Demo action: ' + $event.detail.action">
  <div class="flex items-center justify-between gap-3"><span class="text-base font-medium">Workspace account</span>{% include "wdj/components/account_menu.html" with id="example-account-menu" email="alex@example.com" only %}</div>
  <p class="text-base text-kumo-subtle" role="status" x-text="message"></p>
</div>

Preferences and logout form

Custom English locale and timezone options, an explicit trigger label and a separate native logout form.

Show template
{% load wdj %}
<div class="flex w-full flex-col gap-4" x-data="{ message: 'Preferences emit events. Log out submits the linked demo form.' }" @wdj:account-change="message = $event.detail.preference + ': ' + $event.detail.value" @wdj:account-action="if ($event.detail.action !== 'logout') message = 'Demo action: ' + $event.detail.action">
  <div>{% include "wdj/components/account_menu.html" with id="form-account-menu" email="team@example.com" trigger_label="Team account" languages=account_example_languages language="en-GB" timezones=account_example_timezones timezone="UTC" logout_form="account-demo-logout" only %}</div>
  <form id="account-demo-logout" method="post" @submit.prevent="message = 'Demo logout form submitted. No account session was changed.'">{% csrf_token %}</form>
  <p class="text-base text-kumo-subtle" role="status" x-text="message"></p>
</div>

API Reference

Prop Type Default Description
string unset Escaped account identity shown above the menu. Omitted when empty.
string Account menu (accessible label only) Optional visible text beside the user icon. The default icon trigger has the accessible name Account menu.
string unset Application-owned Profile URL. Without it, emits wdj:account-action with action profile.
string unset Application-owned Billing URL. Without it, emits wdj:account-action with action billing.
string unset ID of an external native POST form containing its CSRF token. Without it, Log out only emits an action event.
list[dict] English Options: [{value, label, disabled?}]. Selection emits wdj:account-change; the application owns translation.
string en Initially selected language value, validated against the supplied options.
list[dict] Local time, UTC Options: [{value, label, disabled?}]. Selection emits wdj:account-change; the application owns time formatting.
string local Initially selected timezone value, validated against the supplied options.
string unset Optional localStorage key for language/timezone. Use a key scoped to the current account. Theme uses the shared wdj-theme key.
string unset Stable unique DOM ID; important for HTMX targets and focus restoration.
string "" Class; pass the documented value shown in the examples.

Accessibility notes

Every interactive component keeps real semantics and keyboard support: native controls where possible, ARIA only where necessary, and a visible focus ring. See the Accessibility page for the shared contract.

Read the accessibility contract

Components

Components overview
AccountMenuReusable account navigation with nested preference menus, persisted appearance and application-owned actions.
AutocompleteFree-form input with local or HTMX-filtered suggestions.
BadgeSolid, tinted, outline and dot status labels.
BannerInline message bar with variants and optional action.
BreadcrumbsTrail navigation in two sizes.
ButtonVariants, sizes, shapes, icons and loading state.
ButtonGroupJoins a small set of tightly-coupled buttons into a single control (split buttons).
CheckboxSingle checkbox and indeterminate state.
ClipboardTextRead-only text field with a one-click copy-to-clipboard button.
Code / CodeHighlightedEscaped Pygments grammar highlighting, multiline tokens, line numbers, highlighted lines and localized copying.
CollapsibleComposable disclosure component for showing and hiding content.
Combobox / AutocompleteKumo-styled input/button triggers, search inside the popup, grouped local choices and debounced HTMX search.
CommandPaletteAccessible spotlight search overlay with Cmd+K keyboard shortcut.
DatePickerKumo-styled date and datetime popups; inline single, multiple and range calendars with bounds/presets.
DateRangePickerStyled popup or inline range calendar with bounds, presets and separately named form values.
DialogNative <dialog> modal with focus management.
DrawerEdge-anchored modal panel. LayerDialog has its own layered component.
DropdownMenuNative details menu with delegated keyboard navigation and dismissal.
EmptyEmpty-state placeholder with icon and action.
FieldLabel + description + error wrapper. Built into each control.
FieldSelectorSearchable column selector with ordering, required fields, optional persistence and table integration.
FilterBuilderReusable filter editor with AND conditions, typed values, draft/apply semantics and a JSON form contract.
FlowDirected diagrams with branches, SVG connectors, custom anchors and responsive local scrolling.
GridResponsive CSS grid layout container with preset column configurations.
InlineCopyTextCompact borderless copy control for IDs and short values.
InputText field with label, description, leading/trailing icons.
InputAreaMulti-line textarea with auto-resize option.
InputGroupInput field with seamless prefix, suffix, and addon attachments.
LabelForm field label, optional marker and tooltip.
LayerCardCompound surface card with distinct primary and secondary layers.
LayerDialogLayered native modal with actions, forms, nested dialogs and pending states.
LinkInline, current and plain text links.
LoaderAnimated spinner in three sizes.
MenuBarCompact view selector using native radio semantics.
MeterProgress bar showing a measured value within a known range.
PaginationA page navigation component for navigating through paginated content.
PopoverAnchored popup with interactive content.
RadioRadio group, vertical and horizontal.
SelectKumo-styled Alpine dropdown with groups, rich options and multiple selection; native form values and fallback.
SensitiveInputPassword/secret input with reveal toggle and copy button.
SEOServer-rendered page metadata: title, description, canonical, Open Graph, language alternatives and safe JSON-LD.
SeparatorHorizontal / vertical rules with optional label.
SidebarRecursive navigation groups, pinned links, account/zone views, search, loading, resize and full-screen mobile breadcrumbs.
SkeletonShimmer placeholder.
SliderInset single/range selection with vertical grips, value badges, endpoint labels and native keyboard/form behavior.
SurfaceBordered surface panel with header slot.
SwitchOn/off toggle in three sizes.
TableServer-driven tables with selection, sticky columns, field configuration and expandable details.
Table of contentsPage section navigation tree with active link indicator.
TabsSegmented and underline tabs with a sliding indicator, responsive overflow and local Alpine or URL/HTMX state.
TagInputMulti-value badge input for tags and recipients.
TextHeading, body, secondary, success, error and mono text.
TimeRangePickerReusable time filter with relative presets, calendar selection, exact times and UTC form values.
ToastyExpandable notification stack with variants, paused expiry and a live region.
ToolbarCompact grouped controls with shared borders, composed filters and keyboard arrow navigation.
TooltipHover and focus tooltip with grouped delays, Escape dismissal and viewport bounds.
↑ ↓ Navigate ↵ Select