From 6cd965a33668ae0e734fd2232b30cfaefecd564f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BC=A0=E6=88=90?= Date: Wed, 15 Apr 2026 15:05:36 +0800 Subject: [PATCH] 1 --- README.md | 180 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 170 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 6d61532..7c5e6bf 100644 --- a/README.md +++ b/README.md @@ -737,18 +737,178 @@ Main 中示例：` +``` + +#### 12.12.2 `date-picker/index.vue`（`DatePicker` 封装） + +- 用途：统一 `DatePicker` 的 `v-model` 语义。 +- Props：`value` +- 事件：`input`、`change` +- 说明：其余能力通过 `v-bind="$attrs"` 透传到 iView `DatePicker`。 + +```vue + +``` + +#### 12.12.3 `switch/index.vue`（`FrameworkSwitch`） + +- 用途：布尔/0/1 字段统一开关封装，避免 `` 名称冲突。 +- Props：`value`（支持 `true/false/1/0/'1'/'0'/'true'/'false'`） +- 事件：`input`、`change`、`on-change` + +```vue + +``` + +#### 12.12.4 `cron-input/index.vue` + +- 用途：可视化拼 Cron（`minute hour day month dayOfWeek`）字符串。 +- Props：`value`（Cron 字符串） +- 事件：`input` +- 说明：点击下拉后可选分钟/小时/日/月/周，点“确定”写回 Cron。 + +```vue + +``` + +#### 12.12.5 `main/pageHead.vue` + +- 用途：页面头部工具条；当 `this.$route.meta.type === '功能'` 时显示返回按钮。 +- 插槽：默认插槽（放新增/导出等按钮） +- 内置方法：`goBack()`（`this.$router.go(-1)`） + +```vue + + + +``` + +#### 12.12.6 `markdown/markdown.vue`（`MarkdownEditor`） + +- 用途：基于 `simplemde` 的 Markdown 编辑器。 +- Props： + - `value: String` + - `options: Object`（SimpleMDE 配置） + - `localCache: Boolean`（默认 `true`，写入 `localStorage.markdownContent`） +- 事件：`input`、`on-change`、`on-focus`、`on-blur` + +```vue + +``` + +#### 12.12.7 `cropper/index.vue`（`Cropper`） + +- 用途：图片裁剪（`cropperjs`），默认 1:1 比例。 +- Props：`src`、`preview`、`moveStep`、`cropButtonText` +- 事件：`on-crop`（回传裁剪后的 `File`） +- 说明：默认要求图片尺寸至少 `500x500`，否则提示错误。 + +```vue + +``` + +#### 12.12.8 `upload/Custom.vue` + +- 用途：通用文件上传（显示文件名与上传进度，上传至 OSS）。 +- Props：`value`、`accept`、`btnText` +- 事件：`input`（上传成功后的 OSS 地址） +- 方法：`clear()` + +```vue + +``` + +#### 12.12.9 `md-icons/icons.vue`（`Icons`） + +- 用途：渲染项目内 iconfont 图标（`iconfont icon-${type}`）。 +- Props：`type`（必填）、`color`、`size` + +```vue + +``` + +### 12.13 仅内部子组件（通常不单独直接使用） + +这些组件由父组件组合使用，业务页面一般不直接引用；如需复用，建议复制其父组件交互一起接入。 + +| 组件路径 | 主要被谁使用 | 作用 | +|----------|--------------|------| +| `main/components/side-menu/side-menu-item.vue` | `SideMenu` | 递归渲染 `Submenu` 节点与子菜单。 | +| `main/components/terminal/terminal.vue` | `main/components/terminal/index.vue` | 终端内容面板（当前为“终端功能暂未启用”占位）。 | +| `split-pane/trigger.vue` | `split-pane/split.vue` | 分割条拖拽手柄视图。 | +| `treeGrid/component/subThead.vue` | `treeGrid/index.vue` | 树表头部渲染。 | +| `treeGrid/component/subColmns.vue` | `treeGrid/index.vue`/`subTreeGrid.vue` | `colgroup` 宽度控制。 | +| `treeGrid/component/subTreeGrid.vue` | `treeGrid/index.vue` | 子树递归渲染、展开收起状态维护。 | +| `treeGrid/component/renderCol.vue` | `treeGrid/index.vue`/`subTreeGrid.vue` | 安全执行列 `render(h, params)`。 | +| `upload/mod/fileBtn.vue` | `upload/Custom.vue`/`upload/mod/fileListModal.vue` | 文件选择按钮。 | +| `upload/mod/fileListModal.vue` | 上传业务页（按需） | 批量选文件 +（可选）批量上传 + 回调。 | + +### 12.14 `src/components` 全量组件索引（按路径） + +> 说明：下表覆盖 `src/components/**/*.vue`。`注册方式` 里“全局”表示由 `registerGlobalComponents` 自动注册；“按需”表示需手动引入；“内部”表示被父组件组合使用。 + +| 组件路径 | 注册方式 | 入口章节 | +|----------|----------|----------| +| `asyncModal/index.vue` | 全局 | 12.6 | +| `common-icon/common-icon.vue` | 全局 | 12.11 | +| `cropper/index.vue` | 按需 | 12.12.7 | +| `cron-input/index.vue` | 按需 | 12.12.4 | +| `date-picker/index.vue` | 按需 | 12.12.2 | +| `editor/index.vue` | 全局 | 12.5 | +| `FloatPanel/index.vue` | 全局 | 12.10 | +| `info-card/infor-card.vue` | 全局（`InfoCard`） | 12.8 | +| `load-flower/index.vue` | 全局 | 12.11 | +| `login-form/login-form.vue` | 按需 | 12.12.1 | +| `main/main.vue` | 全局（`Main`） | 12.1 | +| `main/pageHead.vue` | 按需 | 12.12.5 | +| `main/components/a-back-top/index.vue` | 内部（可按需） | 12.1 / 12.11 | +| `main/components/fullscreen/fullscreen.vue` | 内部（可按需） | 12.1 | +| `main/components/header-bar/header-bar.vue` | 内部（可按需） | 12.1 | +| `main/components/header-bar/custom-bread-crumb/custom-bread-crumb.vue` | 内部（可按需） | 12.1 | +| `main/components/header-bar/sider-trigger/sider-trigger.vue` | 内部（可按需） | 12.1 | +| `main/components/language/language.vue` | 内部（可按需） | 12.1 | +| `main/components/side-menu/collapsed-menu.vue` | 内部 | 12.1 | +| `main/components/side-menu/side-menu-item.vue` | 内部 | 12.13 | +| `main/components/side-menu/side-menu.vue` | 内部（可按需） | 12.1 | +| `main/components/terminal/index.vue` | 内部（可按需） | 12.1 | +| `main/components/terminal/terminal.vue` | 内部 | 12.13 | +| `main/components/user/user.vue` | 内部（可按需） | 12.1 | +| `markdown/markdown.vue` | 按需 | 12.12.6 | +| `md-icons/icons.vue` | 按需 | 12.12.9 | +| `parent-view/parent-view.vue` | 全局（`ParentView`） | 12.1 | +| `split-pane/split.vue` | 全局（`SplitPane`） | 12.9 | +| `split-pane/trigger.vue` | 内部 | 12.13 | +| `switch/index.vue` | 按需 | 12.12.3 | +| `tables/editModal.vue` | 全局（`editModal`） | 12.6 | +| `tables/fieldItem.vue` | 全局（`fieldItem`） | 12.7 | +| `tables/fieldRenderer.vue` | 全局（`FieldRenderer`） | 12.7 | +| `tables/index.vue` | 全局（`Tables`） | 12.2 | +| `text-area/index.vue` | 全局（`TextArea`） | 12.11 | +| `treeGrid/index.vue` | 全局（`TreeGrid`） | 12.3 | +| `treeGrid/component/renderCol.vue` | 内部 | 12.13 | +| `treeGrid/component/subColmns.vue` | 内部 | 12.13 | +| `treeGrid/component/subThead.vue` | 内部 | 12.13 | +| `treeGrid/component/subTreeGrid.vue` | 内部 | 12.13 | +| `upload/Custom.vue` | 按需 | 12.12.8 | +| `upload/Multiple.vue` | 全局（`UploadMultiple`） | 12.4 | +| `upload/Single.vue` | 全局（`UploadSingle`） | 12.4 | +| `upload/mod/fileBtn.vue` | 内部 | 12.13 | +| `upload/mod/fileListModal.vue` | 内部（可按需） | 12.13 | ---