抖音开放平台Logo
开发者文档
小程序
控制台
  • 组件概述
  • 基础内容
  • 视图容器
  • 表单
  • button 按钮
  • checkbox 多选选择器
  • checkbox-group 多项选择器
  • form 表单
  • input 输入框
  • label 表单组件标签
  • picker 底部弹起的滚动选择器
  • picker-view 嵌入页面的滚动选择器
  • picker-view-column 嵌入页面的滚动选择器子项
  • radio 单选项目
  • radio-group 单项选择器
  • slider 滑动选择器
  • switch 开关选择器
  • textarea 多行文本输入框
  • 导航
  • 媒体
  • 画布
  • 地图
  • 开放能力
  • 行业开放
  • 原生组件

    • form 表单
    收藏
    我的收藏

    基础库 1.0.0 开始支持本组件。
    表单，将组件内的用户输入的 switch、input、checkbox、slider、radio、picker 、textarea 提交。
    当点击 form 表单中 formType 为 submit 的 button 组件时，会将表单组件中的 value 值进行提交，需要在表单组件中加上 name 来作为 key。

    属性说明

    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    conversion-target
    number
    0
    否
    用于分发目的。取值：0 或 1，其中 0 表示默认，1 表示留资目标，需要和线索组件一起使用，详情见线索组件配置
    2.88.0
    clue-component-id
    string
    ""
    否
    用于分发目的。开发者在【小程序开发者后台 -> 进入目标小程序 -> 能力 -> 用户数据能力 -> 身份数据 -> 线索组件】申请能力后复制创建的配置 ID，需要和线索组件一起使用，详情见线索组件配置
    2.88.0
    bindsubmit
    EventHandle
    无
    否
    携带 form 中的数据触发 submit 事件，event.detail = {value : {'name': 'value'} , ...}。
    1.0.0
    bindreset
    EventHandle
    无
    否
    表单重置时会触发 reset 事件。
    1.0.0

    扫码体验

    代码示例

    Bug & Tip

    Tip：如果 form 组件被嵌套使用，在进行提交操作时，将会收集距离该按钮最近的祖先 form 组件中所覆盖的表单数据，并对其 value 进行提交。