UIButton

{
    x: 0,   //（可选项）数字类型；插件左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
    y: 0,   //（可选项）数字类型；插件左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：0
    w: 80,  //（可选项）数字类型；插件的宽度；默认值：80
    h: 50   //（可选项）数字类型；插件的高度；默认值：50
}

corner：

类型：数字
描述：（可选项）按钮视图顶角圆角大小
默认值：0

border：

类型：JSON对象
描述：（可选项）按钮边框颜色，边框宽度
默认值：见内部字段
内部字段

{
        borderColor: '',    //（可选项）字符串类型；按钮边框颜色；默认：'#000'
        borderWidth: '', //（可选项）数字类型；按钮边框宽度；默认：0 
}

bg:

类型：JSON 对象
描述：（可选项）按钮视图背景设置
默认值：见内部字段
内部字段：

{
        normal: '',    //（可选项）字符串类型；按钮常态下的背景，支持 rgb、rgba、#、img；默认：'#000'
        highlight: '', //（可选项）字符串类型；按钮高亮下的背景，支持 rgb、rgba、#、img；默认：normal 
        active: ''     //（可选项）字符串类型；按钮选中后的背景，支持 rgb、rgba、#、img；默认：normal 
}

title:

类型：
描述：（可选项）按钮标题设置
默认值：见内部字段
内部字段：

{
      size: 13,         //（可选项）数字类型；标题字体大小；默认：13
      normal: '',       //（可选项）字符串类型；按钮常态下的标题
      highlight: '',    //（可选项）字符串类型；按钮高亮下的标题；默认：normal
      active: '',       //（可选项）字符串类型；按钮选中后的标题；默认：normal
      normalColor: '',  //（可选项）字符串类型；标题常态颜色，支持 rgb、rgba、#；默认：#fff
      highlightColor:'',//（可选项）字符串类型；标题按下颜色，支持 rgb、rgba、#；默认：normalColor
      activeColor:'',   //（可选项）字符串类型；标题点击后颜色，支持 rgb、rgba、#；默认：normalColor
      alignment: '' ,    //（可选项）字符串类型；标题水平向的位置，取值范围：left、right、center；默认：center
      verticalAlignment: //（可选项）字符串类型；标题垂直向的位置，取值范围：top、bottom、center；默认：center
}

fixedOn：

类型：字符串类型
描述：（可选项）插件视图添加到指定 frame 的名字（只指 frame，传 window 无效）
默认：插件依附于当前 window

fixed:

类型：布尔
描述：（可选项）是否将插件视图固定到窗口上（不跟随窗口上下滚动）
默认值：true

move:

类型：布尔
描述：（可选项）是否为可拖动的按钮，仅当 fixedOn 为空且 fixed 为 false 时有效（window页面有效）
默认值：false

callback(ret, err)

ret：

类型：JOSN 对象
内部字段：

{
     eventType:      //字符串类型；回调事件类型；取值范围如下：
                     //show：打开成功并显示在UI上
                     //click：用户点击事件
                     //moveBegin：开始移动
                     //moving：移动中
                     //moveEnd：移动结束
     id:             //数字类型；打开按钮插件的 id
}

示例代码

