@duxiaoma/adm-vue3

@duxiaoma/adm-vue3

快速开始

npm install @duxiaoma/adm-vue3

或者

pnpm add @duxiaoma/adm-vue3

基本使用

// main.ts
import { createApp } from 'vue'
import App from './App.vue'
import AdmVue from '@duxiaoma/adm-vue3'

const app = createApp(App)
app.use(AdmVue)
app.mount('#app')

按需引入

import { CTable, CTitle, CTooltip } from '@duxiaoma/adm-vue3'

全局配置

方式一：install 时传入（推荐）

import MyLib from '@duxiaoma/adm-vue3'

app.use(MyLib, {
  emptyTxt: '暂无数据',
  emailPrefix: ['qq.com', '163.com', 'gmail.com'],
  badgeStatus: {
    0: 'offline',
    1: 'online',
    default: 'unknown'
  },
  badgeText: {
    0: '已停用',
    1: '已启用',
    default: '未知'
  },
  psdRules: [
    {
      pattern: /^(?=.*[A-Za-z])(?=.*\d).{8,}$/,
      message: '密码至少8位，包含至少一个字母和一个数字',
      trigger: 'blur'
    }
  ],
  $apiFc: null
})

方式二：运行时动态修改

import { setConfig, getConfig } from '@duxiaoma/adm-vue3'

// 覆盖部分配置
setConfig({
  emptyTxt: '—',
  badgeText: { 0: '离线', 1: '在线', default: '未知状态' }
})

// 获取当前配置
const current = getConfig()
console.log(current.emptyTxt)

密码规则默认值：

{
  pattern: /^(?=.*[A-Za-z])(?=.*\d).{8,}$/,
  message: '密码至少8位，包含至少一个字母和一个数字',
  trigger: 'blur'
}

类型导出

import type { ColumnsType, ApiConfig } from '@duxiaoma/adm-vue3'

• ColumnsType：CTable 组件的列定义类型
• ApiConfig：全局配置对象的类型

组件

看 ./docs

其他

# 1. 类型检查（可选但建议）
pnpm type-check

# 2. 构建
pnpm build

# 3. 【强烈建议】预演打包，检查会发布哪些文件
npm pack --dry-run

# 1. 确认当前 registry（国内常被配成淘宝镜像，发布会失败）
npm config get registry

# 2. 登录官方源（会让你输用户名、密码、邮箱 OTP）
npm login --registry=https://registry.npmjs.org

# 3. 验证登录状态
npm whoami --registry=https://registry.npmjs.org

# 4. 先查包名是否已被占用（返回 404 / 报错说明可用）
npm view adm-vue --registry=https://registry.npmjs.org

# 5. 发布
npm publish --registry=https://registry.npmjs.org

# === 公开发布

npm publish --access public

后续版本迭代

npm version patch   # 1.0.0 -> 1.0.1  bug 修复
npm version minor   # 1.0.1 -> 1.1.0  新增功能、向下兼容
npm version major   # 1.1.0 -> 2.0.0  破坏性变更

想先发测试版：版本号写成 1.0.1-beta.0，然后

npm publish --tag beta