列表视图 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()

参数类型默认值数据流向描述
dataObject绑定属性
data.valuevaroutside <=> inside当前选择的值
data.multiplebooleanfalseoutside => inside是否可以多选
data.cancelablebooleanfalseoutside => inside是否可以取消选择
data.readonlybooleanfalseoutside => inside是否只读
data.disabledbooleanfalseoutside => inside是否禁用
data.visiblebooleantrueoutside => inside是否显示
data.classstring''outside => inside补充class

Methods

listView.select(item)

选择某一项

参数类型默认值描述
itemItem选择项
返回值类型描述
无返回值

Events

listView.$on('change')

选择值改变时触发

属性类型描述
senderobject事件发送对象
selectedItem改变后的选择项
valuevar改变后的选择值

listView.$on('select')

选择某一项时触发

属性类型描述
senderobject事件发送对象
selectedItem当前选择项
valuevar当前选择值