rw-admin-ui 1.0.0

package/packages/basic-form/src/mixins/basic-form-runtime.js

@@ -0,0 +1,12 @@
+import { createBasicFormRuntimeMixin } from './basic-form-runtime-factory';
+
+/**
+ * 普通模式运行时：
+ * - schemas 视为一维字段数组
+ * - normalize/flatten 均做最小类型保护，不做额外结构处理
+ */
+export default createBasicFormRuntimeMixin({
+  normalizeSchemas: (src) => (Array.isArray(src) ? src : []),
+  flattenSchemas: (src) => (Array.isArray(src) ? src : []),
+  logScope: 'ElBasicForm'
+});

package/packages/basic-form/src/mixins/basic-form-view.js

@@ -0,0 +1,180 @@
+import ElBasicFormItem from '../basic-form-item.vue';
+import BasicFormAction from '../basic-form-action.vue';
+
+/**
+ * 基础表单 props：plain/sections 组件与外层包装组件复用同一份定义。
+ */
+export const basicFormViewProps = {
+  model: Object,
+  rules: Object,
+  labelPosition: String,
+  labelAlign: String,
+  labelWidth: [String, Number],
+  inline: Boolean,
+  size: String,
+  disabled: Boolean,
+  schemas: {
+    type: Array,
+    default: () => []
+  },
+  fieldMapToTime: {
+    type: Array,
+    default: () => []
+  },
+  actionColOptions: Object,
+  baseColProps: Object,
+  baseRowStyle: Object,
+  mergeDynamicData: Object,
+  autoFocusFirstItem: Boolean,
+  compact: Boolean,
+  autoSetPlaceHolder: {
+    type: Boolean,
+    default: true
+  },
+  autoSetClearable: {
+    type: Boolean,
+    default: true
+  },
+  autoSubmitOnEnter: Boolean,
+  rulesMessageJoinLabel: Boolean,
+  showAdvancedButton: Boolean,
+  emptySpan: [Number, Object],
+  autoAdvancedLine: {
+    type: Number,
+    default: 3
+  },
+  alwaysShowLines: {
+    type: Number,
+    default: 1
+  },
+  showActionButtonGroup: {
+    type: Boolean,
+    default: true
+  },
+  showResetButton: {
+    type: Boolean,
+    default: true
+  },
+  resetButtonOptions: Object,
+  showSubmitButton: {
+    type: Boolean,
+    default: true
+  },
+  submitButtonOptions: Object,
+  submitButtonText: {
+    type: String,
+    default: '提交'
+  },
+  resetButtonText: {
+    type: String,
+    default: '重置'
+  },
+  resetFunc: Function,
+  submitFunc: Function,
+  tableAction: Object,
+  actionButton: {
+    type: [Array, null],
+    default: () => null
+  }
+};
+
+export default {
+  components: { ElBasicFormItem, BasicFormAction },
+  props: basicFormViewProps,
+  data() {
+    return {
+      // 当未传入外部 model 时，内部使用 internalModel 维护表单值
+      internalModel: {},
+      // 当运行时动态增减 schema 时，internalSchemas 作为内部数据源
+      internalSchemas: [],
+      // 当前生效的校验规则：优先使用外部 rules，否则为空对象
+      formRules: this.rules || {},
+      // 高级展开状态：由 toggleAdvanced 控制
+      advancedOpen: false,
+
+      // 以下字段用于 setProps 做“运行时覆写”，避免直接修改外部 props
+      _actionColOptions: null,
+      _baseColProps: null,
+      _mergeDynamicData: null,
+      _autoSubmitOnEnter: null,
+      _rulesMessageJoinLabel: null,
+      _showSubmitButton: null,
+      _showResetButton: null,
+      _submitButtonText: null,
+      _resetButtonText: null
+    };
+  },
+  computed: {
+    /**
+     * 当前表单使用的 model：外部传入优先，否则回退到 internalModel。
+     * @returns {Object}
+     */
+    formModel() {
+      return this.model || this.internalModel;
+    },
+    /**
+     * 将 labelWidth 标准化为 ElementUI 可识别的宽度字符串。
+     * @returns {string | null}
+     */
+    normalizedLabelWidth() {
+      return this.normalizeWidth(this.labelWidth);
+    },
+    /**
+     * 是否自动为常见输入组件设置 placeholder。
+     * @returns {boolean}
+     */
+    computedAutoSetPlaceHolder() {
+      return typeof this.autoSetPlaceHolder === 'boolean' ? this.autoSetPlaceHolder : true;
+    },
+    /**
+     * 是否自动为支持的组件设置 clearable。
+     * @returns {boolean}
+     */
+    computedAutoSetClearable() {
+      return typeof this.autoSetClearable === 'boolean' ? this.autoSetClearable : true;
+    },
+    /**
+     * 规则提示是否拼接 label：优先使用 setProps 注入的覆写值。
+     * @returns {boolean}
+     */
+    computedRulesMessageJoinLabel() {
+      return this._rulesMessageJoinLabel != null ? this._rulesMessageJoinLabel : !!this.rulesMessageJoinLabel;
+    }
+  },
+  methods: {
+    /**
+     * 回车提交：由 el-form keydown 触发。
+     * - 受 autoSubmitOnEnter / setProps 覆写控制
+     */
+    handleEnterSubmit() {
+      const autoSubmitEnabled = this._autoSubmitOnEnter != null ? this._autoSubmitOnEnter : this.autoSubmitOnEnter;
+      if (autoSubmitEnabled) this.submit();
+    }
+  },
+  mounted() {
+    // 对外暴露表单动作集合：外部可通过 @register 拿到操作 API
+    const api = this.computedFormActionType || {
+      setProps: this.setProps,
+      getFieldsValue: this.getFieldsValue,
+      setFieldsValue: this.setFieldsValue,
+      resetFields: this.resetFields,
+      validateFields: this.validateFields,
+      validate: this.validate,
+      submit: this.submit,
+      clearValidate: this.clearValidate,
+      scrollToField: this.scrollToField,
+      removeSchemaByField: this.removeSchemaByField,
+      appendSchemaByField: this.appendSchemaByField,
+      updateSchema: this.updateSchema
+    };
+    this.$emit('register', api);
+
+    // 自动聚焦首个输入控件：用于提升键盘输入体验
+    if (this.autoFocusFirstItem) {
+      this.$nextTick(() => {
+        const el = this.$el && this.$el.querySelector && this.$el.querySelector('input,textarea,.el-input__inner');
+        if (el && typeof el.focus === 'function') el.focus();
+      });
+    }
+  }
+};

