第一个CRUD

接下来介绍如何开发你的第一个CRUD

TIP

强烈建议您先从运行demo开始，然后在demo里面写一个crud来感受一下

在demo里面开发一个crud

进入到demo目录下packages/fs-admin/fs-admin-antdv 或 packages/demo-element

一个crud主要分为3个部分

• crud.ts： crud配置
• index.vue： 页面组件
• api.ts： 接口
• mock.ts： 接口mock数据，可选

1. crud.ts

crud配置，每个crud最大的不同就在于此文件。
将如下代码保存为views/test/myFirstCrud/crud.ts

import { CreateCrudOptionsProps, CreateCrudOptionsRet, dict } from "@fast-crud/fast-crud";
import { addRequest, delRequest, editRequest, pageRequest } from "./api";

/**
 * 定义一个CrudOptions生成器方法
 */
export default async function  ({ crudExpose, context }: CreateCrudOptionsProps): Promise<CreateCrudOptionsRet> {
  return {
    crudOptions: {
      // 在这里自定义你的crudOptions配置
      request: {
        pageRequest,
        addRequest,
        editRequest,
        delRequest
      },
      //这里定义两个字段
      columns: {
        name: {
          title: "姓名",
          type: "text", //字段类型，fs会根据字段类型，生成出一些默认配置
          search: { show: true },
          column: { //表格列的一些配置
            resizable: true,
            width: 200
          }
        },
        type: {
          title: "类型",
          type: "dict-select",
          dict: dict({
            data: [
              { value: 1, label: "开始" },
              { value: 0, label: "停止" }
            ]
          })
        }
      }
    }
  };
}

TIP

你可以尝试在 crudOptions.columns下添加更多字段

2. index.vue

页面组件内容都一样，实际开发中，直接复制，修改一下name即可
将如下代码保存为views/test/myFirstCrud/index.vue

<template>
    <fs-page>
        <fs-crud ref="crudRef" v-bind="crudBinding" />
    </fs-page>
</template>

<script lang="ts" setup>
    import { onMounted } from "vue";
    import { useFsAsync ,useFsRef} from "@fast-crud/fast-crud";
    import createCrudOptions from "./crud";
  
    const { crudRef, crudBinding, context } = useFsRef();
    // context.xxx = xxx //可以传递自定义变量到crud.tsx
    // 页面打开后获取列表数据
    onMounted(async () => {
        const { crudExpose } = await useFsAsync({  crudRef, crudBinding,  context, createCrudOptions});
        crudExpose.doRefresh();
    });
    
</script>

WARNING

注意，由于fs-crud默认高度为100%,所以你必须让<fs-crud></fs-crud>的父容器具备高度，或者直接给fs-crud本身设置高度

3. api.ts

实现添删改查请求接口，实际开发中，复制后修改url即可，你也可以根据实际业务需求增加和修改方法
将如下代码保存为views/test/myFirstCrud/api.ts

import { AddReq, DelReq, EditReq, UserPageQuery, UserPageRes } from "@fast-crud/fast-crud";
import _ from "lodash-es";

/**
 * 此处本地方式模拟远程接口，实际开发，你需要替换成你的后台请求
 */
const records = [{ id: 1, name: "Hello World", type: 1 }]
export const pageRequest = async (query: UserPageQuery): Promise<UserPageRes> => {
    return {
        records:_.cloneDeep(records), //此处跟fs所需字段一致，无需转换
        offset: 0, //后续会在transformRes里面做转化，转换为currentPage
        limit: 20,//后续会在transformRes里面做转化，转换为pageSize
        total: records.length
    };
};
export const editRequest = async ({ form, row }: EditReq) => {
    const target = _.find(records, (item) => {
        return row.id === item.id;
    });
    _.merge(target, form);
    return target;
};
export const delRequest = async ({ row }: DelReq) => {
    _.remove(records, (item) => {
        return item.id === row.id;
    });
};
export const addRequest = async ({ form }: AddReq) => {
    const maxRecord = _.maxBy(records, (item) => {
        return item.id;
    });
    form.id = (maxRecord?.id || 0) + 1;
    records.push(form);
    return form;
};

TIP

此处以本地方式模拟远程接口，实际开发，你需要替换成你的后台请求

WARNING

实际开发过程中，你后台接口返回的数据大概率与fast-crud所需要的数据结构是不一致的，所以你需要配置公共的request转化方法，将请求结果转化为fast-crud所需要的结构
具体请参考request配置

4. 添加路由和菜单

在src/router/modules/crud.ts中增加路由菜单配置

// src/router/modules/crud.ts
export const crudResources = [
    {
        title: "CRUD示例",
        name: "crud",
        path: "/crud",
        redirect: "/crud/basis",
        meta: {
            icon: "ion:apps-sharp"
        },
        children: [
            // ↓↓↓↓↓↓↓↓↓在此位置增加路由配置↓↓↓↓↓↓↓↓↓↓
            {
                title: "myFirstCrud",
                name: "myFirstCrud",
                path: "/test/myFirstCrud",
                component: "/test/myFirstCrud/index.vue"
            },
        ]
    }
]

TIP

你也可以在src/router/resource/modules目录中仿照crud.ts新增你自己的顶级菜单,将其加入framework.ts的children中即可。

6. 看看效果

启动demo，访问myFirstCrud查看效果

恭喜，你已经完成了第一个crud功能的开发

实际项目中开发CRUD

在实际项目开发中，通常在示例的views中找一个合适的crud复制到你的项目的views，然后再根据需求修改即可

WARNING

注意：需要修改api.ts的requestForMock为request，这样才会去调用你的真实后端接口