Picker (3.4.5+)

• picker是在3.4.5版本后增加的一个新功能，即加强版的switch
• picker和switch一样，通过get读取当前状态，通过set保存状态
• 其它配置项也和switch一致
• picker需要你自己定义选项(option)，就像这样

属性

• 公共属性（Action、Switch、Picker共有）

属性	作用	有效值	示例
id	如果允许长按添加到桌面快捷，必需设置ID	当前配置文件中必需唯一	a0001
desc	显示在标题下的小字，可以不设置	文本内容	这是描述
desc-sh	动态设置desc内容的脚本	脚本代码	echo '自定义的说明信息'
summary	高亮显示的摘要信息	文本内容	这是摘要
summary-sh	动态设置summary内容的脚本	脚本代码	echo '自定义的摘要信息'
confirm	点击时是否弹出确认框，默认false	true、false	false
visible	自定义脚本，输出1或0，决定该功能项是否显示	脚本代码	echo '1'
interruptible	是否允许中断执行，默认true	true、false	false
auto-off	执行完脚本后是否自动关闭日志界面，默认false	true、false	false
auto-finish	是否在关闭日志界面后关闭当前页面	true、false	false
logo	作为快捷方式添加到桌面时使用的图标	文件路径
icon	显示在功能左侧的图标。如果未设置logo属性，它也同时会被作为logo使用	文件路径
reload	执行完脚本后要执行的刷新操作	page 、具体体功能id	page
bg-task	后台运行而不是显示日志输出界面，默认false	true false	true

• 特有属性

属性	作用	有效值	示例
multiple	是否允许多选(设置了options或type=app时可用)	true false	true
separator	多选模式下多个值的分隔符，默认为换行符	任意字符	,

id 属性建议配合 auto-off、auto-finish、logo 使用

logo和icon除了支持assets文件路径，也支持磁盘文件路径

<picker>
    <title>单选列表</title>
    <desc>测试单选列表</desc>
    <options>
        <option value="a1">选项1</option>
        <option value="a2">选项1</option>
    </options>
    <get>getprop xxx.xxx.xxx</get>
    <set>setprop xxx.xxx.xxx $state</set>
</picker>

• 动态选项
• picker也允许使用options-sh属性来设置输出下拉选项的脚本
• 用法和action的param一样，如：

<picker options-sh="echo 'a|选项A'; echo 'b|选项B'">
    <title>测试单选界面</title>
    <desc>测试单选界面</desc>
    <get>getprop xxx.xxx.xxx3</get>
    <set>setprop xxx.xxx.xxx3 "$state"</set>
</picker>

• 多选模式

• 在picker节点上增加multiple="true"属性来标识允许多选

• 例如：

  <picker options-sh="echo 'a|选项A'; echo 'b|选项B'" value-sh="echo 'a'; echo 'b';">
      <title>测试单选界面</title>
      <get>getprop xxx.xxx.xxx4</get>
      <set>setprop xxx.xxx.xxx4 "$state"</set>
  </picker>
  

• 默认设置下，多选列表的各个值用换行分隔，得到的参数可能是这样的

  value="
  wifi
  airplane
  "
  

• 可有时候，你希望得到的值是 value="wifi,airplane" 这样的？

• 其实你可以通过separator属性自定义分隔符，例如：

  <picker multiple="multiple" separator=",">
      <title>隐藏状态栏图标</title>
      <desc>设置隐藏的状态栏图标</desc>
      <options>
          <option value="mobile">手机信号</option>
          <option value="wifi">WIFI</option>
          <option value="airplane">飞行模式</option>
      </options>
      <get>
          settings get secure icon_blacklist
      </get>
      <set>
          settings put secure icon_blacklist "$state"
      </set>
  </picker>
  

---

相关说明

• 由于在xml中写大量的shell代码非常不方便，也不美观，
• 建议参考 脚本使用 中的说明，
• 将段落较长的脚本代码，写在单独的文件中。