package/packages/basic-form/src/mixins/normalize-schemas-with-sections.js

@@ -0,0 +1,52 @@
+/**
+ * 将带有多级 sections 结构的 form schema 做“规范化处理”，但**不再负责扁平化**。
+ *
+ * 说明：
+ * - 早期版本中，这个函数同时承担了“样式继承 + 结构扁平化”的职责；
+ * - 为了降低耦合、避免工具方法过度复杂，现在不在这里做扁平化；
+ * - 目前仅作为一个轻量工具函数存在，直接返回传入的 schema 数组；
+ * - 若后续需要在不改变树形结构的前提下做属性补全/规范化，可以在此函数内部扩展。
+ *
+ * @param {Array<object>} src 原始的 schema 数组（可能包含嵌套的 sections）
+ * @returns {Array<object>} 规范化后的 schema 数组（当前实现为按原样返回）
+ */
+export function normalizeSchemasWithSections(src) {
+  // 为避免调用方因传入非法类型导致运行时错误，这里做一个最小的类型保护
+  if (!Array.isArray(src)) return [];
+  // 当前版本不做任何结构变更或扁平化，直接返回原数组引用
+  return src;
+}
+
+export function flattenSchemasWithSections(src) {
+  if (!Array.isArray(src)) return [];
+
+  const result = [];
+  const seen = Object.create(null);
+
+  const pushItem = (item) => {
+    if (!item || !item.field) return;
+    const key = String(item.field);
+    if (seen[key]) return;
+    seen[key] = true;
+    result.push(item);
+  };
+
+  const stack = src.slice();
+  while (stack.length) {
+    const cur = stack.pop();
+    if (!cur) continue;
+    if (Array.isArray(cur)) {
+      for (let idx = cur.length - 1; idx >= 0; idx -= 1) {
+        stack.push(cur[idx]);
+      }
+      continue;
+    }
+    if (Array.isArray(cur.sections)) {
+      stack.push(cur.sections);
+      continue;
+    }
+    pushItem(cur);
+  }
+
+  return result;
+}

package/packages/basic-table/index.js

@@ -0,0 +1,7 @@
+import ElBasicTable from './src/basic-table.vue';
+
+ElBasicTable.install = function(Vue) {
+  Vue.component(ElBasicTable.name, ElBasicTable);
+};
+
+export default ElBasicTable;

