Button 按钮
注意:非 template/render 模式下,需使用 。
按钮类型
按钮类型有:默认按钮、主按钮、虚线按钮、文字按钮以及四种颜色按钮。
通过设置type
为primary
、dashed
、text
、info
、success
、warning
、error
创建不同样式的按钮,不设置为默认样式。
幽灵按钮将其他按钮的内容反色,背景变为透明,常用在有色背景上。
<template>
<Button type="default" ghost>Default</Button>
<Button type="primary" ghost>Primary</Button>
<Button type="dashed" ghost>Dashed</Button>
<Button type="text" ghost>Text</Button>
<Button type="info" ghost>Info</Button>
<Button type="success" ghost>Success</Button>
<Button type="warning" ghost>Warning</Button>
<Button type="error" ghost>Error</Button>
</template>
<script>
export default {
}
</script>
图标按钮及按钮形状
通过设置icon
属性在Button
内嵌入一个Icon
,或者直接在Button
内使用Icon
组件。
使用Button
的icon
属性,图标位置将在最左边,如果需要自定义位置,需使用Icon
组件。
通过设置shape
属性为circle
,可将按钮置为圆的形状。
<template>
<Button type="primary" shape="circle" icon="ios-search"></Button>
<Button type="primary" icon="ios-search">Search</Button>
<Button type="primary" shape="circle" icon="ios-search">Search</Button>
<Button type="primary" shape="circle">Circle</Button>
<br><br>
<Button shape="circle" icon="ios-search"></Button>
<Button icon="ios-search">Search</Button>
<Button shape="circle" icon="ios-search">Search</Button>
<Button shape="circle">Circle</Button>
</template>
<script>
export default {
}
</script>
按钮有三种尺寸:大、默认(中)、小
通过设置size
为large
和small
将按钮设置为大和小尺寸,不设置为默认(中)尺寸。
长按钮
通过设置属性 long
可将按钮宽度设置为 100%,常用于弹窗内操作按钮。
使用者也可以直接通过给组件添加 style
来设置更细节的样式,比如定宽。
<template>
<Button type="success" long>SUBMIT</Button>
<br><br>
<Button type="error" long>DELETE</Button>
</template>
<script>
export default {
}
</script>
通过添加disabled
属性可将按钮设置为不可用状态。
<template>
<Button>Default</Button>
<Button disabled>Default(Disabled)</Button>
<br>
<Button type="primary">Primary</Button>
<Button type="primary" disabled>Primary(Disabled)</Button>
<br>
<Button type="dashed">Dashed</Button>
<Button type="dashed" disabled>Dashed(Disabled)</Button>
<br>
<Button type="text">Text</Button>
<script>
export default {
}
</script>
加载中状态
通过添加loading
属性可以让按钮处于加载中状态,后两个按钮在点击时进入加载状态。
将多个Button
放入ButtonGroup
内,可实现按钮组合的效果。
通过设置ButtonGroup
的属性size
为large
和small
,可将按钮组尺寸设置为大和小,不设置size
,则为默认(中)尺寸。
通过设置ButtonGroup
的属性shape
为circle
,可将按钮组形状设置为圆角。
<template>
<h4>Basic</h4>
<br><br>
<ButtonGroup>
<Button>Cancel</Button>
<Button type="primary">Confirm</Button>
</ButtonGroup>
<ButtonGroup>
<Button disabled>Yesterday</Button>
<Button disabled>Today</Button>
<Button disabled>Tomorrow</Button>
</ButtonGroup>
<ButtonGroup>
<Button type="primary">L</Button>
<Button>M</Button>
<Button>M</Button>
<Button type="dashed">R</Button>
</ButtonGroup>
<br><br>
<h4>Icons</h4>
<br><br>
<ButtonGroup>
<Button type="primary">
<Icon type="ios-arrow-back"></Icon>
Backward
</Button>
<Button type="primary">
Forward
<Icon type="ios-arrow-forward"></Icon>
</Button>
</ButtonGroup>
<ButtonGroup>
<Button type="primary" icon="ios-skip-backward"></Button>
<Button type="primary" icon="ios-skip-forward"></Button>
</ButtonGroup>
<ButtonGroup>
<Button icon="ios-color-wand-outline"></Button>
<Button icon="ios-sunny-outline"></Button>
<Button icon="ios-crop"></Button>
<Button icon="ios-color-filter-outline"></Button>
</ButtonGroup>
<br><br>
<h4>Circle</h4>
<br><br>
<ButtonGroup shape="circle">
<Button type="primary">
<Icon type="ios-arrow-back"></Icon>
Backward
</Button>
<Button type="primary">
Forward
<Icon type="ios-arrow-forward"></Icon>
</ButtonGroup>
<ButtonGroup shape="circle">
<Button type="primary" icon="ios-skip-backward"></Button>
<Button type="primary" icon="ios-skip-forward"></Button>
</ButtonGroup>
<ButtonGroup shape="circle">
<Button icon="ios-sunny-outline"></Button>
<Button icon="ios-crop"></Button>
<Button icon="ios-color-filter-outline"></Button>
</ButtonGroup>
<br><br>
<h4>Size</h4>
<br><br>
<ButtonGroup size="large">
<Button>Large</Button>
<Button>Large</Button>
</ButtonGroup>
<ButtonGroup>
<Button>Default</Button>
<Button>Default</Button>
</ButtonGroup>
<ButtonGroup size="small">
<Button>Small</Button>
<Button>Small</Button>
</ButtonGroup>
<br><br>
<ButtonGroup size="large" shape="circle">
<Button>Large</Button>
<Button>Large</Button>
</ButtonGroup>
<ButtonGroup shape="circle">
<Button>Default</Button>
<Button>Default</Button>
</ButtonGroup>
<ButtonGroup size="small" shape="circle">
<Button>Small</Button>
<Button>Small</Button>
</ButtonGroup>
</template>
<script>
export default {
}
</script>
通过设置ButtonGroup
的属性vertical
,可以使按钮组纵向排列。
<template>
<ButtonGroup vertical>
<Button icon="logo-facebook"></Button>
<Button icon="logo-twitter"></Button>
<Button icon="logo-googleplus"></Button>
<Button icon="logo-tumblr"></Button>
</ButtonGroup>
</template>
<script>
export default {
}
跳转
通过设置 to
可以实现点击按钮直接跳转,支持传入 vue-router 对象。
设置 replace
则不会保存历史记录。
设置 target
,会跟 a 标签一样的行为。
API
ButtonGroup props
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
size | 按钮组合大小,可选值为large 、small 、default 或者不设置 | String | default |
shape | 按钮组合形状,可选值为或者不设置 | String | - |
vertical | 是否纵向排列按钮组 | Boolean | false |