bl.createOpenSettingButton(Object object)
创建打开设置页面的按钮
基础库 2.3.0 开始支持,低版本需做兼容处理
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
type | string | text | 否 | 按钮的类型 |
text | string | 打开设置 | 否 | 按钮上的文本,仅当 type 为 text 时有效 |
image | string | '' | 否 | 按钮的背景图片,仅当 type 为 image 时有效 |
style | Object | {} | 否 | 按钮的样式 |
type 的合法值
值 | 说明 |
---|---|
text | 可以设置背景色和文本的按钮 |
image | 只能设置背景贴图的按钮,背景贴图会直接拉伸到按钮的宽高 |
style 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
left | number | 0 | 否 | 左上角横坐标 |
top | number | 0 | 否 | 左上角纵坐标 |
width | number | 0 | 否 | 宽度 |
height | number | 0 | 否 | 高度 |
color | string | #000000 | 否 | 文字颜色 (hex 颜色代码) |
backgroundColor | string | 透明 | 否 | 背景颜色 (hex 颜色代码) |
borderColor | string | 透明 | 否 | 边框颜色 (hex 颜色代码) |
borderWidth | number | 0 | 否 | 边框宽度 |
borderRadius | number | 0 | 否 | 边框圆角 |
textAlign | string | left | 否 | 文本的水平居中方式 |
fontSize | number | 14 | 否 | 字号 |
lineHeight | number | 否 | 文本的行高 |
color、backgroundColor、borderColor 除支持 hex 颜色代码外还支持 white black red green yellow lightgray gray darkgray blue orange purple cyan magenta brown clear 这几个颜色值
style.textAlign 的合法值
值 | 说明 |
---|---|
left | 居左 |
center | 居中 |
right | 居右 |
返回值
OpenSettingButton
示例代码
const button = bl.createOpenSettingButton({
type: 'text',
text: '打开设置页面',
style: {
left: 0,
top: 0,
width: 200,
height: 40,
color: '#0000ff',
backgroundColor: '#ff0000',
borderColor: '#000000',
borderWidth: 1,
borderRadius: 4,
textAlign: 'center',
fontSize: 16,
lineHeight: 40,
},
});
button.onTap(res => {
console.log(res);
});