Skip to content
On this page

标签栏

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  tabbar: {
    enable: true,
  },
}

功能介绍

刷新

对当前标签页进行刷新,非激活的标签页无法刷新,并且刷新操作会强制清除页面缓存数据。

关闭

关闭标签页分关闭当前、关闭其它、关闭左侧、关闭右侧,当不满足关闭条件时,选项置灰,无法点击。

固定

将指定标签页设为固定状态,固定的标签页右键无法直接关闭,同时也不会被关闭其它、关闭左侧、关闭右侧标签页操作所关闭,并且下次访问将保留固定标签页状态。

固定标签页默认存储在浏览器本地 localStorage 里,如果需要将数据存储到服务器,可以通过 tabbar.storageTo 配置项来实现,具体配置如下:

ts
const globalSettings: Settings.all = {
  tabbar: {
    storageTo: 'server',
  },
}

然后到 /src/store/modules/tabbar.ts 中找到 updateStorage()recoveryStorage() 这两个函数,分别修改函数内的接口请求部分代码。

建议

为减轻后端处理,数据会直接以 JSON 字符串进行存储,建议后端可以在用户表增加相关字段,并将字段类型设为 lonetext

最大化

通过隐藏导航栏和顶栏,将操作内容区最大化。双击标签页可快速进入最大化。

拖拽排序

快捷操作下拉菜单

标签页合并

当标签栏开启时,框架提供标签页是否合并的配置项,方便开发者应对需要合并标签页场景的需求。

以下面这段路由配置为例:

ts
const routes: RouteRecordRaw = {
  path: '/manager',
  meta: {
    title: '管理员管理',
  },
  children: [
    {
      path: '',
      name: 'ManagerList'
      meta: {
        title: '管理员列表',
      },
    },
    {
      path: 'detail',
      name: 'ManagerCreate',
      meta: {
        title: '新增管理员',
        sidebar: false,
        activeMenu: '/manager',
      },
    },
    {
      path: 'detail/:id',
      name: 'ManagerEdit',
      meta: {
        title: '编辑管理员',
        sidebar: false,
        activeMenu: '/manager',
      },
    },
  ],
}

不合并

ts
const globalSettings: Settings.all = {
  tabbar: {
    mergeTabsBy: '',
  },
}

从列表页进入详情页时,框架会新增一个编辑管理员的标签页,并且在不关闭详情页时,可打开多个不同的编辑管理员标签页,效果如下:

根据路由名称进行合并

ts
const globalSettings: Settings.all = {
  tabbar: {
    mergeTabsBy: 'routeName',
  },
}

从列表页进入详情页时,框架会新增一个编辑管理员的标签页,并且在不关闭详情页时,打开多个不同的详情页,只会保持一个编辑管理员标签页,效果如下:

根据 meta.activeMenu 进行合并

ts
const globalSettings: Settings.all = {
  tabbar: {
    mergeTabsBy: 'activeMenu',
  },
}

从始至终只会保持一个标签页,其中的关键条件就是 activeMenu 这个参数,也就是框架会将设置过 activeMenu 的路由与 activeMenu 指向的目标路由合并为一个标签页,当在这些路由里相互跳转时,始终只保持一个标签页,效果如下:

显示图标

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  tabbar: {
    enableIcon: true,
  },
}

会根据当前路由配置中的 meta.iconmeta.activeIcon 属性来显示图标,如果未设置,则会根据路由嵌套层级,依次向上查找父级路由的 meta.iconmeta.activeIcon 属性进行显示。

记忆功能

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  tabbar: {
    enableMemory: true,
  },
}

当开启记忆功能时,框架会将当前标签页的状态记录到浏览器当前会话缓存中,刷新页面或重新登录会自动恢复,效果如下: