初始化项目，自 v1.7.1 版本开始

src/views/system/post/PostForm.vue

@@ -0,0 +1,92 @@
+<template>
+  <!-- 弹窗 -->
+  <XModal id="PostForm" :loading="modelLoading" v-model="modelVisible" :title="modelTitle">
+    <!-- 表单：添加/修改 -->
+    <Form
+      ref="formRef"
+      v-if="['create', 'update'].includes(actionType)"
+      :schema="allSchemas.formSchema"
+      :rules="rules"
+    />
+    <!-- 表单：详情 -->
+    <Descriptions
+      v-if="actionType === 'detail'"
+      :schema="allSchemas.detailSchema"
+      :data="detailData"
+    />
+    <template #footer>
+      <!-- 按钮：保存 -->
+      <XButton
+        v-if="['create', 'update'].includes(actionType)"
+        type="primary"
+        :title="t('action.save')"
+        :loading="actionLoading"
+        @click="submitForm()"
+      />
+      <!-- 按钮：关闭 -->
+      <XButton :loading="actionLoading" :title="t('dialog.close')" @click="modelVisible = false" />
+    </template>
+  </XModal>
+</template>
+<script setup lang="ts">
+import type { FormExpose } from '@/components/Form'
+import * as PostApi from '@/api/system/post'
+import { rules, allSchemas } from './post.data'
+const { t } = useI18n() // 国际化
+const message = useMessage() // 消息弹窗
+
+const emit = defineEmits(['success'])
+
+// 弹窗相关的变量
+const modelVisible = ref(false) // 是否显示弹出层
+const modelTitle = ref('update') // 弹出层标题
+const modelLoading = ref(false) // 弹出层loading
+const actionType = ref('') // 操作按钮的类型
+const actionLoading = ref(false) // 按钮 Loading
+const formRef = ref<FormExpose>() // 表单 Ref
+const detailData = ref() // 详情 Ref
+
+const openModal = async (type: string, rowId?: number) => {
+  modelLoading.value = true
+  modelTitle.value = t('action.' + type)
+  actionType.value = type
+  modelVisible.value = true
+  // 设置数据
+  if (rowId) {
+    const res = await PostApi.getPostApi(rowId)
+    if (type === 'update') {
+      unref(formRef)?.setValues(res)
+    } else if (type === 'detail') {
+      detailData.value = res
+    }
+  }
+  modelLoading.value = false
+}
+
+// 提交新增/修改的表单
+const submitForm = async () => {
+  const elForm = unref(formRef)?.getElFormRef()
+  if (!elForm) return
+  const valid = await elForm.validate()
+  if (valid) {
+    actionLoading.value = true
+    // 提交请求
+    try {
+      const data = unref(formRef)?.formModel as PostApi.PostVO
+      if (actionType.value === 'create') {
+        await PostApi.createPostApi(data)
+        message.success(t('common.createSuccess'))
+      } else {
+        await PostApi.updatePostApi(data)
+        message.success(t('common.updateSuccess'))
+      }
+      modelVisible.value = false
+      emit('success')
+    } finally {
+      actionLoading.value = false
+    }
+  }
+}
+
+defineExpose({ openModal: openModal })
+</script>

src/views/system/post/index.vue

@@ -0,0 +1,67 @@
+<template>
+  <ContentWrap>
+    <!-- 列表 -->
+    <XTable @register="registerTable">
+      <template #toolbar_buttons>
+        <!-- 操作：新增 -->
+        <XButton
+          type="primary"
+          preIcon="ep:zoom-in"
+          :title="t('action.add')"
+          v-hasPermi="['system:post:create']"
+          @click="openModal('create')"
+        />
+        <!-- 操作：导出 -->
+        <XButton
+          type="warning"
+          preIcon="ep:download"
+          :title="t('action.export')"
+          v-hasPermi="['system:post:export']"
+          @click="exportList('岗位列表.xls')"
+        />
+      </template>
+      <template #actionbtns_default="{ row }">
+        <!-- 操作：修改 -->
+        <XTextButton
+          preIcon="ep:edit"
+          v-hasPermi="['system:post:update']"
+          @click="openModal('update', row.id)"
+        />
+        <!-- 操作：详情 -->
+        <XTextButton
+          preIcon="ep:view"
+          v-hasPermi="['system:post:query']"
+          @click="openModal('detail', row.id)"
+        />
+        <!-- 操作：删除 -->
+        <XTextButton
+          preIcon="ep:delete"
+          v-hasPermi="['system:post:delete']"
+          @click="deleteData(row.id)"
+        />
+      </template>
+    </XTable>
+  </ContentWrap>
+  <PostForm ref="modalRef" @success="reload()" />
+</template>
+<script setup lang="ts" name="Post">
+// 业务相关的 import
+import * as PostApi from '@/api/system/post'
+import { allSchemas } from './post.data'
+import PostForm from './PostForm.vue'
+
+const { t } = useI18n() // 国际化
+
+// 列表相关的变量
+const [registerTable, { reload, deleteData, exportList }] = useXTable({
+  allSchemas: allSchemas,
+  getListApi: PostApi.getPostPageApi,
+  deleteApi: PostApi.deletePostApi,
+  exportListApi: PostApi.exportPostApi
+})
+// 表单相关的变量
+const modalRef = ref()
+const openModal = (type: string, rowId?: number) => {
+  modalRef.value.openModal(type, rowId)
+}
+</script>

src/views/system/post/post.data.ts

@@ -0,0 +1,52 @@
+import type { VxeCrudSchema } from '@/hooks/web/useVxeCrudSchemas'
+const { t } = useI18n() // 国际化
+
+// 表单校验
+export const rules = reactive({
+  name: [required],
+  code: [required],
+  sort: [required]
+})
+
+// CrudSchema
+const crudSchemas = reactive<VxeCrudSchema>({
+  primaryKey: 'id',
+  primaryType: 'seq',
+  primaryTitle: '岗位编号',
+  action: true,
+  columns: [
+    {
+      title: '岗位名称',
+      field: 'name',
+      isSearch: true
+    },
+    {
+      title: '岗位编码',
+      field: 'code',
+      isSearch: true
+    },
+    {
+      title: '岗位顺序',
+      field: 'sort'
+    },
+    {
+      title: t('common.status'),
+      field: 'status',
+      dictType: DICT_TYPE.COMMON_STATUS,
+      dictClass: 'number',
+      isSearch: true
+    },
+    {
+      title: '备注',
+      field: 'remark',
+      isTable: false
+    },
+    {
+      title: t('common.createTime'),
+      field: 'createTime',
+      formatter: 'formatDate',
+      isForm: false
+    }
+  ]
+})
+export const { allSchemas } = useVxeCrudSchemas(crudSchemas)