package/packages/basic-table/src/actions.js

@@ -0,0 +1,256 @@
+/**
+ * 表格方法集（Actions）
+ * 职责：
+ * - 对外提供对表格数据与选择行为的操作方法
+ * 使用说明：
+ * - 这些方法在父组件上下文运行（依赖 internalData/internalPagination 等）
+ */
+export default {
+  // 获取行主键值（支持字符串字段名或函数 rowKey(row)）
+  /**
+   * 获取行的主键值
+   * @param {Object} row 行数据
+   * @returns {*|undefined} 主键值
+   */
+  getKeyOfRow(row) {
+    const k = this.rowKey;
+    if (!k) return undefined;
+    if (typeof k === 'function') return k(row);
+    return row ? row[k] : undefined;
+  },
+  // 根据主键值取消某一行的选中状态
+  /**
+   * 根据主键取消选中某一行
+   * @param {*} key 主键值
+   * @returns {void}
+   */
+  deleteSelectRowByKey(key) {
+    const ref = this.$refs.tableRef;
+    const row = this.internalData.find((r) => this.getKeyOfRow(r) === key);
+    if (ref && row) ref.toggleRowSelection(row, false);
+    this.onSelectionChange(this.selectedRows.filter((r) => this.getKeyOfRow(r) !== key));
+  },
+  // 获取当前选中行的主键集合
+  /**
+   * 获取当前选中行主键集合
+   * @returns {Array<*>}
+   */
+  getSelectRowKeys() {
+    return this.selectedRows.map((r) => this.getKeyOfRow(r)).filter((v) => v !== undefined);
+  },
+  // 获取当前选中的行数据副本
+  /**
+   * 获取当前选中行数据副本
+   * @returns {Array<Object>}
+   */
+  getSelectRows() {
+    return this.selectedRows.slice();
+  },
+  // 清空当前选中行
+  /**
+   * 清空当前选中行与主键集合
+   * @returns {void}
+   */
+  clearSelectedRowKeys() {
+    const ref = this.$refs.tableRef;
+    if (ref && typeof ref.clearSelection === 'function') ref.clearSelection();
+    this.selectedRows = [];
+    this.selectedRowKeys = [];
+  },
+  // 设置选中行的主键集合（批量选中/取消）
+  /**
+   * 通过主键集合设置选中状态
+   * @param {Array<*>} rowKeys 选中主键集合
+   * @returns {void}
+   */
+  setSelectedRowKeys(rowKeys) {
+    const keys = Array.isArray(rowKeys) ? rowKeys : [];
+    const ref = this.$refs.tableRef;
+    if (!ref) return;
+    this.internalData.forEach((r) => {
+      const k = this.getKeyOfRow(r);
+      ref.toggleRowSelection(r, keys.indexOf(k) !== -1);
+    });
+  },
+  // 获取当前分页配置引用（或 false）
+  /**
+   * 获取当前分页配置引用
+   * @returns {Object|boolean}
+   */
+  getPaginationRef() {
+    return this.internalPagination || false;
+  },
+  // 获取当前分页显示状态
+  /**
+   * 获取是否显示分页
+   * @returns {boolean}
+   */
+  getShowPagination() {
+    return !!this.showPaginationFlag;
+  },
+  // 设置分页显示状态（返回 Promise 以保持一致性）
+  /**
+   * 设置分页显示状态
+   * @param {boolean} show 是否显示
+   * @returns {Promise<void>|undefined}
+   */
+  setShowPagination(show) {
+    if (typeof window !== 'undefined' && window.Promise) {
+      return new window.Promise((resolve) => {
+        this.showPaginationFlag = !!show; resolve();
+      });
+    }
+    this.showPaginationFlag = !!show;
+    return undefined;
+  },
+  // 获取选择列配置（或 false）
+  /**
+   * 获取选择列配置
+   * @returns {Object|boolean}
+   */
+  getRowSelection() {
+    return this.rowSelection || false;
+  },
+  // 更新指定行的指定字段值（按索引）
+  /**
+   * 按索引更新指定行的某字段
+   * @param {number} index 行索引
+   * @param {string} key 字段名
+   * @param {*} value 字段值
+   * @returns {void}
+   */
+  updateTableData(index, key, value) {
+    const i = Number(index);
+    if (i >= 0 && i < this.internalData.length) {
+      const rec = { ...(this.internalData[i] || {}) };
+      rec[key] = value;
+      this.$set(this.internalData, i, rec);
+    }
+  },
+  // 根据主键更新指定行数据（局部更新）
+  /**
+   * 根据主键更新指定行数据
+   * @param {*} rowKey 主键值
+   * @param {Object} record 局部更新数据
+   * @returns {void}
+   */
+  updateTableDataRecord(rowKey, record) {
+    const idx = this.internalData.findIndex((r) => this.getKeyOfRow(r) === rowKey);
+    if (idx !== -1) {
+      this.$set(
+        this.internalData,
+        idx,
+        {
+          ...(this.internalData[idx] || {}),
+          ...(record || {})
+        }
+      );
+    }
+  },
+  // 根据主键集合删除指定行（局部删除）
+  /**
+   * 根据主键集合删除行
+   * @param {Array<*>|*} rowKey 主键或主键数组
+   * @returns {void}
+   */
+  deleteTableDataRecord(rowKey) {
+    const keys = Array.isArray(rowKey) ? rowKey : [rowKey];
+    this.internalData = this.internalData.filter((r) => keys.indexOf(this.getKeyOfRow(r)) === -1);
+  },
+  // 插入一行数据（可指定插入位置，否则追加）
+  /**
+   * 插入一行数据
+   * @param {Object} record 行数据
+   * @param {number} [index] 插入位置索引
+   * @returns {void}
+   */
+  insertTableDataRecord(record, index) {
+    const rec = { ...(record || {}) };
+    const i = typeof index === 'number' ? index : this.internalData.length;
+    const list = this.internalData.slice();
+    if (i >= 0 && i <= list.length) {
+      list.splice(i, 0, rec);
+    } else {
+      list.push(rec);
+    }
+    this.internalData = list;
+  },
+  // 获取搜索表单方法集（当启用 useSearchForm 时有效）
+  /**
+   * 获取搜索表单方法集
+   * @returns {Object|null}
+   */
+  getForm() {
+    return this.formActions;
+  },
+  // 展开全部树形节点
+  /**
+   * 展开全部树形节点（树形表格）
+   * @returns {void}
+   */
+  expandAll() {
+    const ref = this.$refs.tableRef;
+    if (!ref || !this.rowKey) return;
+    const store = ref.store;
+    const treeData = (store && store.states && store.states.treeData) || {};
+    const keys = Object.keys(treeData);
+    if (keys.length && store && typeof store.updateTreeExpandKeys === 'function') {
+      store.updateTreeExpandKeys(keys);
+    }
+  },
+  // 折叠全部树形节点
+  /**
+   * 折叠全部树形节点（树形表格）
+   * @returns {void}
+   */
+  collapseAll() {
+    const ref = this.$refs.tableRef;
+    if (!ref || !this.rowKey) return;
+    const store = ref.store;
+    if (store && typeof store.updateTreeExpandKeys === 'function') {
+      store.updateTreeExpandKeys([]);
+    }
+  },
+  // 表格选择变化事件处理：同步 selectedRows/selectedRowKeys，并对外发出 selection-change
+  /**
+   * 表格选择变化事件
+   * @param {Array<Object>} sel 选中行集合
+   * @returns {void}
+   */
+  onSelectionChange(sel) {
+    this.selectedRows = Array.isArray(sel) ? sel : [];
+    this.selectedRowKeys = this.getSelectRowKeys();
+    this.$emit('selection-change', {
+      keys: this.selectedRowKeys,
+      rows: this.selectedRows
+    });
+  },
+  // 表格行点击事件处理：支持点击切换选中（当 clickToRowSelect=true 且 rowSelection 有效）
+  /**
+   * 表格行点击事件
+   * @param {Object} row 行数据
+   * @param {Object} column 列对象
+   * @param {Event} event 原生事件
+   * @returns {void}
+   */
+  onRowClick(row, column, event) {
+    this.$emit('row-click', row, column, event);
+    if (this.clickToRowSelect) {
+      const ref = this.$refs.tableRef;
+      if (ref && this.rowSelection) {
+        ref.toggleRowSelection(row);
+      }
+    }
+  },
+  // 重新计算表格布局高度（适配容器变化）
+  /**
+   * 重新计算表格布局高度
+   * @returns {void}
+   */
+  redoHeight() {
+    const ref = this.$refs.tableRef;
+    if (ref && typeof ref.doLayout === 'function') {
+      ref.doLayout();
+    }
+  }
+};