更新记录

1.0.0（2026-06-05） 下载此版本

Initial Release

• 初始版本发布
• 支持远程表格和本地表格
• 内置权限控制
• 事件系统
• 树形数据支持
• 本地条件过滤

平台兼容性

uni-app(3.7.9)

uni-app x(3.7.9)

dk-table

一个功能强大的表格组件，支持本地数据和远程数据，内置权限控制和事件系统。

安装

# 已包含在项目 uni_modules 中

快速开始

引入

import {
  createTableState,
  DefaultTableContext,
  LocalTable,
  LocalTableContext,
  RemoteTable,
  executeCondition,
  buildTreeByPid,
  registerConditionHandler,
  DefaultPublishEvent,
  CheckAccessEleType,
  createCheckAccessHook,
  resourceAccessItems,
  toCheckAccessMap,
  CheckboxSelection,
  DefaultQuery,
  normalizeFetchResult
} from '@/uni_modules/dk-table';

远程表格示例

import { createTableState, RemoteTable } from '@/uni_modules/dk-table';

const state = createTableState({ name: 'users', defaultPageSize: 20 });

const controller = new RemoteTable({
  name: 'users',
  fetch: (request) => api.searchUsers(request)
});

const result = controller.load(
  {
    name: 'users',
    fetch: (request) => api.searchUsers(request)
  },
  state,
  (next) => Object.assign(state, next),
  1
);

result.ctx.search();

本地表格示例

import { createTableState, LocalTable } from '@/uni_modules/dk-table';

const state = createTableState({ name: 'permissions', defaultPageSize: 50 });

const controller = new LocalTable({
  name: 'permissions',
  fetch: () => api.permissions(),
  isTreeData: true
});

const result = controller.load(
  {
    name: 'permissions',
    fetch: () => api.permissions(),
    isTreeData: true
  },
  state,
  (next) => Object.assign(state, next),
  1
);

result.ctx.search();

权限控制示例

import { createTableState, RemoteTable, createCheckAccessHook, resourceAccessItems } from '@/uni_modules/dk-table';

const accessItems = resourceAccessItems('admin');
const checkaccessHook = createCheckAccessHook(accessItems);

const state = createTableState({ name: 'users', defaultPageSize: 20 });
const controller = new RemoteTable(
  {
    name: 'users',
    fetch: api.searchUsers
  },
  checkaccessHook
);

const result = controller.load(
  {
    name: 'users',
    fetch: api.searchUsers
  },
  state,
  (next) => Object.assign(state, next),
  1
);

// 使用权限
result.ctx.can('search');
result.ctx.can('add');
result.ctx.canv('search', '允许', '禁止');

API

createTableState(config, overrides)

创建表格状态对象

参数

• config: 配置对象
  • defaultPageNumber: 默认页码
  • defaultPageSize: 默认每页数量
  • defaultSorts: 默认排序
• overrides: 覆盖配置

返回

• 表格状态对象

DefaultTableContext

表格上下文类

方法

• search(searchBody): 搜索
• reset(): 重置
• refresh(isRefreshConfig): 刷新
• pageChange(number, size): 页码改变
• pageSizeChange(size): 每页数量改变
• pageNumberChange(number): 页码改变
• registerEvent(name, fn): 注册事件
• publish(name, params): 发布事件
• setMethod(name, fn): 设置方法
• getMethod(name): 获取方法
• tableSelectionChange(values): 表格选择改变
• tableSelectionConfirmValues(callback): 确认选择
• tableSelectionClean(): 清除选择
• tableSlectionValue(): 获取选择值
• request(): 获取请求参数
• tableConfig(): 获取表格配置
• name(): 获取名称
• can(key): 检查权限
• canv(key, success, failure): 检查权限并返回结果

RemoteTable

远程表格控制器

LocalTable

本地表格控制器

createCheckAccessHook(items, user)

创建权限检查钩子

resourceAccessItems(name)

生成资源权限项

buildTreeByPid(data, options)

构建树形数据

registerConditionHandler(type, handler)

注册条件处理器

依赖

• dk-store

许可证

MIT