tt.createMoreGamesButton 1.23.0+

创建更多游戏按钮。用户点击该按钮后,会弹出一个固定样式的弹窗,弹窗中包含预先配置的小游戏列表。

输入

Object object

属性描述:

属性 类型 默认值 必填 描述
type String 按钮的类型
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 回调函数接收的参数 res

属性 类型 说明
errCode Int 跳转结果状态码
errMsg String 跳转失败时的详细信息

errCode 取值说明

说明
0 跳转成功
1 跳转失败
2 用户取消

type 取值说明

说明
text 文本按钮
image 图片按钮

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("点击更多游戏")
});