Listview列表组件
- 依赖
- JS对象
  - 函数
  - 范例

Listview列表组件

列表组件是根据AppCan 布局框架对数据列表进行封装的JS对象，通过配合的样式，使开发者在界面中可以快速完成列表控件的开发。

依赖

appcan.js
appcan.control.js
appcan.listview.js
appcan.control.css

JS对象

函数

appcan.listview({参数})

selector:   /*选择器*/, 
type:   thinLine or thickLine /*窄行和宽行设定*/,  
hasIcon:   true or false /*是否有图片*/, 
hasAngle:   true or false /*是否有右侧箭头*/, 
hasSubTitle:   true or false /*是否有子标题*/, 
hasTouchEffect:   true or false /*是否有点击效果*/, 
hasCheckbox:   true or false /*是否有复选按钮*/, 
hasRadiobox:   true or false /*是否有单选按钮*/, 
align:   "left" or "right" /*checkbox和radiobox居左还是居右*/, 
multiLine:  1 2 or 3 /*主标题文字占用最大行数。到达行数显示不全使用…替换*/, 
touchClass:   'sc-bg-active' or 用户自定义 /*列表条目点击效果CSS类*/, 
hasControl:   true or false /*列表条目中是否包含switch组件。*/ 
hasGroup:   true or false /*列表条目是否以分组的形式展示。*/

示例

    var lv = appcan.listview({
      selector : "#listview",
      type : "thinLine",
      hasIcon : false,
      hasAngle : false,
      hasSubTitle : false,
      hasTouchEffect:true,
      hasCheckbox: false,
      hasRadiobox: false,
      align:"left",
      multiLine : 1,
      touchClass : 'sc-bg-active',
      hasControl: false,
      hasGroup: false
      });

方法：set(data)

参数

data:JSON   对象数组，用于存储列表条目显示的文字图片等信息。

示例

    lv.set([{
        title : "中国红",
          subTitle : '<div class="umh1 umw3 us" style="background-color:#DF3031"></div>',
      }, {
          title : "蜜桃粉",
         subTitle : '<div class="umh1 umw3 us" style="background-color:#EC6897"></div>',
      }, {
          title : "青草绿",
          subTitle : '<div class="umh1 umw3 us" style="background-color:#66C669"></div>',
      }, {
          title : "天际蓝",
          subTitle : '<div class="umh1 umw3 us" style="background-color:#00A0E9"></div>',
      }, {
          title : "子夜灰",
          subTitle : '<div class="umh1 umw3 us" style="background-color:#434343"></div>',
      }]);

方法：add(data,dir)

参数

data: JSON 对象数组，用于存储列表条目显示的文字图片等信息。 
dir: 0 or 1  用于设定数据是在列表前部添加还是后部添加。0为前部添加，1为后部添加。默认为0

示例

    lv1.add([{
        title : "金黄",
        subTitle : '<div class="umh1 umw3 us" style="background-color:#FFD700"></div>'}]
    ,1);

事件：click

列表条目备点击时调用此事件

参数

Obj  列表条目DOM对象 
Data 列表条目对应数据源对象
subObj 列表条目点击时的子元素DOM对象例如图片

示例：

    var lvData =
        [{
            title : "uexWheel",
            describe : '轮盘菜单 ',
            pagename : "uexWheel",
            pageurl:"UIapi/uexWheel.html"
        },{
            title : "uexWheel2",
            describe : '轮盘菜单2 ',
            pagename : "uexWheel2",
            pageurl:"UIapi/uexWheel2.html"
        }];
    lv1.set(lvData);
    lv1.on("click",function(obj,data,subObj){
        console.log(obj);
        console.log(data);
        console.log(subObj);
        appcan.window.open(data.pagename,data.pageurl,10);
    })

事件：checkbox:change

列表条目复选框变更时产生此事件

参数：

Obj   列表条目DOM对象 
Data  列表条目对应数据源对象，其中checked属性代表选择状态

