更新记录

0.1.1(2026-06-02) 下载此版本

优化(样式): 统一页面容器高度为100%并清理冗余样式 优化(组件): 修复多组件样式兼容问题,移除不必要的gap和display属性 优化(蓝牙插件): 完善i-ble插件类型定义和导出配置 优化(UI组件): 修复i-ui-x组件的动画和样式兼容问题

0.1.0(2026-06-02) 下载此版本

  • ix-tablei-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 说明。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。