Skip to content

工具栏

工具栏主要是红框处各类功能图标。

收藏夹 专业版

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启收藏夹
     * @默认值 `false`
     */
    favorites: true,
  },
}

开启后可将常用的导航菜单添加进收藏夹,方便快速访问。

数据存储

收藏夹默认存储在浏览器本地 localStorage 里,如果需要将数据存储到服务器,可以通过 favorites.storageTo 配置项来实现,具体配置如下:

ts
const globalSettings: Settings.all = {
  favorites: {
    /**
     * 存储位置
     * @默认值 `'local'` 本地存储
     * @可选值 `'server'` 服务器存储
     */
    storageTo: 'server',
  },
}

然后到 /src/api/modules/user.ts 中找到 favorites()favoritesEdit() 这两个函数,并分别修改这两个函数的请求地址。

建议

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

面包屑导航

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启面包屑导航
     * @默认值 `true`
     */
    breadcrumb: true,
  },
}

移动端访问时,会隐藏面包屑导航。

当使用文件系统路由时,将无法使用面包屑导航,详细可阅读《基于文件系统的路由》。

风格 专业版

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  breadcrumb: {
    /**
     * 面包屑导航风格
     * @默认值 `''` 默认
     * @可选值 `'modern'` 现代
     */
    style: '',
  },
}

显示主导航 专业版

在应用配置里设置:

ts
const globalSettings: Settings.all = {
  breadcrumb: {
    /**
     * 是否在面包屑导航里显示主导航
     * @默认值 `false`
     */
    enableMainMenu: true,
  },
}

导航搜索

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启导航搜索
     * @默认值 `true`
     */
    navSearch: true,
  },
}

通知中心 专业版

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启通知中心
     * @默认值 `false`
     */
    notification: true,
  },
}

通知中心不涉及具体业务,需开发者自行实现,相关文件在 /src/layouts/components/Topbar/Toolbar/Notification 目录下。

国际化 专业版

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启国际化
     * @默认值 `false`
     */
    i18n: true,
  },
}

如果设置为不启用,并不代表不支持国际化切换,只是不会在工具栏显示切换语言的图标,详细可阅读《国际化》。

浏览器全屏

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启全屏
     * @默认值 `false`
     */
    fullscreen: true,
  },
}

页面刷新

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启页面刷新
     * @默认值 `false`
     */
    pageReload: true,
  },
}

颜色主题

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 是否开启颜色主题
     * @默认值 `false`
     */
    colorScheme: true,
  },
}

如果设置为不启用,并不代表不支持颜色主题切换,只是不会在工具栏显示切换颜色主题的图标。

布局 专业版

在应用配置中设置:

ts
const globalSettings: Settings.all = {
  toolbar: {
    /**
     * 布局设置,可自定义摆放位置和顺序,其中 `->` 为分隔符,用于分隔左右两侧的工具栏。修改时请确保默认值里的所有值都存在,不可删减。
     * @默认值 `['favorites', 'breadcrumb', '->', 'navSearch', 'notification', 'i18n', 'fullscreen', 'pageReload', 'colorScheme']`
     */
    layout: ['favorites', 'breadcrumb', '->', 'navSearch', 'notification', 'i18n', 'fullscreen', 'pageReload', 'colorScheme'],
  },
}