Skip to content

替换为 Naive UI

注意

v4.0 之前的版本不支持替换组件库,本文适用于 v4.0 及之后的版本。

由于框架默认使用的是 Element Plus 组件库,并且演示源码中大量示例也使用了 Element Plus,如果你需要使用 Naive UI,请拉取框架源码分支,或者到 Github Releases 页面下载框架源码压缩包。

专业版用户也同样,请到专业版仓库下载框架源码。

安装

sh
# 安装依赖
pnpm install

# 安装 Naive UI
pnpm add naive-ui -D

代码调整

基础版

修改 /tsconfig.json 文件

json
{
  "compilerOptions": {
    ...
    "types": [
      ...
      "element-plus/global"
      "naive-ui/volar"
    ],
    ...
  }
}

整体修改 /src/ui-provider/index.ts 文件

ts
import type { App } from 'vue'
import naive from 'naive-ui'

function install(app: App) {
  app.use(naive)
}

export default { install }

整体修改 /src/ui-provider/index.vue 文件

vue
<script setup lang="ts">
import { darkTheme, dateZhCN, zhCN } from 'naive-ui'
import useSettingsStore from '@/store/modules/settings'

const settingsStore = useSettingsStore()
</script>

<template>
  <NConfigProvider :locale="zhCN" :date-locale="dateZhCN" :theme="settingsStore.currentColorScheme === 'dark' ? darkTheme : undefined" style="height: 100%;">
    <NMessageProvider>
      <slot />
      <NGlobalStyle />
    </NMessageProvider>
  </NConfigProvider>
</template>

删除相关文件

.
└─ src
   └─ components // 下列扩展组件基于 Element Plus 二次封装,需要删除
     ├─ FileUpload
     ├─ ImagePreview
     ├─ ImagesUpload
     ├─ ImageUpload
     └─ PcasCascader
专业版

修改 /tsconfig.json 文件

json
{
  "compilerOptions": {
    ...
    "types": [
      ...
      "element-plus/global"
      "naive-ui/volar"
    ],
    ...
  }
}

整体修改 /src/ui-provider/index.ts 文件

ts
import type { App } from 'vue'
import naive, { dateEnUS, dateZhCN, dateZhTW, enUS, zhCN, zhTW } from 'naive-ui'

function install(app: App) {
  app.use(naive)
}

// 此处的对象属性和 src/locales/index.ts 中的 messages 对象属性一一对应
const locales: { [key: string]: any } = {
  'zh-cn': {
    ui: zhCN,
    date: dateZhCN,
  },
  'zh-tw': {
    ui: zhTW,
    date: dateZhTW,
  },
  'en': {
    ui: enUS,
    date: dateEnUS,
  },
}

export default { install }
export { locales }

整体修改 /src/ui-provider/index.vue 文件

vue
<script setup lang="ts">
import { darkTheme } from 'naive-ui'
import { locales } from './index'
import useSettingsStore from '@/store/modules/settings'

const settingsStore = useSettingsStore()
</script>

<template>
  <NConfigProvider :locale="locales[settingsStore.lang].ui" :date-locale="locales[settingsStore.lang].date" :theme="settingsStore.currentColorScheme === 'dark' ? darkTheme : undefined" style="height: 100%;">
    <NMessageProvider>
      <slot />
      <NGlobalStyle />
    </NMessageProvider>
  </NConfigProvider>
</template>

修改登录页

由于登录页使用了 Element Plus 组件,并且删除会导致框架无法正常使用,所以此处需要开发者自行修改或者重新制作登录页,或者也可以参考下方示例中已经修改好的登录页。

卸载

sh
# 卸载 Element Plus
pnpm remove element-plus

完成

至此,你已经将框架中的 Element Plus 组件库替换为 Naive UI 组件库,并且可以开始使用 Naive UI 进行业务开发了。

示例

如果对上述的步骤还有不清楚的地方,可以访问此仓库查看示例源码,以及此链接查看示例网站。