# [GameClubButton](/minigame/dev/api/open-api/game-club/GameClubButton) wx.createGameClubButton(Object object)

> 基础库 2.0.3 开始支持，低版本需做[兼容处理](1003706)。

> __微信 鸿蒙 OS 版__：支持

## 功能描述

创建游戏圈按钮。游戏圈按钮被点击后会跳转到小游戏的游戏圈。更多关于游戏圈的信息见 [游戏圈使用指南](/minigame/dev/guide/open-ability/game-club.md)。从基础库2.30.3开始，新增传递openlink的特性，支持打开单帖子、话题页、活动页。

## 参数

### Object object


```json
[
  {
    "属性": "type",
    "类型": "string",
    "默认值": "",
    "必填": "是",
    "说明": "按钮的类型。",
    "最低版本": "",
    "子项": [
      {
        "合法值": "text",
        "说明": "可以设置背景色和文本的按钮"
      },
      {
        "合法值": "image",
        "说明": "只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高"
      }
    ]
  },
  {
    "属性": "text",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "按钮上的文本，仅当 type 为 \u0000INLINECODE_0\u0000 时有效",
    "最低版本": ""
  },
  {
    "属性": "image",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "按钮的背景图片，仅当 type 为 \u0000INLINECODE_1\u0000 时有效",
    "最低版本": ""
  },
  {
    "属性": "style",
    "类型": "Object",
    "默认值": "",
    "必填": "是",
    "说明": "按钮的样式",
    "最低版本": "",
    "子项": [
      {
        "结构属性": "left",
        "类型": "number",
        "默认值": "",
        "必填": "是",
        "说明": "左上角横坐标"
      },
      {
        "结构属性": "top",
        "类型": "number",
        "默认值": "",
        "必填": "是",
        "说明": "左上角纵坐标"
      },
      {
        "结构属性": "width",
        "类型": "number",
        "默认值": "",
        "必填": "是",
        "说明": "宽度"
      },
      {
        "结构属性": "height",
        "类型": "number",
        "默认值": "",
        "必填": "是",
        "说明": "高度"
      },
      {
        "结构属性": "backgroundColor",
        "类型": "string",
        "默认值": "",
        "必填": "是",
        "说明": "背景颜色"
      },
      {
        "结构属性": "borderColor",
        "类型": "string",
        "默认值": "",
        "必填": "否",
        "说明": "边框颜色"
      },
      {
        "结构属性": "borderWidth",
        "类型": "number",
        "默认值": "",
        "必填": "否",
        "说明": "边框宽度"
      },
      {
        "结构属性": "borderRadius",
        "类型": "number",
        "默认值": "",
        "必填": "否",
        "说明": "边框圆角"
      },
      {
        "结构属性": "color",
        "类型": "string",
        "默认值": "",
        "必填": "否",
        "说明": "文本的颜色。格式为 6 位 16 进制数。"
      },
      {
        "结构属性": "textAlign",
        "类型": "string",
        "默认值": "",
        "必填": "否",
        "说明": "文本的水平居中方式",
        "子项": [
          {
            "合法值": "left",
            "说明": "居左"
          },
          {
            "合法值": "center",
            "说明": "居中"
          },
          {
            "合法值": "right",
            "说明": "居右"
          }
        ]
      },
      {
        "结构属性": "fontSize",
        "类型": "number",
        "默认值": "",
        "必填": "否",
        "说明": "字号"
      },
      {
        "结构属性": "lineHeight",
        "类型": "number",
        "默认值": "",
        "必填": "否",
        "说明": "文本的行高"
      }
    ]
  },
  {
    "属性": "icon",
    "类型": "string",
    "默认值": "",
    "必填": "是",
    "说明": "游戏圈按钮的图标，仅当 object.type 参数为 image 时有效。",
    "最低版本": "",
    "子项": [
      {
        "合法值": "green",
        "说明": "绿色的图标"
      },
      {
        "合法值": "white",
        "说明": "白色的图标"
      },
      {
        "合法值": "dark",
        "说明": "有黑色圆角背景的白色图标"
      },
      {
        "合法值": "light",
        "说明": "有白色圆角背景的绿色图标"
      }
    ]
  },
  {
    "属性": "openlink",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "设置后可以跳到对应的活动页面，具体进入「MP后台-能力地图-游戏圈」-由帖子的\"游戏内跳转ID\"生成",
    "最低版本": "[2.30.3](1003706)"
  },
  {
    "属性": "hasRedDot",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "当传递了openlink值时，此字段生效，决定创建的按钮是否需要拥有红点，默认为true",
    "最低版本": "[2.30.3](1003706)"
  }
]
```

## 返回值

### [GameClubButton](/minigame/dev/api/open-api/game-club/GameClubButton)

## 示例代码

```javascript

let button = wx.createGameClubButton({
  icon: 'green',
  style: {
    left: 10,
    top: 76,
    width: 40,
    height: 40
  },
  openlink: 'Lv-XO1OgAuqztP4pRyKfZnY2aJKe9aE1'
})

```