2023-12-18 18:15:22 +08:00
|
|
|
|
# 创建控件的Json文件格式说明
|
|
|
|
|
|
Bricks在服务器端使用Json文件格式存储控件描述文件，前端获得json文件后转化为json对象，并用词json对象调用widgetBuild函数创建Bricks控件。
|
|
|
|
|
|
|
|
|
|
|
|
控件描述json文件必须含有“widgettype” 和”options“两个属性。“subwidgets”属性用来定义此控件包含的子控件。“binds”用于定义此控件或其子控件的事件处理
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## widgettype说明
|
|
|
|
|
|
widgettype是一个字符串属性。其值为Bricks中的所有控件类型或"urlwidget"
|
|
|
|
|
|
可用的控件类型可以在[控件类型清单](widgettypes.md)中查找
|
|
|
|
|
|
|
|
|
|
|
|
## options
|
|
|
|
|
|
对象类型，每个控件有特定的options属性，清参看每个控件的说明
|
|
|
|
|
|
|
|
|
|
|
|
## subwidgets
|
|
|
|
|
|
数组类型，数组中的每个元素必须是一个对象类型数据，与desc作用一样。
|
|
|
|
|
|
参见widgetBuild函数的desc说明
|
|
|
|
|
|
|
|
|
|
|
|
## binds
|
|
|
|
|
|
一个数组，在控件上定义一到多个事件绑定，数组中的每一个元素定义一个绑定，
|
|
|
|
|
|
Bricks支持5种数据绑定
|
|
|
|
|
|
每种绑定类型都支持下述属性
|
|
|
|
|
|
### wid
|
|
|
|
|
|
字符串类型或控件类型，绑定事件的控件，缺省是binds坐在的构造控件。
|
|
|
|
|
|
### event
|
|
|
|
|
|
字符串类型，事件名称， 绑定针对的事件字符串名称
|
|
|
|
|
|
|
|
|
|
|
|
### actiontype
|
|
|
|
|
|
绑定类型，支持“urlwidget", "method", "script", "registerfunction", "event"
|
|
|
|
|
|
|
|
|
|
|
|
### conform
|
|
|
|
|
|
对象类型，确认控件的options，如存在，则此绑定需要用户确认后再执行
|
|
|
|
|
|
|
|
|
|
|
|
### 获取实时数据作为参数
|
|
|
|
|
|
绑定任务获取实时数据作为参数，需要给定以下属性：
|
|
|
|
|
|
* datawidget：字符串或控件类型，获取实时数据的控件
|
|
|
|
|
|
* datamethod：字符串类型，控件的方法，使用params作为参数调用，
|
|
|
|
|
|
获取实时数据的方法
|
|
|
|
|
|
* datascript：字符串类型， js脚本，使用return返回数据
|
|
|
|
|
|
* dataparams：参数
|
|
|
|
|
|
datamethod 优先datascript，从datawidget控件中通过datamethod
|
|
|
|
|
|
|
|
|
|
|
|
### target
|
|
|
|
|
|
字符串或控件实例，目标控件实例，如果是字符串，使用”getWidgetById“函数获得目标控件实例
|
|
|
|
|
|
|
|
|
|
|
|
### urlwidget绑定
|
|
|
|
|
|
|
|
|
|
|
|
urlwidget绑定需要一个options属性和一个mode属性，在此属性中需要
|
|
|
|
|
|
* url：字符串类型， 获取desc数据的url
|
|
|
|
|
|
* mehtod：字符串类型，url调用的方法，缺省”GET“
|
|
|
|
|
|
* params：对象类型，调用的参数
|
|
|
|
|
|
绑定创建的控件添加到target控件中
|
|
|
|
|
|
### method
|
|
|
|
|
|
需要指定target参数和method参数，
|
|
|
|
|
|
* target：类型为字符串或控件类型，
|
|
|
|
|
|
如果是字符串，使用“getWidgetById”函数获取控件实例。
|
|
|
|
|
|
* method：字符串，target实例的方法，
|
|
|
|
|
|
* params：传递给方法的参数
|
|
|
|
|
|
method绑定方法，将事件绑定到target控件的一个方法，并用params传递参数
|
|
|
|
|
|
|
|
|
|
|
|
### script
|
|
|
|
|
|
绑定脚本，此方法将事件绑定到一个脚本，支持以下属性
|
|
|
|
|
|
* script：字符串，脚本正文
|
|
|
|
|
|
* params：对象类型，脚本可以访问params变量来获取参数。
|
|
|
|
|
|
|
|
|
|
|
|
### registerfunction
|
|
|
|
|
|
事件绑定一个注册函数， 参看[RegisterFunction](registerfunction.md)
|
|
|
|
|
|
支持以下属性：
|
|
|
|
|
|
rfname：字符串，已注册的函数名称
|
|
|
|
|
|
params：对象类型，调用注册函数时作为参数传递给注册函数。
|
|
|
|
|
|
|
|
|
|
|
|
### event
|
|
|
|
|
|
绑定事件，需指定target，触发target对象的一个事件
|
|
|
|
|
|
支持以下属性
|
|
|
|
|
|
dispatch_event：需触发的事件名
|
|
|
|
|
|
params：传递给事件的参数，处理函数可以使用evemt.params获得此参数
|
|
|
|
|
|
|
|
|
|
|
|
作为参数调用target实例的方法
|
|
|
|
|
|
|
