listview

列表(listview)控件介绍

列表(listview)用于显示和操作多条数据。

函数-addData

添加数据。
参数:
参数名 类型 必填 说明
data string/array 必填 如果是数组则数组里所有数据都添加
index integer 选填 从index位置开始插入,默认在最后添加数据
<template>
    <linear>
        <listView id="lv"/>
    </linear>
</template>

function main() {
    setupUI();

    var listview = ui('lv');
    listview.addData('hello');
    listview.addData(['hello', 'world']);
}

函数-setData

设置数据,覆盖以前的数据。
参数:
参数名 类型 必填 说明
data array 必填 数据
<template>
    <linear>
        <listView id="lv"/>
    </linear>
</template>

function main() {
    setupUI();

    var listview = ui('lv');
    listview.setData(['hello', 'world']);
}

函数-update

更新指定位置的数据。
参数:
参数名 类型 必填 说明
data string 必填 数据
index integer 必填 位置信息
<template>
    <linear>
        <listView id="lv"/>
    </linear>
</template>

function main() {
    setupUI();

    var listview = ui('lv');
    listview.update('hello', 1);
}

函数-getData

获取数据,返回数组。
参数:
参数名 类型 必填 说明
index integer 选填 获取index处的数据,默认返回所有数据
<template>
    <linear>
        <listView id="lv"/>
    </linear>
</template>

function main() {
    setupUI();

    var listview = ui('lv');
    var allData = listview.getData();
    var data = listview.getData(1);
}

事件-onItemClick

点击列表事件。
<template>
    <linear>
        <listView onItemClick="onItemClick"/>
    </linear>
</template>

function main() {
    setupUI();
}

function onItemClick(view, position) {
    console.log('item click position:' + position);
}

事件-onItemLongClick

长按列表事件。
<template>
    <linear>
        <listView onItemLongClick="onItemLongClick"/>
    </linear>
</template>

function main() {
    setupUI();
}

function onItemLongClick(view, position) {
    console.log('item long click position:' + position);
}