Skip to content

移动端导航开关

@astryxdesign/core v0.7.1 · MobileNavToggle

Page title

使用方法 ​

窄屏上打开 移动端导航 抽屉的那个按钮。它画的是两道杠的菜单图标,抽屉打开时变成关闭的样子,aria-expanded 也跟着改。

ts
import { MobileNavToggle } from '@astryx-vue/core/MobileNav'

开关和抽屉绑同一个 v-model:is-open,controls 指向抽屉的 id,按钮和对话框就关联起来了:

vue
<script setup lang="ts">
import { MobileNav, MobileNavToggle } from '@astryx-vue/core/MobileNav'
import { ref } from 'vue'

const open = ref(false)
</script>

<template>
  <MobileNavToggle v-model:is-open="open" controls="app-nav" label="打开导航" />
  <MobileNav id="app-nav" v-model:is-open="open" header="导航" side="start">
    <!-- 导航项 -->
  </MobileNav>
</template>

解剖

部分说明
开关按钮在移动视口上打开或关闭抽屉的按钮。

最佳实践 ​

指引实践
推荐开关和抽屉绑同一个 v-model:is-open,图标状态才不会和抽屉对不上。
推荐移动端导航和侧边导航用同一份导航项,把它抽成一个变量共用。
推荐页面上不止一处导航时给它一个 label,让按钮说清自己打开的是哪个。
避免在桌面上用移动端导航。桌面该用常驻的侧边导航。

示例 ​

常见的用法和不同的状态。

基本用法

Page title
Navigation

带无障碍名称的导航开关,旁边是页面标题。它打开一个绑着同一份状态的移动端导航抽屉。