搜狐博客开放模块SOW参数设置规范
SOW Widget Preferences Language(以下简称Widget Preferences)是一种设置Widget参数设置的语言,这些参数都会以html控件的形式显示给用户,开发者可以通过Widget Preferences设置参数的数量、显示为何种html控件、名称及默认值等。
每一个设置项都对对应一个preference标签,标签有一个type属性来设置参数的类型,每种类型都代表一种特殊的显示控件或者数据类型,现在支持的type属性如下:
| type |
对应的html元素 |
默认值 |
说明 |
|
text |
Input text |
undefined |
|
|
boolean |
Input checkbox |
false |
|
|
hidden |
Input hidden |
undefined |
对应一个input hidden控件 |
|
range |
select |
undefined |
表示一个数字序列,比如1到10 |
|
list |
select |
undefined |
对应一个选择项列表 |
|
password |
Input password |
undefined |
对应一个password输入框 |
所有的这些类型都有一些相同的属性项,但是某些类型由于其特殊性也针对性地存在一些属性项。所有的属性项如下所示:
| 支持的type |
属性名 |
数据类型 |
必填 |
说明 |
|
所有 |
label |
String |
否 |
参数的文字说明 |
|
name |
String |
是 |
参数的名称,JS可以通过这个值取得或设置参数的值 |
|
|
defaultValue |
|
否 |
参数的默认值 |
|
|
boolean |
onchange |
Boolean |
否 |
属性值变更时,是否发送onRefresh事件,默认为false |
|
range |
min |
Number |
是 |
数字序列的起始值 |
|
max |
Number |
是 |
数字序列的结束值 |
|
|
step |
Number |
是 |
数字序列的变更量 |
