[关闭]
@lisaisacat 2020-10-09T07:17:51.000000Z 字数 5023 阅读 1168

webUI

未分类

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”

注意事项

控件：CheckBoxGroup 多选组合

一共有 4 种属性：控件类型 type、控件 ID id、可选项标题 list、默认选中项编号 select

参数 类型 必填 说明 默认值
type string 是 控件类型：CheckBoxGroup -
id string 否 为控件指定 ID，可以理解为控件的名称，
在返回类型为 table 时将作为返回 table 中的 key，
控件ID 以 table 格式返回返回值时必填，否则无法获取返回值		 -
list string 是 文字选项，多个可选项之间用英文半角逗号分割 -
select string 否 默认选项编号，允许填写一个或多个，填写多个时以 @ 分割。
序号从 0 开始，与可选项标题中的顺序保持一致		 -

控件：ComboBox 下拉框

一共有 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 属性一致		 -

注意事项

控件：Edit 单行文本框

一共有 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"

控件：Image 图片

放置一个图片到 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\"

控件：Label 标签

一共有 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"

注意事项

控件：Line 分割线

一共有 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

控件：RadioGroup 单选组合

一共有 5 种属性：控件类型 type、控件 ID id、可选项标题 list、默认选中项编号 select

参数 类型 必填 说明 默认值
type string 是 控件类型：RadioGroup -
id string 否 为控件指定 ID，可以理解为控件的名称，
在返回类型为 table 时将作为返回 table 中的 key，
控件ID 以 table 格式返回返回值时必填，否则无法获取返回值		 -
list string 是 文字选项，多个可选项之间用英文半角逗号分割 -
select string 否 默认选项编号，只允许填写一个，序号从 0 开始，
与可选项标题中的顺序保持一致		 -

控件：Slide 滑块

一共有 5 种属性：控件类型 type、控件 ID id、默认值 default、最小值 min、 最大值 max、跨度 span

参数 类型 必填 说明 默认值
type string 是 控件类型：Slide -
default string 否 min
min string 是 最小值 -
max string 是 最大值 -
span number 否 跨度 1

控件： Switch 开关

一共有 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"

控件： switches 开关

一共有 3 种属性：控件类型 type、默认打开项 list、开关名称 select

参数 类型 必填 说明 默认值
type string 是 控件类型：Switch -
list string 是 默认打开项，可写多项，用 “@” 隔开，选项编号从 0 开始，不写为关闭状态
select string 否 开关名称，可写多项，用 “,” 隔开

控件：Web 网页

一共有 3 种属性：控件类型 type、浏览器 url、高度 height

参数 类型 必填 说明 默认值
type string 是 控件类型：Web -
url string 是 浏览器地址 -
height number 否 控件高度 600px
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注