Skip to content
能力中心
产品中心
应用市场
WebOffice
开发者后台

按钮

可使用按钮实现用户交互

参数说明

名称是否必填参数类型说明
buttonobject按钮组件配置
∟ tagstring组件的标签,按钮组件tag=button
∟ stylestring按钮样式,支持以下类型:
- normal:蓝色字体按钮,有边框(主要按钮)
- secondary:黑色字体按钮,有边框(辅助按钮)
- warn:红色字体按钮,有边框(警示按钮)
- disable:灰色字体按钮,有边框(禁用按钮)
- text:黑色字体按钮,无边框
- primary_text:蓝色字体按钮,无边框
- danger_text:红色字体按钮,无边框
- primary_filled:蓝底白字按钮
- danger_filled:红底白字按钮
∟ textobject文本内容
∟ ∟ typestring文本类型,支持 plain 和 markdown 两种类型
∟ ∟ contentstring文本内容
∟ linkobject组件整体的跳转链接
∟ ∟ urlstring默认的链接地址
∟ ∟ pc_urlstringPC 端的链接地址
∟ ∟ ios_urlstringiOS 端的链接地址
∟ ∟ android_urlstringAndroid 端的链接地址
∟ keystring用于回传标识,会将该字段值回传(回传必须)
∟ requiredbool控制用户回传参数是否必填,false:非必传,true:必传。默认为 false
∟ modalobject按钮操作后的弹窗
∟ ∟ tagstring组件的标签,弹窗组件tag=modal
∟ ∟ headerstring弹窗的标题
∟ ∟ contentarray弹窗内的填写框
∟ ∟ ∟ tagstring固定为textarea
∟ ∟ ∟ namestring填写框名称
∟ ∟ ∟ sizestring填写内容字数上限
∟ ∟ ∟ placeholderstring默认提示文案
∟ ∟ ∟ typestring枚举值:input_box==输入框;prompt_box==提示框
∟ ∟ ∟ promptstring提示内容
∟ ∟ footerarray弹窗底部按钮
∟ ∟ ∟ confirmstring确认按钮的内容
∟ ∟ ∟ ∟ typestring文本类型,支持 plain 和 markdown 两种类型
∟ ∟ ∟ ∟ contentstring文本内容
∟ ∟ ∟ cancelstring取消按钮的内容
∟ ∟ ∟ ∟ typestring文本类型,支持 plain 和 markdown 两种类型
∟ ∟ ∟ ∟ contentstring文本内容
∟ widthstring宽度(默认宽度:default;填满父容器:fill;自定义宽度:[100,∞)px
∟ iconobject前缀图标配置
∟ ∟ tagstring图标类型,目前仅支持 custom_icon
∟ ∟ storage_keystring图片存储key
∟ ∟ tokenstring图片token
∟ disabled_tipsobject禁用提示
∟ ∟ typestring文本类型,固定为 plain
∟ ∟ contentstring文本内容
∟ hover_tipsobject悬停提示
∟ ∟ typestring文本类型,固定为 plain
∟ ∟ contentstring文本内容
∟ marginstring外边距(支持自定义上、下、左、右外边距,可修改任意一边/多边,值的取值范围为 [-99,99]px。超出取值范围时,将按最大支持范围展示),例如 20px 20px 20px 20px

图片示例

按钮组件

JSON结构

json
{
  "button": {
    "tag": "button",
    "text": {
      "content": "文本内容",
      "type": "枚举值:plain==纯文本;markdown==markdown;"
    },
    "style": "枚举值:normal==主要按钮;secondary==辅助按钮;warn==警示按钮;disable==禁用按钮",
    "link": {
      "android_url": "",
      "ios_url": "",
      "pc_url": "",
      "url": "默认链路url"
    },
    "key": "用于回传标识,会将该字段值回传(回传必须)",
    "required": false,
    "modal": {
      "tag": "modal",
      "header": "标题",
      "content": [
        {
          "tag": "textarea",
          "name": "交互标识",
          "size": "内容大小",
          "placeholder": "默认提示文案",
          "type": "枚举值:input_box==输入框;prompt_box==提示框",
          "prompt": "提示内容"
        }
      ],
      "footer": {
        "confirm": {
          "content": "确认",
          "type": "枚举值:plain==纯文本;markdown==markdown;"
        },
        "cancel": {
          "content": "取消",
          "type": "枚举值:plain==纯文本;markdown==markdown;"
        }
      }
    },
    "width": "100px",
    "icon": {
      "tag": "custom_icon",
      "storage_key": "图片存储key"
    },
    "disabled_tips": {
      "type": "plain",
      "content": "禁用提示"
    },
    "hover_tips": {
      "type": "plain",
      "content": "悬停提示"
    },
    "margin": "20px 20px 20px 20px"
  }
}