@lisaisacat
2020-10-09T15:17:51.000000Z
字数 5023
阅读 1433
未分类
Windows 平台按 Ctrl + F 打开快捷搜索
Mac 平台按 command + F 打开快捷搜索
※右侧文本列表可以找到全部手册
在此输入正文
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
bg | string | 否 | 指定界面的背景图片,相对路径为 res 资源目录,可填写绝对路径。 | - |
okname | string | 否 | 确认文字,指定底部右侧确认按钮上显示的文字。 | “确定” |
cancelname | string | 否 | 取消文字,指定底部左侧取消按钮上显示的文字。 | “取消” |
title | string | 否 | 标题,用于指定 UI 顶部标题栏文字, 仅 iOS v2.2.5, Android v1.2.4 以上版本支持 |
“脚本配置” |
titles | string | 否 | 多页标题,用于指定 UI 顶部标题栏文字在多页模式下 可以设置多个标题对应多个页面, 以逗号分隔,仅 iOS v2.3.2, Android v2.2.7 以上版本支持。 |
"第一页" |
pagetype | string | 否 | 多页模式,当指定该属性值为 multi 时,UI 可分页显示,左右滑动进行翻页,如不指定该属性,将使用默认的单页模式, 仅 iOS**v2.2.5**, Android**v2.1.5** 以上版本支持。 |
- |
orient | number | 否 | 指定 UI 界面显示方向, 0 - Home 键在设备下方, 1 - Home 键在设备右侧, 2 - Home 键在设备左侧, 仅支持 iOS v2.2.5 及其以上版本 |
0 |
pagenumtype | string | 否 | 页码样式,dot - 小圆点, number - 数字, default - 不显示 | “default” |
config | string | 否 | 配置保存文件名,保存配置到该文件。 | - |
timer | number | 否 | 自动确认时间,倒计时完成自动开始, 专业版 iOS**v3.0.6**、Android**v3.2.0** 及其以上版本客户端 此参数最高只能显示 999 秒; Android**v3.2.0**、iOSv**3.1.5** 及以上版本将倒计时图标挪到数字右侧, 数字和图标均为右对齐,文字修改为只有数字不显示单位, 调整位置为右对齐 |
0 |
rettype | string | 否 | 指定返回值类型,default - 默认模式,保持旧版格式,可使用此属性兼容旧版 UI; array - 数组模式,将所有控件返回值按添加顺序放入一个 table 中返回; table - table 模式,将所有控件返回值以 key, values 形式的 table 返回, key 为控件 id 属性所指定的值,仅支持 iOS**v2.2.6**, Android**v1.2.7** 及以上版本。 |
“default” |
注意事项
iOS 9
以上版本的 iPad 设备上使用 showUI 界面时,务必使用 orient 属性指定正确的屏幕方向,否则将可能出现确定、取消按钮无法点击的情况。一共有 4 种属性:控件类型 type、控件 ID id、可选项标题 list、默认选中项编号 select
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:CheckBoxGroup | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key, 控件ID 以 table 格式返回返回值时必填,否则无法获取返回值 |
- |
list | string | 是 | 文字选项,多个可选项之间用英文半角逗号分割 | - |
select | string | 否 | 默认选项编号,允许填写一个或多个,填写多个时以 @ 分割。 序号从 0 开始,与可选项标题中的顺序保持一致 |
- |
一共有 7 种属性:控件类型 type、控件 ID id、可选项标题 list、默认选中项编号 select、两个 ComboBox 控件建立数据关联时的下级选项 data、两个 ComboBox 控件建立数据关联时的上级数据源名称 source、两个 ComboBox 控件建立数据关联时的下级数据源名称 dataSource
主选项下拉框
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:ComboBox | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key, 控件ID 以 table 格式返回返回值时必填,否则无法获取返回值 |
- |
list | string | 是 | 文字选项,多个可选项之间用英文半角逗号分割 | - |
select | string | 否 | 默认选项编号,只允许填写一个,序号从 0 开始, 与可选项标题中的顺序保持一致 |
"0" |
data | string | 否 | 关联项 ,下拉框子选项内容 | - |
source | string | 否 | 标志名,主选项下拉框控件 source 属性必须 与子选项下拉框的 dataSource 属性一致 |
- |
子选项下拉框
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:ComboBox | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key, 控件ID 以 table 格式返回返回值时必填,否则无法获取返回值 |
- |
select | string | 否 | 默认选项编号,只允许填写一个,序号从 0 开始, 与可选项标题中的顺序保持一致 |
"0" |
dataSource | string | 否 | 两个 ComboBox 控件建立数据关联时的下级数据源名称, 主选项下拉框控件 source 属性必须与 子选项下拉框的 dataSource 属性一致 |
- |
注意事项
默认选中项编号 select 只允许填写一个。
上一级的必须要有 data 数据给下级使用,而且 list 里面逗号分割的个数必须要和 data 里面 # 号分割的个数保持一致,上一级的 source 和下一级的 dataSource 要保持一致。
示例中 cb2 和 cb3 是控件ID,根据控件 ID 获取选择的控件。
一共有 7 种属性:控件类型 type、控件 ID id、编辑框提示文本 prompt、编辑框默认内容 text、字体大小 size、键盘类型 kbtype、是否明文显示 secure
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Edit | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key, 控件ID 以 table 格式返回返回值时必填,否则无法获取返回值 |
- |
prompt | string | 否 | 提示文字,编辑框中无任何内容时显示的底色文本 | - |
text | string | 否 | 默认文字,界面载入时已经存在于编辑框中的文本 | - |
size | number | 否 | 字号,如果不指定该属性,则默认值为 15 | 15 |
kbtype | string | 否 | 键盘类型,设置获取焦点时弹出的键盘类型, 默认为 number, number ascii |
"number" |
放置一个图片到 UI 上,一共有 4 种属性:控件类型 type、插入图片的路径 src、对齐方式 align、缩放比例 scale。
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型,Image | - |
src | string | 是 | 图片路径,可以是本地路径或者网络路径 | - |
align | string | 否 | 对齐方式,在 default 模式下设置 image 控件的 对齐方式 left center right ,仅支持 iOS,默认居中对齐 |
"center" |
scale | number | 否 | 缩放比例,在 default 模式下设置 image 控件的缩放比例,范围 0 - 1 | 1 |
注意事项
图片路径的可以是本地路径或者网络路径,例如:\"type\":\"Image\",\"src\":\"http://www.baidu.com/img/bdlogo.png\" 或者\"src\":\"1.png\"
一共有 5 种属性:控件类型 type、标题 text、字体大小 size、水平对齐方式 align、字体颜色 color
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Label | - |
text | string | 否 | 内容,一般来用显示说明文字或者标题, 该控件没有任何返回值,只用作显示 |
- |
size | number | 否 | 字体大小 | 14 |
align | string | 否 | 水平对齐方式,默认左对齐。 可取值为:左对齐 left,右对齐 right,居中 center |
"left" |
color | string | 否 | 文字颜色,默认黑色(0,0,0)。 使用 RGB 十进制数值,以英文半角逗号分割 |
"143,143,148" |
注意事项
一共有 5 种属性:控件类型 type、字体颜色 color、对齐方式 align、高度 height 、宽度 width
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Line | - |
color | string | 否 | 线条颜色 ,默认灰色,使用 RGB 十进制数值,以英文半角逗号分割 | "208,208,208" |
align | string | 否 | 对齐方式,默认左对齐。 可取值为:左对齐 left,右对齐 right,居中 center |
"left" |
height | number | 否 | 线条高度,个位数像素显示差异很小,并不是参数不生效 Android 设备仅支持整数否则会提示 UI 格式错误 |
1px |
width | number | 否 | 线条宽度, Android 设备仅支持整数否则会提示 UI 格式错误 |
屏幕宽度减 20 px |
一共有 5 种属性:控件类型 type、控件 ID id、可选项标题 list、默认选中项编号 select
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:RadioGroup | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key, 控件ID 以 table 格式返回返回值时必填,否则无法获取返回值 |
- |
list | string | 是 | 文字选项,多个可选项之间用英文半角逗号分割 | - |
select | string | 否 | 默认选项编号,只允许填写一个,序号从 0 开始, 与可选项标题中的顺序保持一致 |
- |
一共有 5 种属性:控件类型 type、控件 ID id、默认值 default、最小值 min、 最大值 max、跨度 span
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Slide | - |
default | string | 否 | min | |
min | string | 是 | 最小值 | - |
max | string | 是 | 最大值 | - |
span | number | 否 | 跨度 | 1 |
一共有 5 种属性:控件类型 type、控件 ID、开关状态 state、大小 size、对齐方式 align
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Switch | - |
id | string | 否 | 为控件指定 ID,可以理解为控件的名称, 在返回类型为 table 时将作为返回 table 中的 key |
- |
on | string | 否 | 开关状态,默认关闭,on 打开,off 关闭, disable 禁用,disable-on 打开并禁用 |
"off" |
size | string | 否 | 为控件指定大小,默认中号,s 小号,m 中号,l 大号 | "m" |
align | string | 否 | 对齐方式,为控件指定对齐方式, 默认居左,居中 center,居左 left,居右 right |
"left" |
一共有 3 种属性:控件类型 type、默认打开项 list、开关名称 select
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Switch | - |
list | string | 是 | 默认打开项,可写多项,用 “@” 隔开,选项编号从 0 开始,不写为关闭状态 | |
select | string | 否 | 开关名称,可写多项,用 “,” 隔开 |
一共有 3 种属性:控件类型 type、浏览器 url、高度 height
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
type | string | 是 | 控件类型:Web | - |
url | string | 是 | 浏览器地址 | - |
height | number | 否 | 控件高度 | 600px |