工具位置

• 列表控件

拖放到画面之后的效果

画面效果

方法

• pkmobilelist.setData(objectname,jsonData)，设定所有列表项的内容，包括文本、徽标、图片。
  • jsonData是json格式的，最多支持4行文本。jsonData=[{"image":"../alarm.png",badge:33,text:["CBD","考木模式"]}]
    • image：图片相对路径，相对eview
    • text：数组，每个元素表示一行文本。文本样式在SetTextFormat设定每行的样式。
    • badge：数字徽标的数值。背景色在setBadgeFormat。设定如果没有该项，则不显示徽标
  • 示例：
    
    • pkmobilelist.setData("list1",[{"image":"global/img/timepicker.png",'badge':'11',text:["CBD","考木模式"],id:'1'},{"image":"global/img/chartladar.png",text:["木屋","考木模式"],id:'2'}]);
• pkmobilelist.setImageFormat(objectname,{width,height, location}). 设置图片的大小和位置
  • width:图片宽度，以像素为单位，可以不设置
  • height：图片高度，以像素为单位，可以不设置
  • location：图片显示位置，字符串，仅支持"left","right"。缺省在左边 
  • 本函数不是必须的，缺省不调用时：靠左，高度填满，宽度总1/10
  • 实例：
    • pkmobilelist.setImageFormat("list1",{width:"100px",height:"50px",location:"left"}); 
    • 
• pkmobilelist.setTextFormat(objectname,[{color:red,fontsize:11,fontname:仿宋,bold:1},{color:red,fontsize:9}]).
  • 数组中第一个元素代表第一行，第二个元素代表第二行 
  • 设定每行文本的颜色、字号，字体名称，是否加粗。
  • 缺省情况下字体：宋体，字号：12，颜色：黑色
  • 示例：
    • pkmobilelist.setTextFormat('list1',[{color:'red',fontsize:11,fontname:'微软雅黑',bold:1},{color:'blue',fontsize:11,fontname:'微软雅黑',bold:1}])
  • 
• pkmobilelist.setArrowFormat(objectname, options)，设定是否显示导航箭头，导航箭头的文本 
  • options有以下属性：
    • visible：1/0，1表示显示,0不显示
  • 示例：
    • pkmobilelist.setArrowFormat('list1',{visible:1});
    • text:为导航按钮左侧的文本，如：查看详情 
    • 
• pkmobilelist.setBadgeFormat(objectname,options)，是否显示数字徽标(数字徽标样子见下图），徽标的背景色
  
  • options有一下属性
    • visible:1/0,  表示显示还是不显示
    • bgColor，背景色，支持：red/green/#FF0000格式的背景色
  • 示例：
    • pkmobilelist.setBadgeFormat("list1",{visible:1,bgcolor:"red"})
    • pkmobilelist.setBadgeFormat("list1",{visible:1,bgcolor:"#F000FF"})
  • 
• pkmobilelist.setStyle(objectname,options)  设置列表样式
  • 示例：pkmobilelist.setStyle('list',{'bgColor':'blue'})
    • bgColor：列表背景色
• 完整示例：
  • pkmobilelist.setData("list1",[{"image":"global/img/timepicker.png",'badge':'11',text:["CBD","考木模式"],id:'1'},{"image":"global/img/chartladar.png",text:["木屋","考木模式"],id:'2'}]);
  • pkmobilelist.setBadgeFormat("list1",{visible:1,bgcolor:"#F000FF"})
  • pkmobilelist.setArrowFormat('list1',{visible:1});

专有事件

• onClick事件。当列表某一项被点击选中或触摸选中，触发onChange事件。参数：objectname,value。value是该项Data中的item的内容（id,text）。
  • id：为调用setData传入每个数据项的id，这个id是个字符串，可以随意输入
  • text：调用setData传入的每个数据项的text，text是多行
  • 示例：alert(value.id+","+value.text)

专有动画关联

• 不支持动画

专有属性配置对话框

• 文本格式。字体，颜色，字号
• 图片样式。大小，图片地址，位置（左/右）
• 是否显示右侧箭头，箭头左侧的文字
• 是否显示数字徽标，徽标背景色