👣 编写基础模块字典

kicc-ui/src/views/system/dict/DictDataModal.vue

@@ -1,55 +1,78 @@
 <template>
-  <BasicModal
+  <BasicModal v-bind="$attrs"
-    v-bind="$attrs"
+              width="720px"
-    showFooter
+              @register="registerModal"
-    :title="getTitle"
+              @ok="handleSubmit"
-    width="500px"
-    @register="registerModal"
-    @ok="handleSubmit"
   >
     <BasicForm @register="registerForm"/>
   </BasicModal>
 </template>
 <script lang="ts" setup>
-import {ref, computed, unref} from 'vue';
+  /**
-import {BasicForm, useForm} from '/@/components/Form/index';
+   * 提供模板规范代码参考,请尽量保证编写代码风格跟模板规范代码一致
-import {formSchema} from './dictdata.data';
+   * 采用vben-动态表格表单封装组件编写,采用 setup 写法
-//import {set} from '/@/api/platform/system/controller/dictdata';
+   * Copyright © 2020-2022 <a href="http://www.entfrm.com/">entfrm</a> All rights reserved.
-import {BasicModal, useModalInner} from '/@/components/Modal';
+   * author entfrm开发团队-王翔
+   */
+  import { ref, unref } from 'vue';
+  import { BasicForm, useForm } from '/@/components/Form/index';
+  import { formSchema } from './dictdata.data';
+  import { getDictData, addDictData, editDictData } from '/@/api/platform/system/controller/dictdata';
+  import { BasicModal, ModalProps, useModalInner } from '/@/components/Modal';
 
-const emit = defineEmits(['success', 'register']);
+  /** 通用变量统一声明区域 */
-const isUpdate = ref(true);
+  const tag = ref<Nullable<string>>('');
-const [registerForm, {resetFields, setFieldsValue, validate}] = useForm({
+  /** https://v3.cn.vuejs.org/api/options-data.html#emits */
-  labelWidth: 100,
+  const emit = defineEmits(['success', 'register']);
-  schemas: formSchema,
+  const [registerForm, { resetFields, setFieldsValue, validate, clearValidate }] = useForm({
-  showActionButtonGroup: false,
+    labelWidth: 100,
-});
+    schemas: formSchema,
+    showActionButtonGroup: false,
+    baseColProps: { span: 24 }
+  });
+  const [registerModal, { setModalProps, closeModal }] = useModalInner(async (data: WindowInnerData = { _tag: '' }) => {
+    // 处理清除脏数据
+    await resetFields();
+    await clearValidate();
+    // 处理设置数据
+    tag.value = data._tag;
+    const dictDataId = data.record?.id;
+    const props: Partial<ModalProps> = { confirmLoading: false };
+    // 采用tag标签区分操作
+    switch (unref(tag)) {
+      case 'add':
+        props.title = '新增字典数据';
+        break;
+      case 'edit':
+        props.title = '编辑字典数据';
+        await setFieldsValue(await getDictData(dictDataId));
+        break;
+    }
+    // 尾部:设置处理后的最终配置数据
+    setModalProps(props);
+  });
 
