Navbar
navbar搭出响应式顶部导航,含品牌、链接和移动端菜单
用法
基础用法
NavbarBrand 放品牌,NavbarContent 排导航项,isActive 高亮当前页。
tsx
<Navbar bordered>
<NavbarBrand>瑚琏</NavbarBrand>
<NavbarContent justify="end">
<NavbarItem isActive>组件</NavbarItem>
<NavbarItem>文档</NavbarItem>
<NavbarItem>主题</NavbarItem>
</NavbarContent>
</Navbar>内容居中
NavbarContent 的 justify 控制导航项对齐方向。
tsx
<Navbar bordered>
<NavbarBrand>瑚琏</NavbarBrand>
<NavbarContent justify="center">
<NavbarItem isActive>组件</NavbarItem>
<NavbarItem>文档</NavbarItem>
<NavbarItem>主题</NavbarItem>
</NavbarContent>
</Navbar>响应式菜单
窄屏用 NavbarMenuToggle 受控展开折叠菜单(缩小窗口查看)。
tsx
function App() {
const [open, setOpen] = useState(false);
return (
<Navbar bordered>
<NavbarMenuToggle isOpen={open} onToggle={() => setOpen((v) => !v)} />
<NavbarBrand>瑚琏</NavbarBrand>
<NavbarContent justify="end" className="hidden sm:flex">
<NavbarItem isActive>组件</NavbarItem>
<NavbarItem>文档</NavbarItem>
</NavbarContent>
</Navbar>
);
}紧凑顶栏 · 浅底药丸导航
size="sm" 收成 56px,variant="page" 用页面底色融进页面;NavbarItem variant="soft" 选中项铺主色浅底,项里的链接整块可点。
tsx
<Navbar size="sm" variant="page">
<NavbarBrand grow={false}>瑚琏</NavbarBrand>
<NavbarContent>
<NavbarItem variant="soft" isActive><a href="#">组件</a></NavbarItem>
<NavbarItem variant="soft"><a href="#">区块</a></NavbarItem>
<NavbarItem variant="soft"><a href="#">页面</a></NavbarItem>
</NavbarContent>
</Navbar>何时用
页面顶部全局导航条(品牌 + 主菜单 + 移动端汉堡切换)用。它是横向顶栏复合件——左侧纵向 Sider 树菜单用 NavMenu,带下拉面板的多级导航用 NavigationMenu,页脚备案行用 BeianFooter。
导入
ts
import { Navbar, NavbarBrand, NavbarContent, NavbarItem, NavbarMenu, NavbarMenuToggle } from "@hulianui/ui"Props
各子件均继承对应原生元素属性。
Navbar(<nav>)
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| sticky | boolean | - | 是否 sticky 吸顶 |
| bordered | boolean | - | 是否显示底部分隔边框 |
| size | "md" | "sm" | "md" | 高度档:md 64px(中后台);sm 56px,文档 / 营销站的紧凑顶栏,左右内距同步收一档 |
| variant | "surface" | "page" | "surface" | 底色:surface 卡面色半透明(浮在内容上的面板);page 页面底色半透明 + 更淡的分隔线(融进页面)。两档都带背景模糊 |
NavbarBrand(<div>)
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| grow | boolean | true | 是否与两侧 NavbarContent 等分空间(flex-1 basis-0)。三段等分是 justify="center" 真的落在导航栏中心的前提;内容仍靠 justify-start 贴左,视觉不变。传 false 回到定宽(shrink-0),只有「品牌 + 一段紧贴品牌的 justify="start" 内容」这种两段式版式需要 |
NavbarContent(<ul>)
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| justify | "start" | "center" | "end" | "start" | 内容对齐方向。"center" 居中的参照是整条导航栏(前提是品牌段 grow,见上) |
NavbarItem(<li>)
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| isActive | boolean | - | 当前激活项(aria-current + 高亮) |
| variant | "text" | "soft" | "text" | text 只变文字色;soft 选中项铺主色浅底、悬停铺中性浅底,项里直接放链接时内距挪到链接上、整块都是点击区 |
NavbarMenuToggle
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| isOpen | boolean | - | 受控展开态 |
| aria-label | string | 跟随 locale,按 isOpen 切换 | 无障碍标签;显式传值优先 |
| breakpoint | "sm" | "md" | "lg" | "xl" | "sm" | 从这一档断点起隐藏(宽屏横排导航接手) |
| className | string | - | 类名 |
NavbarMenu(<ul>)
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| isOpen | boolean | false | 是否展开;收起时不渲染,菜单里的链接不会在收起态被 Tab 到 |
| breakpoint | "sm" | "md" | "lg" | "xl" | "sm" | 从这一档断点起隐藏,与 NavbarMenuToggle 取同一档 |
Events
NavbarMenuToggle
| 事件 | 类型 | 说明 |
|---|---|---|
| onToggle | () => void | 切换回调 |
Slots
Navbar / NavbarContent / NavbarItem / NavbarBrand 均接受 children。
| 插槽 | 类型 | 说明 |
|---|---|---|
| children | ReactNode | 各容器子件的子内容 |
禁忌 / 坑
NavbarMenuToggle与NavbarMenu都是受控件,isOpen/onToggle由你自己维护 state;两者的breakpoint要取同一档,且与横排NavbarContent出现的断点一致,否则拉宽窗口时横排与竖排会同时在屏上。- 默认菜单标签跟随
ConfigProvider locale:zhCN为“打开/关闭菜单”,enUS为 “Open/Close menu”;显式aria-label优先。 - 三段版式(品牌 + 居中主菜单 + 右侧操作区)是本件的默认形状:
NavbarBrand默认grow,三段等分,居中段才真的在导航栏中心。两段式版式(品牌 + 紧贴品牌的justify="start"内容)要显式传grow={false},否则那段内容会被推到 1/3 处。 - 品牌区要能截断(窄屏让位)时,除了
truncate还得给NavbarBrand加min-w-0——flex 项默认min-width:auto,不解开就不会收缩。
相关
BeianFooter · NavMenu · NavigationMenu · Menu · Menubar · Dock
Playground
<Navbar sticky bordered>
<NavbarMenuToggle isOpen={open} onToggle={toggle} />
<NavbarBrand>瑚琏</NavbarBrand>
<NavbarContent justify="end">
<NavbarItem isActive>组件</NavbarItem>
<NavbarItem>文档</NavbarItem>
</NavbarContent>
</Navbar>