var button = api.require('UIButton');
button.open({
    rect: {
        x: 100,
        y: 100,
        w: 80,
        h: 50
    },
    corner: 5,
    border:{
         borderColor: '#1E1E1E',    //（可选项）字符串类型；按钮边框颜色；默认：'#000'
        borderWidth: '1', //（可选项）数字类型；按钮边框宽度；默认：0 
    },
    bg: {
        normal: '#000000',
        highlight: '#ff0000',
        active: '#adf000'
    },
    title: {
        size: 14,
        highlight: '高亮状态标题',
        active: '选中后标题',
        normal: '常态标题',
        highlightColor: '#000000',
        activeColor: '#000adf',
        normalColor: '#ff0000',
        alignment: 'center'
    },
    fixedOn: api.frameName,
    fixed: true,
    move: true
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setTitle

重设指定按钮的标题

setTitle({params})

params

id ：

类型：数字
描述：所操作按钮插件的id

title:

类型：
描述：（可选项）按钮标题设置
默认值：见内部字段
内部字段：

{
      size: 13,         //（可选项）数字类型；标题字体大小；默认：13
      normal: '',       //（可选项）字符串类型；按钮常态下的标题
      highlight: '',    //（可选项）字符串类型；按钮高亮下的标题；默认：normal
      active: '',       //（可选项）字符串类型；按钮选中后的标题；默认：normal
      normalColor: '',  //（可选项）字符串类型；标题常态颜色，支持 rgb、rgba、#；默认：#fff
      highlightColor:'',//（可选项）字符串类型；标题按下颜色，支持 rgb、rgba、#；默认：normalColor
      activeColor:'',   //（可选项）字符串类型；标题点击后颜色，支持 rgb、rgba、#；默认：normalColor
      alignment: ''     //（可选项）字符串类型；标题位置，取值范围：left、right、center；默认：center
}

示例代码

var button = api.require('UIButton');
button.setTitle({
    id: 1,
    title: {
        size: 14,
        highlight: '高亮状态标题',
        active: '选中后标题',
        normal: '常态标题',
        highlightColor: '#oo0000',
        activeColor: '#adf000',
        normalColor: '#ff0000',
        alignment: 'center'
    }
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getRect

获取指定按钮插件的位置及大小

getRect({params}, callback(ret, err))

params

id ：

类型：数字
描述：操作按钮插件的id

callback(ret, err)

ret：

类型：JOSN 对象
内部字段：

{
    x: 0,   //数字类型；插件左上角的 x 坐标（相对于所属的 Window 或 Frame）
    y: 0,   //数字类型；插件左上角的 y 坐标（相对于所属的 Window 或 Frame）
    w: 80,  //数字类型；插件的宽度
    h: 50   //数字类型；插件的高度
}

示例代码

var button = api.require('UIButton');
button.getRect({
    id: 1
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRect

重设指定按钮插件的位置及大小

setRect({params})

params

id ：

类型：数字
描述：操作按钮插件的id

rect：

类型：JSON 对象
描述：（可选项）插件的位置及尺寸
内部字段：

{
    x: 0,   //（可选项）数字类型；插件左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：按钮插件原 x 值
    y: 0,   //（可选项）数字类型；插件左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：按钮插件原 y 值
    w: 80,  //（可选项）数字类型；插件的宽度；默认值：按钮插件原 w 值
    h: 50   //（可选项）数字类型；插件的高度；默认值：按钮插件原 h 值
}

anim ：

类型：布尔
描述：改变插件视图大小时是否添加变化过程的动画， android 暂不支持此参数
默认值：false

示例代码

var button = api.require('UIButton');
button.setRect({
    id: 1,
    rect: {
        x: 80,
        y: 100,
        h: 60,
        w: 90
    },
    anim: true
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getState

获取指定按钮插件的状态

getState({params}, callback(ret, err))

params

id ：

类型：数字
描述：操作按钮插件的id

callback(ret, err)

ret：

类型：JOSN 对象
内部字段：

{
    state: 'active'   //字符串类型；按钮的状态，取值范围：normal、active
}

示例代码

var button = api.require('UIButton');
button.getState({
    id: 1
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setState

设置指定按钮的状态

setState({params})

params

id ：

类型：数字
描述：操作按钮插件的id

state：

类型：字符串
描述：（可选项）按钮的状态
默认：active
取值范围：
- normal：常态
- active：选中状态

示例代码

var button = api.require('UIButton');
button.setState({
    id: 1,
    state: 'active'
});

# **bringToFront**

使按钮在视图最顶层显示

bringToFront({params})

params

id ：

类型：数字
描述：操作按钮插件的 id

示例代码

var button = api.require('UIButton');
button.bringToFront({
    id: 1
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭指定按钮插件

close({params})

params

id ：

类型：数字
描述：操作按钮插件的 id

示例代码

var button = api.require('UIButton');
button.close({
    id: 1
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏指定按钮插件

hide({params})

params

id ：

类型：数字
描述：操作按钮插件的 id

示例代码

var button = api.require('UIButton');
button.hide({
    id: 1
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示指定按钮插件

show({params})

params

id ：

类型：数字
描述：操作按钮插件的 id

示例代码

var button = api.require('UIButton');
button.show({
    id: 1
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？请保持联络！

最后更新于 2024/11/18