Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Ronaldo_717
unidocs-zh
提交
d6635315
U
unidocs-zh
项目概览
Ronaldo_717
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
d6635315
编写于
7月 07, 2022
作者:
DCloud-WZF
💬
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs(uni-table): 修复 th events 显示错位问题
上级
1f5ef20c
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
158 addition
and
158 deletion
+158
-158
docs/component/uniui/uni-table.md
docs/component/uniui/uni-table.md
+158
-158
未找到文件。
docs/component/uniui/uni-table.md
浏览文件 @
d6635315
::: tip 组件名:uni-table
> 代码块: `uTable`
[
点击下载&安装
](
https://ext.dcloud.net.cn/plugin?name=uni-table
)
:::
用于展示多条结构类似的数据
## 介绍
### 基本用法
表格是由4个组件:
`uni-table`
表格组件、
`uni-tr`
表格行 、
`uni-th`
表格头、
`uni-td`
单元格组成
需要注意的是:
-
`uni-table`
的根节点一定是
`uni-tr`
-
`uni-tr`
的根节点一定是
`uni-th`
或者
`uni-td`
-
一个表格内理论上只能包含表头行
-
目前只能在
`uni-th`
中设置 width 属性,
`uni-td`
的宽度跟随
`uni-th`
宽度变化
```
html
<uni-table
border
stripe
emptyText=
"暂无更多数据"
>
<!-- 表头行 -->
<uni-tr>
<uni-th
align=
"center"
>
日期
</uni-th>
<uni-th
align=
"center"
>
姓名
</uni-th>
<uni-th
align=
"left"
>
地址
</uni-th>
</uni-tr>
<!-- 表格数据行 -->
<uni-tr>
<uni-td>
2020-10-20
</uni-td>
<uni-td>
Jeson
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-21
</uni-td>
<uni-td>
HanMeiMei
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-22
</uni-td>
<uni-td>
LiLei
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-23
</uni-td>
<uni-td>
Danner
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
</uni-table>
```
## API
### Table Props
|属性名| 类型|默认值| 可选值| 说明|
|:-:| :-:|:-:| :-:| :-: |
|border| Boolean| false| -| 是否带有纵向边框 |
|stripe| Boolean| true| -| 是否显示斑马线样式 |
|type| String| ''| -| 值为type="selection" 时开启多选|
|emptyText | String| 没有更多数据| -| 空数据时显示的文本内容|
|loading| Boolean| false| -| 显示加载中|
### Table Events
|事件称名|说明| 返回参数 |
|:-:|:-:| :-: |
|selection-change| 开启多选时,当选择项发生变化时会触发该事件 | Function(Object)|
### Table Methods
**Tips: 因微信小程序框架问题,暂不支持如下方法**
|方法称名|说明|参数|
|:-:|:-:|:-:|
|selectionAll|选中全部行 |- |
|toggleRowSelection |用于多选表格,切换某一行的选中状态,如果使用了第二个参数,则是设置这一行选中与否(selected 为 true 则选中) | Function(Array:[行索引],Boolean:selected) |
|clearSelection |用于多选表格,清空用户的选择 |- |
|toggleAllSelection |用于多选表格,切换所有行的选中状态 |- |
### Th Props
|属性名|类型|默认值|可选值|说明|
|:-:|:-: |:-:| :-:|:-:|
|width|String | -|-| 单元格宽度|
|align|String | left|left/center/right| 表头对齐方式|
|filter-type|String ||search/select/range/date | 筛选类型,search关键字搜索,select类别选择|
|filter-data|Array ||| 筛选数据|
|sortable |Boolean| false|- | 是否启用排序|
**filter-data 示例**
```
json
[{
text:
""
,
//显示
value:
""
//
值
}]
```
### Th Events
|事件称名 |说明 | 返回参数 |
|:-: |:-: | :-: |
|
|sort-change | 点击排序时会触发该事件 | Function(Object)|
|
|filter-change | 筛选数据时会触发该事件 | Function(Object)|
filter-change(e) 说明
```
json
e
=
{
filterType:
""
,
//筛选类型
search/select/range
和传入的相同
filter:
""
//
值
,
filterType=search字符串类型,filterType=select数组类型,filterType=range数组类型,
[
0
]
开始值,
[
1
]
结束值
}
```
### Td Props
|属性名 |类型 |默认值 |可选值 |说明|
|:-: |:-: |:-: |:-: |:-:|
|align |String | left |left/center/right | 单元格对齐方式|
## 示例
::: warning 注意
示例依赖了
`uni-card`
`uni-section`
`uni-scss`
等多个组件,直接拷贝示例代码将无法正常运行 。
请到
[
组件下载页面
](
https://ext.dcloud.net.cn/plugin?name=uni-table
)
,在页面右侧选择
`使用 HBuilderX导入示例项目`
,体验完整组件示例。
:::
::: preview https://hellouniapp.dcloud.net.cn/pages/extUI/table/table
> Template
```
html
::: tip 组件名:uni-table
> 代码块: `uTable`
[
点击下载&安装
](
https://ext.dcloud.net.cn/plugin?name=uni-table
)
:::
用于展示多条结构类似的数据
## 介绍
### 基本用法
表格是由4个组件:
`uni-table`
表格组件、
`uni-tr`
表格行 、
`uni-th`
表格头、
`uni-td`
单元格组成
需要注意的是:
-
`uni-table`
的根节点一定是
`uni-tr`
-
`uni-tr`
的根节点一定是
`uni-th`
或者
`uni-td`
-
一个表格内理论上只能包含表头行
-
目前只能在
`uni-th`
中设置 width 属性,
`uni-td`
的宽度跟随
`uni-th`
宽度变化
```
html
<uni-table
border
stripe
emptyText=
"暂无更多数据"
>
<!-- 表头行 -->
<uni-tr>
<uni-th
align=
"center"
>
日期
</uni-th>
<uni-th
align=
"center"
>
姓名
</uni-th>
<uni-th
align=
"left"
>
地址
</uni-th>
</uni-tr>
<!-- 表格数据行 -->
<uni-tr>
<uni-td>
2020-10-20
</uni-td>
<uni-td>
Jeson
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-21
</uni-td>
<uni-td>
HanMeiMei
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-22
</uni-td>
<uni-td>
LiLei
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
<uni-tr>
<uni-td>
2020-10-23
</uni-td>
<uni-td>
Danner
</uni-td>
<uni-td>
北京市海淀区
</uni-td>
</uni-tr>
</uni-table>
```
## API
### Table Props
|属性名| 类型|默认值| 可选值| 说明|
|:-:| :-:|:-:| :-:| :-: |
|border| Boolean| false| -| 是否带有纵向边框 |
|stripe| Boolean| true| -| 是否显示斑马线样式 |
|type| String| ''| -| 值为type="selection" 时开启多选|
|emptyText | String| 没有更多数据| -| 空数据时显示的文本内容|
|loading| Boolean| false| -| 显示加载中|
### Table Events
|事件称名|说明| 返回参数 |
|:-:|:-:| :-: |
|selection-change| 开启多选时,当选择项发生变化时会触发该事件 | Function(Object)|
### Table Methods
**Tips: 因微信小程序框架问题,暂不支持如下方法**
|方法称名|说明|参数|
|:-:|:-:|:-:|
|selectionAll|选中全部行 |- |
|toggleRowSelection |用于多选表格,切换某一行的选中状态,如果使用了第二个参数,则是设置这一行选中与否(selected 为 true 则选中) | Function(Array:[行索引],Boolean:selected) |
|clearSelection |用于多选表格,清空用户的选择 |- |
|toggleAllSelection |用于多选表格,切换所有行的选中状态 |- |
### Th Props
|属性名|类型|默认值|可选值|说明|
|:-:|:-: |:-:| :-:|:-:|
|width|String | -|-| 单元格宽度|
|align|String | left|left/center/right| 表头对齐方式|
|filter-type|String ||search/select/range/date | 筛选类型,search关键字搜索,select类别选择|
|filter-data|Array ||| 筛选数据|
|sortable |Boolean| false|- | 是否启用排序|
**filter-data 示例**
```
json
[{
text:
""
,
//显示
value:
""
//
值
}]
```
### Th Events
|事件称名 |说明 | 返回参数 |
|:-: |:-: | :-: |
|
sort-change | 点击排序时会触发该事件 | Function(Object)|
|
filter-change | 筛选数据时会触发该事件 | Function(Object)|
filter-change(e) 说明
```
json
e
=
{
filterType:
""
,
//筛选类型
search/select/range
和传入的相同
filter:
""
//
值
,
filterType=search字符串类型,filterType=select数组类型,filterType=range数组类型,
[
0
]
开始值,
[
1
]
结束值
}
```
### Td Props
|属性名 |类型 |默认值 |可选值 |说明|
|:-: |:-: |:-: |:-: |:-:|
|align |String | left |left/center/right | 单元格对齐方式|
## 示例
::: warning 注意
示例依赖了
`uni-card`
`uni-section`
`uni-scss`
等多个组件,直接拷贝示例代码将无法正常运行 。
请到
[
组件下载页面
](
https://ext.dcloud.net.cn/plugin?name=uni-table
)
,在页面右侧选择
`使用 HBuilderX导入示例项目`
,体验完整组件示例。
:::
::: preview https://hellouniapp.dcloud.net.cn/pages/extUI/table/table
> Template
```
html
<template>
<view>
<view
class=
"uni-container"
>
...
...
@@ -165,8 +165,8 @@ e = {
</view>
</view>
</template>
```
> Script
```
> Script
```
html
<script>
import
tableData
from
'
./tableData.js
'
...
...
@@ -204,7 +204,7 @@ export default {
},
// 分页触发
change
(
e
)
{
this
.
$refs
.
table
.
clearSelection
()
this
.
$refs
.
table
.
clearSelection
()
this
.
selectedIndexs
.
length
=
0
this
.
getData
(
e
.
current
)
},
...
...
@@ -257,24 +257,24 @@ export default {
}
}
</script>
```
> Style
```
> Style
```
html
<style>
/* #ifndef H5 */
/* page {
padding-top: 85px;
} */
/* #endif */
.uni-group
{
display
:
flex
;
align-items
:
center
;
/* #endif */
.uni-group
{
display
:
flex
;
align-items
:
center
;
}
</style>
```
> tableData.js
```
javascript
</style>
```
> tableData.js
```
javascript
export
default
[{
"
date
"
:
"
2020-09-01
"
,
"
name
"
:
"
Dcloud1
"
,
...
...
@@ -467,9 +467,9 @@ export default [{
"
date
"
:
"
2020-09-16
"
,
"
name
"
:
"
Dcloud48
"
,
"
address
"
:
"
上海市普陀区金沙江路 1516 弄
"
}]
```
:::
}]
```
:::
[
完整示例演示
](
https://hellouniapp.dcloud.net.cn/pages/extUI/table/table
)
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录