-const [registerModal, {setModalProps, closeModal}] = useModalInner(async (data) => {
+  /** 处理弹出框提交 */
-  await resetFields();
+  async function handleSubmit() {
-  setModalProps({confirmLoading: false});
+    try {
-  isUpdate.value = !!data?.isUpdate;
+      // 提取验证数据
-
+      const formData = await validate();
-  if (unref(isUpdate)) {
+      // 处理提交之前逻辑
-    await setFieldsValue({
+      setModalProps({ confirmLoading: true });
-      ...data.record,
+      // 采用tag标签区分操作
-    });
+      switch (unref(tag)) {
-  }
+        case 'add':
-});
+          await addDictData(formData);
-
+          break;
-const getTitle = computed(() => (!unref(isUpdate) ? '新增字典项' : '编辑字典项'));
+        case 'edit':
-
+          await editDictData(formData);
-async function handleSubmit() {
+          break;
-  try {
+      }
-    const values = await validate();
+      // 处理提交完成之后逻辑
-    setModalProps({confirmLoading: true});
+      closeModal();
-    //await set(values);
+      emit('success');
-    closeModal();
+    } finally {
-    emit('success');
+      setModalProps({ confirmLoading: false });
-  } finally {
+    }
-    setModalProps({confirmLoading: false});
   }
-}
-
-
 </script>

kicc-ui/src/views/system/dict/DictDataTable.vue

@@ -4,118 +4,168 @@
                fixedHeight
                contentClass="flex"
   >
-    <BasicTable @register="registerTable">
+    <BasicTable @register="registerTable"
+                @selection-change="handleSelectionChange"
+    >
       <template #toolbar>
-        <a-button type="primary" @click="handleCreate">新增字典</a-button>
+        <a-button v-auth="['dictData_add']"
+                  type="primary"
+                  @click="handleAdd()"
+        >新增字典数据</a-button>
+        <a-button v-auth="['dictData_edit']"
+                  type="primary"
+                  :disabled="state.single"
+                  @click="handleEdit()"
+        >修改字典数据</a-button>
+        <a-button v-auth="['dictData_del']"
+                  type="primary"
+                  :disabled="state.multiple"
+                  @click="handleDel()"
+        >删除字典数据</a-button>
       </template>
       <template #action="{ record }">
-        <TableAction
+        <TableAction :actions="[
-          :actions="[
+          {
-            {
+            label: '编辑',
-              icon: 'clarity:note-edit-line',
+            icon: 'fa6-regular:pen-to-square',
-              onClick: handleEdit.bind(null, record),
+            auth: ['dictData_edit'],
-            },
+            onClick: handleEdit.bind(null, record)
-            {
+          },
-              icon: 'ant-design:delete-outlined',
+          {
-              color: 'error',
+            label: '删除',
-              popConfirm: {
+            icon: 'ant-design:delete-outlined',
-                title: '是否确认删除',
+            auth: ['dictData_del'],
-                confirm: handleDelete.bind(null, record),
+            color: 'error',
-              },
+            onClick: handleDel.bind(null, record)
-            },
+          }]"
-          ]"
         />
       </template>
     </BasicTable>
-    <DictDataModal @register="registerModal" @success="handleSuccess"/>
+    <DictDataModal @register="registerModal" @success="handleRefreshTable"/>
   </PageWrapper>
 </template>
 <script lang="ts">
-  import { defineComponent, ref, reactive } from 'vue';
+  /**
-  // 引入基础组件
+   * 提供模板规范代码参考,请尽量保证编写代码风格跟模板规范代码一致
+   * 采用vben-动态表格表单封装组件编写,不采用 setup 写法
+   * Copyright © 2020-2022 <a href="http://www.entfrm.com/">entfrm</a> All rights reserved.
+   * author entfrm开发团队-王翔
+   */
+  import {defineComponent, ref, reactive, toRaw} from 'vue';
   import { PageWrapper } from '/@/components/Page';
   import { BasicTable, useTable, TableAction } from '/@/components/Table';
-  // 插入数据内容
   import { columns, searchFormSchema } from './dictdata.data';
-  // 通过API接口获取日志
+  import { listDictData, delDictData } from '/@/api/platform/system/controller/dictdata';
-  //import { list, remove } from '/@/api/platform/system/controller/dictdata';
   import { useModal } from '/@/components/Modal';
-  import DictDataModal from './DictDataModal.vue';
   import { useMessage } from '/@/hooks/web/useMessage';
