vant/docs/examples-docs/button.md
2017-08-09 19:12:56 +08:00

3.3 KiB

Button 按钮

代码演示

按钮功能

只接受primary, default, danger三种类型,默认default

:::demo 按钮功能

<van-row>
  <van-col span="24">
    <van-button block>default</van-button>
  </van-col>
  <van-col span="24">
    <van-button type="primary" block>primary</van-button>
  </van-col>
  <van-col span="24">
    <van-button type="danger" block>danger</van-button>
  </van-col>
</van-row>

:::

禁用状态

在组件上加上disabled属性即可,此时按钮不可点击。

:::demo 禁用状态

<van-row>
  <van-col span="24">
    <van-button disabled block>diabled</van-button>
  </van-col>
</van-row>

:::

按钮尺寸

只接受large, normal, small, mini四种尺寸,默认normallarge按钮默认100%宽度。

:::demo 按钮尺寸

<van-row>
  <van-col span="24">
    <van-button size="large">large</van-button>
  </van-col>
  <van-col span="24">
    <van-button size="normal">normal</van-button>
  </van-col>
  <van-col span="24">
    <van-button size="small">small</van-button>
  </van-col>
  <van-col span="24">
    <van-button size="mini">mini</van-button>
  </van-col>
</van-row>

:::

自定义按钮标签

按钮默认是button标签,可以使用tag属性修改为一个a标签。

:::demo 自定义按钮标签

<van-row>
  <van-col span="24">
    <van-button tag="a" type="primary" href="https://www.youzan.com" target="_blank">a标签按钮</van-button>
  </van-col>
</van-row>

:::

loading按钮

loading状态的按钮。

:::demo loading按钮

<van-row>
  <van-col span="24">
    <van-button type="primary" loading block>loading</van-button>
  </van-col>
  <van-col span="24">
    <van-button loading block></van-button>
  </van-col>
</van-row>

:::

页面底部操作按钮

一般用于fixed在底部的区域或是popup弹层的底部,一般只使用primarynormal两种状态。

:::demo 页面底部操作按钮

<van-row>
  <van-col span="24">
    <van-button type="primary" bottom-action>立即购买</van-button>
  </van-col>
</van-row>
<van-row>
  <van-col span="12">
    <van-button bottom-action>加入购物车</van-button>
  </van-col>
  <van-col span="12">
    <van-button type="primary" bottom-action>立即购买</van-button>
  </van-col>
</van-row>

:::

API

参数 说明 类型 默认值 可选值
type 按钮类型 string default primary, danger
size 按钮尺寸 string normal large, small, mini
tag 按钮标签 string button 任何有意义的html标签, 如a, span
diabled 按钮是否禁用 boolean false
block 按钮是否显示为块级元素 boolean false
bottomAction 按钮是否显示为底部行动按钮,一般显示在页面底部,有特殊样式 boolean false