tt.createMoreGamesButton
2020-02-15 02:15 更新
基础库 1.23.0 开始支持本方法，低版本需做兼容处理。
创建更多游戏按钮。用户点击该按钮后，会弹出一个固定样式的弹窗，弹窗中包含预先配置的小游戏列表。
参数
Object 类型，属性如下：
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| type | string | 是 | 按钮的类型，取值 image 或 text。image 对应图片按钮，text 对应文本按钮 | |
| image | string | 否 | 按钮的背景图片，type 为 image 时必填。仅支持本地图片，目录包括代码包目录、临时文件目录和本地用户目录 | |
| text | string | 更多游戏 | 否 | 按钮上的文本内容， type 为 text 时有效 |
| style | object | 是 | 按钮的样式 | |
| appLaunchOptions | Array<object> | 是 | 小游戏的启动参数 | |
| onNavigateToMiniGame | function | 否 | 跳转小游戏时的回调函数 |
appLaunchOptions 参数说明
Array<object> 类型，结构如下:
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| appId | string | 是 | 要打开的小游戏 appId | |
| query | string | 否 | 查询字符串，必须是 key1=val1&key2=val2 的格式。可通过 tt.getLaunchOptionSync() 或 tt.onShow() 获取启动参数中的 query | |
| extraData | object | 否 | 需要传递给目标小游戏的数据。可通过 tt.getLaunchOptionsSync() 或 tt.onShow() 返回的 referrerInfo 字段获取对应数据 |
onNavigateToMiniGame 回调函数参数
Object 类型，属性如下：
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 跳转错误码 |
| errMsg | string | 跳转失败时的提示信息 |
errCode 取值说明
| 值 | 说明 |
|---|---|
| 0 | 跳转成功 |
| 1 | 跳转失败 |
| 2 | 用户取消 |
style 参数说明
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| left | number | 是 | 左上角横坐标 | |
| top | number | 是 | 左上角纵坐标 | |
| width | number | 是 | 宽度 | |
| height | number | 是 | 高度 | |
| backgroundColor | string | 是 | 背景颜色 | |
| borderColor | string | 是 | 边框颜色 | |
| borderWidth | number | 是 | 边框宽度 | |
| borderRadius | number | 是 | 边框圆角 | |
| textAlign | string | 是 | 文本的水平居中方式 | |
| fontSize | number | 是 | 字号 | |
| lineHeight | number | 是 | 文本的行高 | |
| textColor | string | 是 | 文本颜色 |
style.textAlign 属性合法值
| 值 | 说明 |
|---|---|
| left | 居左 |
| center | 居中 |
| right | 居右 |
返回
返回一个 MoreGamesButton 对象
示例
const btn = tt.createMoreGamesButton({
type: "image",
image: "images/more_games_btn.png",
style: {
left: 20,
top: 40,
width: 150,
height: 40,
lineHeight: 40,
backgroundColor: "#ff0000",
textColor: "#ffffff",
textAlign: "center",
fontSize: 16,
borderRadius: 4,
borderWidth: 1,
borderColor: "#ff0000"
},
appLaunchOptions: [
{
appId: "ttXXXXXX",
query: "foo=bar&baz=qux",
extraData: {}
}
// {...}
],
onNavigateToMiniGame(res) {
console.log("跳转其他小游戏", res);
}
});
btn.onTap(() => {
console.log("点击更多游戏");
});以上内容是否对您有帮助：
更多建议：