FrappeUIPhx.Components.NavItem (frappe_ui_phx v0.3.1)

Item de navegação com ícone e rótulo (Tabs, TabButtons, Sidebar, SidebarRail, SettingsDialog, MobileShell). Navega por patch/navigate/href ou dispara click (evento ou %JS{}) — a decisão "link ou botão" é de FrappeUIPhx.Components.Action. O estado ativo é decidido por quem chama (assign do servidor).

Vocabulário único dos slots de item (todos os componentes de navegação o aceitam): id, label, icon, patch, navigate, href, click.

Summary

Functions

known_active(active, ids)

Item ativo seguro: devolve active se for um dos ids, senão nil (nenhum ativo).

nav_item(assigns)

Functions

known_active(active, ids)

@spec known_active(String.t() | nil, [String.t()]) :: String.t() | nil

Item ativo seguro: devolve active se for um dos ids, senão nil (nenhum ativo).

active costuma vir da URL (?tab=...); valor desconhecido é entrada de usuário e não pode derrubar a página.

nav_item(assigns)

Attributes

item (:map) (required) - id, label, icon, patch, navigate, href, click.
active (:boolean) - Defaults to false.
class (:any) - Defaults to nil.
icon_only (:boolean) - esconde o rótulo (continua acessível). Defaults to false.
stacked (:boolean) - ícone acima do rótulo. Defaults to false.
role (:string) - Defaults to nil.
Global attributes are accepted. ex.: aria-controls.