Skip to content

导航项

@astryxdesign/core v0.7.1 · NavItem

使用方法 ​

NavItem 是侧栏、顶栏和菜单里的一条导航。有 href 时渲染成链接,禁用或没有地址时渲染成按钮。图标用 iconClass 传入 CSS icon,也可以用 icon 插槽。需要圆形强调底时用同目录导出的 NavIcon。

链接根默认是 a。接入 Vue Router 时把 RouterLink 传给 as,组件会同时带上 href 和 to。

vue
<script setup lang="ts">
import { NavItem } from '@astryx-vue/core/NavItem'
</script>

<template>
  <NavItem href="/home" icon-class="i-carbon-home" is-selected label="首页" />
</template>

最佳实践 ​

指引实践
推荐当前页设置 isSelected,组件会写上 aria-current="page"。
推荐只显示图标时打开 isIconOnly,label 仍会成为无障碍名称。
避免不要把图标做成独立的图标组件再塞进导航。图标走 class 或插槽。

示例 ​

基本用法

导航标题上的圆形图标容器。搜索和日历并排放在一起。