示例：

    lv1.on("checkbox:change",function(obj,data){
        console.log(obj);
        console.log(data);
    })

事件：radio:change

列表单选框变更时产生此事件

参数：

Obj   列表条目DOM对象 
Data  列表条目对应数据源对象 其中checked属性代表选择状态

示例：

    lv1.on("radio:change",function(obj,data){
        console.log(obj);
        console.log(data);
    })

事件：switch:change

列表条目中的switch控件变更时产生此事件

参数：

Obj   列表条目DOM对象 
Data  列表条目对应数据源对象 其中switchBtn.value代表switch状态,switchBtn.mini代表switch的样式

示例：

    lv1.on("switch:change",function(obj,data){
        console.log(obj);
        console.log(data);
    })

范例

HTML5代码:

    <div id="listview" class="ubt sc-border sc-bg">
    </div>

JS代码

   有icon:set(data)中的JSON

    var hasSmallIcon =
        [{
            title : "ISIS分支宣布将一法国人斩首。该组织声称如果法国不停止打击ISIS，将杀掉人质",
            describe:"",
            note : "",
            subTitle : "",
            subDescribe : "",
            subNote : "12:03",
            icon : "../css/res/appcan_s.png",
            icontitle:"",
            "switchBtn":{
                mini:true,
                value:true
            }
        }];
    lv1.set(hasSmallIcon);

单选列表

var lv = appcan.listview({
      selector : "#listview",
      type : "thinLine",
      hasIcon : false,
      hasAngle : false,
      hasSubTitle : false,
      multiLine : 1,
      hasRadiobox : true,
      align : 'left'
  });
  lv.set([{
      title : "中国红",
      subTitle : '<div class="umh1 umw3 us" style="background-color:#DF3031"></div>',
  }, {
      title : "蜜桃粉",
      subTitle : '<div class="umh1 umw3 us" style="background-color:#EC6897"></div>',
  }, {
      title : "青草绿",
      subTitle : '<div class="umh1 umw3 us" style="background-color:#66C669"></div>',
  }, {
      title : "天际蓝",
      subTitle : '<div class="umh1 umw3 us" style="background-color:#00A0E9"></div>',
  }, {
      title : "子夜灰",
      subTitle : '<div class="umh1 umw3 us" style="background-color:#434343"></div>',
  }]);

带switch控件列表

var lv1 = appcan.listview({
            selector : "#listview",
            type : "thinLine",
            hasIcon : false,
            hasAngle : false,
            hasControl:true,//包含控件
        });
        lv1.set([{
            title : "Switch:false",
            "switchBtn":{//switch控件配置
                value:false,
                mini:true
            }
        },{
            title : "Switch:true",
            "switchBtn":{
                value:true,
                mini:true
            }
        }
]);
        lv1.on("switch:change",function(obj,data){
            lv1.updateItem(obj,"title","Switch:"+data.switchBtn.value);
        })

以组的形式展示的列表

var lv1 = appcan.listview({
                selector : "#listview",
                type : "thinLine",
                hasGroup : true,
                hasAngle : false
            });
            lv1.set([{
                title : "A",
                groupId : "A",
                items : [{
                    title : "上海伯母杀婴案开庭 嫌犯忏悔",
                icon : "../css/res/appcan_s.png"
            }, {
                title : "百万日军投降，武器去向如何？国共并非对半分！",
                icon : "../css/res/appcan_s.png"
                }, {
                    title : "港媒：占中不得人心，内讧频繁！！",
                    icon : "../css/res/appcan_s.png"
                }]
            }, {
                title : "B",
                groupId : "B",
                items : [{
                    title : "iPhone6 本月将登陆韩国：三星或兵败家门口",
                icon : "../css/res/appcan_s.png"
                }, {
                    title : "苹果前雇员为乔帮主洗冤：个性强烈非恶意",
                    icon : "../css/res/appcan_s.png"
                }]
            }]);

注：更多Listview示例详见官网首页功能演示App:HiAppcan