列表视图 ListView
示例
基本形式
<listView>
<item>选项1</item>
<item>选项2</item>
<item>选项3</item>
</listView>
value和selected
<div class="g-row">
<div class="g-col g-col-6">
<listView value=2>
<item value=1>选项1</item>
<item value=2>选项2</item>
<item value=3>选项3</item>
</listView>
</div>
<div class="g-col g-col-6">
<listView>
<item value=1>选项1</item>
<item value=2>选项2</item>
<item value=3 selected>选项3</item>
</listView>
</div>
</div>
只读,禁用,禁用某一项
<div class="g-row">
<div class="g-col g-col-4">
<listView readonly>
<item>选项1</item>
<item>选项2</item>
<item selected>选项3</item>
</listView>
</div>
<div class="g-col g-col-4">
<listView disabled>
<item>选项1</item>
<item>选项2</item>
<item>选项3</item>
</listView>
</div>
<div class="g-col g-col-4">
<listView>
<item>选项1</item>
<item>选项2</item>
<item disabled>选项3(禁用)</item>
</listView>
</div>
</div>
分隔线
<listView>
<item>选项1</item>
<item>选项2</item>
<item divider />
<item disabled>选项3(禁用)</item>
</listView>
多选
<listView multiple>
<item>选项1</item>
<item selected>选项2</item>
<item>选项3</item>
<item disabled>选项4(禁用)</item>
<item selected>选项5</item>
</listView>
可取消
<listView cancelable>
<item>选项1</item>
<item>选项2</item>
<item selected>选项3</item>
</listView>
自定义
<listView>
{#list list as item}
<item>
<span class="number">{item_index + 1}.</span>
<span class="title">{item.course}</span>
<span class="hits f-fr">{item.hits}</span>
</item>
{/list}
</listView>
let component = new RGUI.Component({
template: template,
data: {
list: [
{course: '精通Javascript开发', org: '前端Funs', hits: 42371},
{course: 'Android深入浅出', org: 'Android学院', hits: 30645},
{course: 'cocos2dx游戏开发教程', org: '鱼C课程', hits: 25112},
{course: 'MySQL数据库', org: 'LAMP兄弟连', hits: 18089},
{course: 'Arduino初级教程', org: '硬件社', hits: 16361},
]
}
});
数据绑定
<listView value={value}>
<item value=1>选项1</item>
<item value=2>选项2</item>
<item value=3 selected>选项3</item>
</listView>
当前选择值:{value + ''}
事件
请打开浏览器的控制台查看结果。
<listView value={value}
on-select={console.log('on-select:', '$event:', $event)}
on-change={console.log('on-change:', '$event.value:', $event.value)}>
<item value=1>选项1</item>
<item value=2>选项2</item>
<item value=3 selected>选项3</item>
</listView>
API
Class
ListView
继承自。
Options
new ListView()
参数 | 类型 | 默认值 | 数据流向 | 描述 |
---|---|---|---|---|
data | Object | 绑定属性 | ||
data.value | var | outside <=> inside | 当前选择的值 | |
data.multiple | boolean | false | outside => inside | 是否可以多选 |
data.cancelable | boolean | false | outside => inside | 是否可以取消选择 |
data.readonly | boolean | false | outside => inside | 是否只读 |
data.disabled | boolean | false | outside => inside | 是否禁用 |
data.visible | boolean | true | outside => inside | 是否显示 |
data.class | string | '' | outside => inside | 补充class |
Methods
listView.select(item)
选择某一项
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
item | Item | 选择项 | |
返回值 | 类型 | 描述 | |
无返回值 |
Events
listView.$on('change')
选择值改变时触发
属性 | 类型 | 描述 |
---|---|---|
sender | object | 事件发送对象 |
selected | Item | 改变后的选择项 |
value | var | 改变后的选择值 |
listView.$on('select')
选择某一项时触发
属性 | 类型 | 描述 |
---|---|---|
sender | object | 事件发送对象 |
selected | Item | 当前选择项 |
value | var | 当前选择值 |