dumidumi
  • 指南
  • 配置项
  • 主题
  • Internal
  • 插件
⌘ K
介绍
什么是 dumi
基础
初始化
目录结构
约定式路由
页面渲染配置
写组件 demo
Markdown 增强
进阶
多语言
页面 Tab
移动端组件研发
自动 API 表格
使用vue
安装插件
自动 API 表格
其他
命令行
从 dumi 1.x 升级
常见问题
最后更新时间:
帮助改进此文档
Open-source MIT Licensed | Copyright © 2019-present
Powered by self

安装 Vue 支持插件 实验性

dumi 中对 Vue 的支持主要通过@dumijs/preset-vue插件集实现, 目前只支持 Vue3

安装

bash
pnpm i vue
pnpm i -D @dumijs/preset-vue

WARNING

如果您的 Vue 版本低于 3.3.6,请安装@vue/compiler-sfc

配置

ts
// .dumirc.ts
export default {
presets: ['@dumijs/preset-vue'],
};

插件选项

checkerOptions

Vue 组件元数据解析选项

例如,以下配置可以使得名称为InternalType的类型跳过检查

ts
// .dumirc.ts
export default {
presets: ['@dumijs/preset-vue'],
vue: {
checkerOptions: {
ignore: ['InternalType'],
},
},
};

默认情况下,从node_modules中引入所有类型不会被解析,这样可以有效避免元信息冗余,你也可以通过配置exclude来定制化类型引入

ts
// .dumirc.ts
export default {
presets: ['@dumijs/preset-vue'],
vue: {
checkerOptions: {
exclude: [/node_modules/, /mylib/],
},
},
};

关于 checkerOptions 更多的选项请查看: MetaCheckerOptions

tsconfigPath

TypeChecker 使用的 tsconfig,默认值为 <project-root>/<directory>/tsconfig.json

默认情况下,如果您的项目位于 Monorepo 中,则 <project-root> 为 Monorepo 项目目录;而 <directory> 则为 package.json 中的 repository.directory 选项

directory

默认情况下,该选项是 package.json 中的 repository.directory 选项

compiler

Live demo 需要浏览器端的编译器,因此需要加载@babel/standalone。我们提供 babelStandaloneCDN 选项来更改其加载地址。默认 CDN 是 https://cdn.bootcdn.net/ajax/libs/babel-standalone/7.22.17/babel.min.js

js
vue: {
compiler: {
babelStandaloneCDN: 'https://cdn.bootcdn.net/ajax/libs/babel-standalone/7.22.17/babel.min.js'
},
},