+  import DictDataModal from './DictDataModal.vue';
+
+  /** 类型规范统一声明定义区域 */
+  interface TableState {
+    dictType: String;
+    single: boolean;
+    multiple: boolean;
+  }
 
   export default defineComponent({
+    name: 'DictDataManagement',
     components: { BasicTable, PageWrapper, DictDataModal, TableAction },
     setup() {
-      const { createMessage } = useMessage();
 
-      let dictType = ref<string>('');
+      /** 通用变量统一声明区域 */
-      let record = reactive({
+      const state = reactive<TableState>({
+        // 父表字典类型
         dictType: '',
-        parentId: 0,
+        // 非单个禁用
+        single: true,
+        // 非多个禁用
+        multiple: true
       });
-
+      const { createConfirm, createMessage } = useMessage();
       const [registerModal, { openModal }] = useModal();
-      const [registerTable, { reload, setProps }] = useTable({
+      const [registerTable, { reload, setProps, clearSelectedRowKeys, getSelectRowKeys }] = useTable({
         title: '>>字典项列表',
-        //api: list,
+        api: listDictData,
+        rowKey: 'id',
         columns,
         formConfig: {
           labelWidth: 120,
           schemas: searchFormSchema,
+          autoSubmitOnEnter: true
         },
+        rowSelection: { type: 'checkbox' },
         useSearchForm: true,
         showTableSetting: true,
         bordered: true,
         showIndexColumn: false,
         actionColumn: {
-          width: 80,
+          width: 220,
           title: '操作',
           dataIndex: 'action',
           slots: { customRender: 'action' },
-          fixed: undefined,
+          fixed: false
         },
-        immediate: false,
+        handleSearchInfoFn: () => clearSelectedRowKeys(),
+        immediate: false
       });
 
-      function filterByDictType(records: Recordable) {
+      /** 根据字典类型查找字典数据 */
-        setProps({ searchInfo: { dictType: records.type } });
+      function filterByDictType(dictType: string) {
-        record.dictType = records.type;
+        setProps({ searchInfo: { dictType } });
-        record.parentId = records.id;
+        state.dictType = dictType;
         reload();
       }
 
-      function handleCreate() {
+      /** 处理多选框选中数据 */
-        openModal(true, {
+      function handleSelectionChange(selection?: Recordable) {
-          record,
+        const rowSelection = toRaw(selection?.keys) || [];
-          isUpdate: true,
+        state.single = rowSelection.length != 1;
-        });
+        state.multiple = !rowSelection.length;
       }
-      function handleEdit(record: Recordable) {
+
-        openModal(true, {
+      /** 新增按钮操作,行内新增与工具栏局域新增通用 */
-          record,
+      function handleAdd() {
-          isUpdate: true,
+        openModal(true,{ _tag: 'add' });
-        });
       }
 
-      async function handleDelete(record: Recordable) {
+      /** 编辑按钮操作,行内编辑 */
-        //await remove({ id: record.id });
+      function handleEdit(record?: Recordable) {
-        createMessage.success('删除成功!');
+        record = record || { id: getSelectRowKeys() };
-        handleSuccess();
+        openModal(true, { _tag: 'edit', record });
       }
 
-      function handleSuccess() {
+      /** 删除按钮操作,行内删除 */
+      async function handleDel(record?: Recordable) {
+        const ids = record?.id || getSelectRowKeys();
+        createConfirm({
+          iconType: 'warning',
+          title: '警告',
+          content: `是否确认删除字典数据编号为${ids}字典数据吗?`,
+          onOk: async () => {
+            await delDictData(ids);
+            createMessage.success('删除成功!');
+            handleRefreshTable();
+          }
+        });
+      }
+
+      /** 处理表格刷新 */
+      function handleRefreshTable() {
+        clearSelectedRowKeys();
         reload();
       }
+
       return {
+        state,
         registerTable,
         registerModal,
-        handleCreate,
+        handleAdd,
         handleEdit,
-        handleDelete,
+        handleDel,
-        handleSuccess,
+        handleRefreshTable,
         filterByDictType,
-        dictType
+        handleSelectionChange
       };
-    },
+    }
   });
 </script>

kicc-ui/src/views/system/dict/dict.data.ts

@@ -92,18 +92,21 @@ export const formSchema: FormSchema[] = [
     field: 'name',
     label: '字典名称',
     component: 'Input',
+    required: true,
     colProps:{ span: 12 }
   },
   {
     field: 'type',
     label: '字典类型',
     component: 'Input',
+    required: true,
     colProps:{ span: 12 }
   },
   {
     field: 'isSys',
     label: '系统内置',
     component: 'Select',
+    required: true,
     defaultValue: '0',
     componentProps: {
       options: [
@@ -117,6 +120,7 @@ export const formSchema: FormSchema[] = [
     field: 'status',
     label: '状态',
     component: 'Select',
+    required: true,
     defaultValue: '0',
     componentProps: {
       options: [

kicc-ui/src/views/system/dict/dictdata.data.ts

@@ -1,82 +1,107 @@
-import {BasicColumn} from '/@/components/Table';
+/**
-import {FormSchema} from '/@/components/Table';
+ * @program: kicc-ui
+ * @description: 字典数据模块动态渲染配置
+ * @author: entfrm开发团队-王翔
+ * @create: 2022/5/8
+ */
 
-export const columns: BasicColumn[] = [
+import { BasicColumn } from '/@/components/Table';
-    {
+import { FormSchema } from '/@/components/Table';
-        title: '字典ID',
-        dataIndex: 'id',
-        width: 100,
-    },
-    {
-        title: '字典类型',
-        dataIndex: 'dictType',
-        width: 100,
-    },
-    {
-        title: '字典标签',
-        dataIndex: 'label',
-        width: 130,
-    },
-    {
-        title: '字典键值',
-        dataIndex: 'value',
-        width: 90,
-    },
-    {
-        title: '字典排序',
-        dataIndex: 'sort',
-        width: 90,
-    }
 
+/** 表格列配置 */
+export const columns: BasicColumn[] = [
+  {
+    title: '字典数据类型',
+    dataIndex: 'dictType'
+  },
+  {
+    title: '字典数据标签',
+    dataIndex: 'label'
+  },
+  {
+    title: '字典数据键值',
+    dataIndex: 'value'
+  },
+  {
+    title: '字典数据排序',
+    dataIndex: 'sort'
+  }
 ];
 
-
+/** 搜索表单配置 */
 export const searchFormSchema: FormSchema[] = [
-    {
+  {
-        field: 'dataType',
+    field: 'dataType',
-        label: '字典参数类型',
+    label: '字典类型',
-        component: 'Input',
+    component: 'Input',
-        componentProps: {
+    componentProps: {
-            placeholder: '请输入字典参数类型',
+      placeholder: '请输入字典类型'
-        },
+    },
-        colProps: {span: 16},
+    colProps: { span: 12 }
-    }
+  },
+  {
+    field: 'dataType',
+    label: '字典数据标签',
+    component: 'Input',
+    componentProps: {
+      placeholder: '请输入字典数据标签'
+    },
+    colProps: { span: 12 }
+  }
 ];
 
+/** 表单配置 */
 export const formSchema: FormSchema[] = [
-    {
+  {
-        field: 'id',
+    field: 'id',
-        label: 'ID',
+    label: 'ID',
-        component: 'Input',
+    component: 'Input',
-        show: false,
+    show: false
-    },
+  },
-    {
+  {
-        field: 'dictType',
+    field: 'dictType',
-        label: '字典类型',
+    label: '字典类型',
-        component: 'Input',
+    component: 'Input',
-        required: true,
+    required: true,
-        componentProps: {disabled: true}
+    componentProps: { disabled: true },
+    colProps:{ span: 12 }
+  },
+  {
+    field: 'label',
+    label: '字典标签',
+    component: 'Input',
+    required: true,
+    colProps:{ span: 12 }
+  },
+  {
+    field: 'value',
+    label: '字典键值',
+    component: 'Input',
+    required: true,
+    colProps:{ span: 12 }
+  },
+  {
+    field: 'sort',
+    label: '排序',
+    component: 'InputNumber',
+    componentProps: {
+      style: { width:'100%' },
+      min: 0
     },
-    {
+    required: true,
-        field: 'label',
+    colProps: {
-        label: '字典标签',
+      span: 12
-        component: 'Input',
+    }
-        required: true
+  },
-    },
+  {
-    {
+    field: 'remark',
-        field: 'value',
+    label: '备注',
-        label: '字典键值',
+    component: 'InputTextArea',
-        component: 'Input',
+    componentProps: {
-        required: true
+      rows: 6
-    },
-    {
-        field: 'sort',
-        label: '排序',
-        component: 'InputNumber',
     },
-    {
+    colProps: {
-        field: 'remark',
+      span: 24
-        label: '备注',
-        component: 'InputTextArea',
     }
-];
+  }
+];