语法指南 | 优宽量化

LogStatus-btnTypeTwo

该JSON结构用于配置状态栏中的按钮控件，按钮控件JSON结构可以嵌入到状态栏表格JSON结构中。这是目前最新版本的按钮JSON结构。
状态栏按钮控件构造示例（按钮触发点击后，弹出框中包含多个输入控件，通过group字段构造）：


            json
            
            
{
    "type": "button",
    "cmd": "open",
    "name": "开仓下单",
    "group": [{
        "type": "selected",
        "name": "tradeType",
        "label": "下单类型",
        "description": "市价单、限价单",
        "default": 0,
        "group": "交易设置",
        "settings": {
            "options": ["市价单", "限价单"],
            "required": true,
        }
    }, {
        "type": "selected",
        "name": "direction",
        "label": "交易方向",
        "description": "买入、卖出",
        "default": "buy",
        "group": "交易设置",
        "settings": {
            "render": "segment",
            "required": true,
            "options": [{"name": "买入", "value": "buy"}, {"name": "卖出", "value": "sell"}],
        }
    }, {
        "type": "number",
        "name": "price",
        "label": "价格",
        "description": "订单的价格",
        "group": "交易设置",
        "filter": "tradeType==1",
        "settings": {
            "required": true,
        }
    }, {
        "type": "number",
        "name": "amount",
        "label": "下单量",
        "description": "订单的下单量",
        "group": "交易设置",
        "settings": {
            "required": true,
        }
    }],
}

状态栏按钮控件点击触发后弹出框中的控件通过input或group字段进行设置。

属性

名称	类型	描述
type	string	对于按钮控件，固定设置为：`button`。
name	string	按钮控件上显示的文本，即按钮名称。
cmd	string	按钮控件被点击时，发送给策略的交互命令内容。
input	object	点击按钮后弹框中的一个输入控件，交互命令由`GetCommand()`读取；字段见备注中的「`input`字段」。
group	array	点击按钮后弹框中的一组控件，每个元素的结构与`input`相同，见备注中的「`input`字段」。

参考

LogStatus

备注

`input`字段

相对于旧版本的input结构（LogStatus-btnTypeOne），新版本的结构如下：


            json
            
            
{
    "type": "selected",
    "name": "test",
    "label": "topic",
    "description": "desc",
    "default": 1,
    "filter": "a>1",
    "group": "group1",
    "settings": { ... },    // 组件配置
}

字段	说明
`type`	控件类型（必填）：`number`数值输入框、`string`字符串输入框、`selected`下拉框、`boolean`开关
`name`	用于`input`时，没有设置`label`就作为弹框中控件的标题；用于`group`的元素时，是该控件的输入值在交互命令中的字段名
`label`	控件的标题
`description`	控件的描述信息；用于`group`的元素且没有设置`label`时，作为控件的标题
`default`	控件的默认值
`filter`	显示条件表达式：不设置时总是显示；表达式为真时显示，为假时隐藏
`group`	控件分组，可折叠
`settings`	组件配置，见下文

group示例（节选）：


            javascript
            
            
var testBtn3 = {
    type: "button",
    name: "testBtn3",
    cmd: "cmdTestBtn3",
    group: [
        {name: "comboBox1", label: "labelComboBox1", description: "下拉框1", type: "selected", defValue: 1, options: ["A", "B"]},
        {name: "comboBox2", label: "labelComboBox2", description: "下拉框2", type: "selected", defValue: "A|B"},
        {name: "comboBox3", label: "labelComboBox3", description: "下拉框3", type: "selected", defValue: [0, 2], multiple: true, options: ["A", "B", "C"]},
        {
            name: "comboBox4",
            label: "labelComboBox4",
            description: "下拉框4",
            type: "selected",
            defValue: ["A", "C"],
            multiple: true,
            options: [{text: "选项A", value: "A"}, {text: "选项B", value: "B"}, {text: "选项C", value: "C"}, {text: "选项D", value: "D"}]
        }
    ]
}

点击按钮后弹框中有4个下拉框控件，设置好选项并确定后，GetCommand()收到cmdTestBtn3:{"comboBox1":1,"comboBox2":0,"comboBox3":[0,2],"comboBox4":["A","C"]}，各控件的name（comboBox1等）就是命令中的字段名。

`settings`组件配置

settings用于选择和设置控件的界面形式，例如：


            json
            
            
settings:{
    multiple:true,
    customizable:true,
    options:[{name:'xxx|yyy',value:0}]
}

字段	说明
`required`	是否必选
`disabled`	是否禁用
`min` / `max`	最小 / 最大值（`number`），或字符串的最小 / 最大长度
`step`	`type`为`number`且`render`为`slider`时有效，表示步长
`multiple`	`type`为`selected`时有效，支持多选
`customizable`	`type`为`selected`时有效，支持在下拉框中编辑添加新选项；选中新选项时，交互命令中使用选项的名称而不是值
`options`	`type`为`selected`时有效，选项数据：`["选项1", "选项2"]`或`[{name: "xxx", value: 0}, {name: "xxx", value: 1}]`
`render`	渲染的组件类型，见下表
`type`	`render`可选值（不设置时为默认组件）
-	-
`number`	默认数字输入框；`slider`滑动条，`date`时间选择器（返回时间戳）
`string`	默认单行输入框；`textarea`多行输入，`date`时间选择器（返回`yyyy-MM-dd hh:mm:ss`），`color`颜色选择器（返回`#FF00FF`）
`selected`	默认下拉框；`segment`分段选择器
`boolean`	只有默认的复选框

支持双语设置：


            json
            
            
{
    type:'selected',
    name:'test',
    label:'选项｜options',
    description:'描述｜description',
    default:0,                            // 此处default默认值设置为0，表示{name:'xxx|yyy',value:0}选项中的value值
    filter:'a>1&&a<10',
    group:'分组|group',
    settings:{
        multiple:true,
        customizable:true,
        options:[{name:'xxx|yyy',value:0}]
    }
}

LogStatus-btnTypeTwo

input字段

settings组件配置

`input`字段

`settings`组件配置