轮播表可以单条轮播也可以整页轮播,支持点击事件,展示数据使用v-html渲染,因此你可以传递html
字符串,定制个性化元素。
::: tip TIP
组件内部没有设置deep
监听props,数据变更时,请生成新的props,不然组件将无法刷新状态
this.config.data = ['foo', 'foo']
是无效的
this.config = { data: ['foo', 'foo'] }
才是有效的
:::
<dv-scroll-board :config="config" style="width:500px;height:220px" />
<<< @/docs/guide/codeData/scrollBoard/demo1.js
<<< @/docs/guide/codeData/scrollBoard/demo2.js
<<< @/docs/guide/codeData/scrollBoard/demo3.js
<<< @/docs/guide/codeData/scrollBoard/demo4.js
<<< @/docs/guide/codeData/scrollBoard/demo5.js
属性|说明|类型|可选值|默认值
:--:|:--:|:--:|:--:|:--:
header|表头数据|Array<String>
|---|[]
data|表数据|Array<Array>
|---|[]
rowNum|表行数|Number
|---|5
headerBGC|表头背景色|String
|---|'#00BAFF'
oddRowBGC|奇数行背景色|String
|---|'#003B51'
evenRowBGC|偶数行背景色|String
|---|#0A2732
waitTime|轮播时间间隔(ms)|Number
|---|2000
headerHeight|表头高度|Number
|---|35
columnWidth|列宽度|Array<Number>
|[1]|[]
align|列对齐方式|Array<String>
|[2]|[]
index|显示行号|Boolean
|true|false
|false
indexHeader|行号表头|String
|-
|'#'
carousel|轮播方式|String
|'single'|'page'
|'single'
[1] columnWidth
可以配置每一列的宽度,默认情况下每一列宽度相等。
[2] align
可以配置每一列的对齐方式,可选值有'left'|'center'|'right'
,默认值为'left'
。
::: tip TIP
columnWidth
与align
允许尾部缺省:
// 三列轮播表
columnWidth: [50]
// 剩下两列宽度将自动计算
:::
当单元格被点击时(表头不支持),轮播表将抛出一个click
事件,包含被点击的单元格的相关数据,打开控制台并点击上面例子中的轮播表可以查看事件数据。
属性|说明|类型|可选值|默认值
:--:|:--:|:--:|:--:|:--:
row|所在行数据|Array<String>
|---|---
ceil|单元格数据|Array<Array>
|---|[]
rowIndex|行索引|Number
|---|---
columnIndex|列索引|Number
|---|---