flame-uni

flame-uni

基于 uni-app（Vue3） 的移动端动态表单组件库，与 flame-plus 的 flmDynamicForm 使用同一套配置协议（groups / buttons / controlType）。

安装

pnpm add flame-uni flame-uni-types
# 或
npm install flame-uni flame-uni-types

对等依赖：vue、@dcloudio/uni-ui、flame-uni-types。

在 uni-app 中使用

1. 全局注册（推荐）

import { createSSRApp } from 'vue'
import App from './App.vue'
import { installFlameUni } from 'flame-uni'

export function createApp() {
  const app = createSSRApp(App)
  installFlameUni(app)
  return { app }
}

2. easycom（可选）

pages.json 中配置（路径相对 node_modules/flame-uni）：

{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^flmDynamicForm$": "flame-uni/uni_modules/flame-uni/components/complex/flmDynamicForm/flmDynamicForm.vue",
      "^flmSubForm$": "flame-uni/uni_modules/flame-uni/components/complex/flmSubForm/flmSubForm.vue",
      "^flmInput$": "flame-uni/uni_modules/flame-uni/components/base/flmInput/flmInput.vue",
      "^(flm[A-Z][a-zA-Z0-9]*)$": "flame-uni/uni_modules/flame-uni/components/base/$1/$1.vue"
    }
  }
}

uni-app 3.x 也会自动扫描 node_modules 下的 uni_modules 目录。

3. 按需引用

import FlmDynamicForm from 'flame-uni/components/complex/flmDynamicForm/flmDynamicForm.vue'

包结构

flame-uni/
├── index.js                 # 导出 installFlameUni
├── uni_modules/flame-uni/   # 组件源码（符合 uni_modules 规范）
│   ├── components/base/
│   ├── components/complex/
│   ├── common/
│   └── register.js
└── types.d.ts

类型

请同时安装 flame-uni-types：

import type { DynamicFormConfig, InputConfig } from 'flame-uni-types'

本地开发

组件库类型检查：

cd spark-framework/flame-uni
pnpm install
pnpm run ts:check

完整可运行示例见同级目录 flame-uni-demo。

发布

pnpm publish --access public

文档

• docs/COMPONENTS.md — 组件清单与 flame-plus 对照