MenuList
variant link · solid · pill · gradient · bordered · static × color primary/neutral
A list of navigation links (settings side menu, section index).
The active item moving
<.menu_list variant="pill" color="primary" demo><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list>
variant × color
<div class="grid grid-cols-[80px_repeat(6,_minmax(0,1fr))] gap-y-[10px] gap-x-[12px] items-center"><span></span><span class="text-xs text-muted font-mono text-center">link</span><span class="text-xs text-muted font-mono text-center">solid</span><span class="text-xs text-muted font-mono text-center">pill</span><span class="text-xs text-muted font-mono text-center">gradient</span><span class="text-xs text-muted font-mono text-center">bordered</span><span class="text-xs text-muted font-mono text-center">static</span><span class="text-xs text-muted font-mono">primary</span><div class="flex justify-center min-w-0"><.menu_list variant="link" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="solid" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="pill" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="gradient" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="bordered" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="static" color="primary"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><span class="text-xs text-muted font-mono">neutral</span><div class="flex justify-center min-w-0"><.menu_list variant="link" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="solid" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="pill" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="gradient" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="bordered" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div><div class="flex justify-center min-w-0"><.menu_list variant="static" color="neutral"><:item href="#" style="--dl:0.0s"><.icon name="grid" />Visão geral</:item><:item href="#" active style="--dl:1.5s"><.icon name="cart" />Pedidos</:item><:item href="#" style="--dl:3.0s"><.icon name="users" />Clientes</:item><:item href="#" style="--dl:4.5s"><.icon name="wallet" />Financeiro</:item></.menu_list></div></div>
Usage
<.menu_list variant="solid" color="primary"> <:item icon="huge-shopping-cart-01" navigate={~p"/pedidos"} active>Pedidos</:item> </.menu_list>
Rules
linkonly colors the text;solidandgradientfill the active one;pillgives a soft rounded background;borderedoutlines.staticdisables hover for read-only lists.
API reference
Todos os function components, atributos, valores e slots que este componente cobre.
Menu lists: a vertical list of links with one active entry, plus menu_item and menu_row.
Styled only with Tailwind utilities: the list carries the look of its links (and of the active
one, marked data-state="on"), so a menu_item inside a :row takes it from the list. Every part
carries data-part (menu-list, menu-item, menu-item-count, menu-rows, menu-row...).
<.menu_list variant="solid" color="primary">
<:item navigate={~p"/orders"} active><.icon name="cart" />Orders</:item>
<:item navigate={~p"/clients"} count={12}>Clients</:item>
</.menu_list>
<.menu_list variant="pill" on_select="pick">
<:item value="shipping" active={@tab == "shipping"}>Shipping</:item>
</.menu_list>
Items with a destination (href, navigate, patch) are links; items with a value push
on_select with %{"value" => value} (a %JS{} runs instead). variant="static" with
:item slots is the read-only list (links ignore the pointer); with rows and :row it is the
canvas list of menu_rows (a div).
Streams: <.menu_list id="pages" rows={@streams.pages}><:row :let={{_id, page}}>....
Notes
- An
activelink item (ormenu_item) carriesaria-current="page". - Each
:itemaccepts any attribute (style,phx-click,id...). menu_item'svariant/colordefault tonil: the item is then a bare<a>meant for amenu_list:row; with a variant it is wrapped in its ownlu-mlnavigation.
<.menu_list>
| Attr | Type | Default | Values / notes |
|---|---|---|---|
id |
:string |
nil |
|
variant |
:string |
"link" |
link, solid, pill, gradient, bordered, static |
color |
:string |
"primary" |
primary, neutral |
on_select |
:any |
nil |
|
target |
:any |
nil |
|
rows |
:any |
nil |
A list or a stream rendered by :row. |
row_id |
:any |
nil |
|
demo |
:boolean |
false |
The animated mock: the highlight walks over the links (stagger them with style="--dl:1.5s"). |
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:item>- attrs:href,navigate,patch,active,value,count,class,style,id,title,phx-click,phx-target,phx-value-id<:row>
<.menu_item>
| Attr | Type | Default | Values / notes |
|---|---|---|---|
variant |
:string |
nil |
nil, link, solid, pill, gradient, bordered |
color |
:string |
nil |
nil, primary, neutral |
active |
:boolean |
false |
|
value |
:string |
nil |
|
on_select |
:any |
nil |
|
target |
:any |
nil |
|
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element, including href, navigate, patch, method, download, replace.
Slots:
<:count><:icon><:inner_block>(required)
<.menu_row>
| Attr | Type | Default | Values / notes |
|---|---|---|---|
title |
:string |
nil |
|
sub |
:string |
nil |
|
unread |
:boolean |
false |
|
unread_label |
:string |
"Unread" |
|
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element, including href, navigate, patch, method, download, replace.
Slots:
<:icon><:inner_block><:value>
<.menu>
Same as menu_list/1 (same attributes and slots), under the name the design vitrine uses.
| Attr | Type | Default | Values / notes |
|---|---|---|---|
id |
:string |
nil |
|
variant |
:string |
"link" |
link, solid, pill, gradient, bordered, static |
color |
:string |
"primary" |
primary, neutral |
on_select |
:any |
nil |
|
target |
:any |
nil |
|
rows |
:any |
nil |
A list or a stream rendered by :row. |
row_id |
:any |
nil |
|
demo |
:boolean |
false |
The animated mock: the highlight walks over the links. |
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:item>- attrs:href,navigate,patch,active,value,count,class,style,id,title,phx-click,phx-target,phx-value-id<:row>