更新记录
0.1.1(2026-06-02) 下载此版本
优化(样式): 统一页面容器高度为100%并清理冗余样式 优化(组件): 修复多组件样式兼容问题,移除不必要的gap和display属性 优化(蓝牙插件): 完善i-ble插件类型定义和导出配置 优化(UI组件): 修复i-ui-x组件的动画和样式兼容问题
0.1.0(2026-06-02) 下载此版本
- 将
ix-table从i-ui-x拆分为独立的 uni_modules 组件插件。 - 新增独立插件元数据、中文使用说明和更新日志。
- 保留列配置、排序、横向滚动、行选择、单元格合并和固定高度滚动能力。
平台兼容性
uni-app x(3.7.8)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
ix-table
表格组件,用于数据表展示、列配置、排序、横向滚动、行选择、单元格合并和固定高度滚动。
插件信息
- 组件名称:
ix-table - 简介:表格组件,用于数据表展示、列配置、排序和横向滚动。
- 标签:表格 数据表 排序 列配置 横向滚动
安装
将本目录放入项目的 src/uni_modules/ix-table。UniAppX 会自动发现 components/ix-table/ix-table.uvue。
基础用法
<template>
<ix-table
:list="baseList"
:columns="baseColumns"
cellWidth="108"
@cellClick="handleCellClick"
@sortChange="handleSortChange"
></ix-table>
</template>
<script setup>
const baseColumns = [
{ title: "姓名", key: "name", width: "96", align: "center" },
{ title: "年龄", key: "age", width: "72", align: "center", sortable: true },
{ title: "地址", key: "address", width: "170", align: "center" },
{ title: "状态", key: "status", width: "90", align: "center" },
];
const baseList = [
{ key: "1", name: "林知夏", age: 34, address: "杭州 西湖区", status: "已审核" },
{ key: "2", name: "周明远", age: 27, address: "上海 浦东新区", status: "待跟进" },
];
function handleCellClick(event) {
console.log(event);
}
function handleSortChange(event) {
console.log(event);
}
</script>
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| list | Array | [] | 表格源数据,建议传对象数组,每行通过 columns 的 key/name 字段取值。 |
| rows | Array | - | 兼容旧版本的行数据,支持 "姓名|年龄|地址" 字符串数组;list 有值时优先使用 list。 |
| columns | Array | - | 列定义,支持字符串或对象;对象常用字段 key/name/dataIndex/title/label/width/align/sortable/style。 |
| height | String | 'auto' | 容器高度;为 auto 时不强制纵向滚动,设置固定高度后可上下滚动。 |
| width | String | '100%' | 容器宽度。 |
| maxHeight | String | '300' | height 为 auto 时的最大高度。 |
| cellHeight | String | '44' | 单元格最小高度,支持 auto、数字、px、rpx。 |
| cellWidth | String | '' | 默认列宽;为空时列宽自动均分。 |
| fontSize | String | '14' | 普通单元格文字大小。 |
| fontColor | String | '#333333' | 普通单元格文字颜色。 |
| headerBgColor | String | '#eeeeee' | 表头背景颜色。 |
| headerFontColor | String | '#333333' | 表头文字颜色。 |
| ripple | Boolean | true | 是否启用隔行底色。 |
| rippleColor | String | '#fafafa' | 隔行底色。 |
| rowCellColor | String | '#ffffff' | 默认行背景。 |
| safeTextWrap | Boolean | false | 是否尽量保持文字单行。 |
| multiRowFloat | Boolean | false | 是否让带 float:true 的数据行表现为 sticky 行。 |
| selectable | Boolean | false | 单元格文字是否允许长按或鼠标选择复制。 |
| refresh | Boolean | false | 是否启用触底刷新事件;传 true 后滚动触底派发 refresh。 |
| showScrollbar | Boolean | false | 是否显示滚动条。 |
| hideHead | Boolean | false | 是否隐藏表头。 |
| showCheck | Boolean | false | 是否显示行选择框。 |
| checkValue | Array | [] | 已选行 key 数组;key 取行数据 key/id 字段,缺失时取行索引。 |
Events
| 事件名 | 说明 |
|---|---|
| cellClick | 点击单元格时触发,返回 item、key、value、rowIndex、columnIndex。 |
| refresh | 开启 refresh 后滚动到底部触发,用于分页加载。 |
| checkChange | 行选中变化时触发,返回选中的行 key 数组。 |
| sortChange | 点击 sortable 列表头时触发,返回 key 和 order,order 为空表示还原原始顺序。 |
| update:checkValue | 支持 v-model:checkValue 同步选中项。 |
| click | 兼容事件,点击单元格时触发。 |
| select | 兼容事件,切换选择时触发。 |
| change | 兼容事件,切换选择时触发。 |
Slots
| 插槽名 | 说明 |
|---|---|
| refresh | 自定义触底刷新区域内容。 |
Methods
无公开 Methods。
演示页面
项目演示页位于 src/subpkg/data/table/index.uvue,包含效果演示、Props 调试和 API 说明。

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 11
赞赏 0
下载 12137005
赞赏 1918
赞赏
京公网安备:11010802035340号