Button
概述
目前仅可通过预定义的类名(而不是 mixin)来设置按钮样式。
为元素添加
.cm-btn
类名,即可得到一个实色按钮。
注意:Firefox 48- 可能无法正常显示实色标签效果。
.cm-btn
- 实色按钮
需要空心按钮(ghost button)?为按钮追加
.cm-btn-bordered
类就可以了。(以下所有段落都同时提供了实色按钮和实心按钮内的效果。)
.cm-btn.cm-btn-bordered
- 边框型按钮
其它说明
- CMUI 提供了大量辅助类,用于设置按钮的尺寸、颜色等样式。这些辅助类通常可以组合使用。
- 所有按钮默认显示为块级,可以按需对特定按钮指定宽度属性。
- 不建议在文本段落中混入按钮。
按钮尺寸
为按钮添加尺寸辅助类,可以设置其尺寸。
.cm-btn.cm-btn-xs
.cm-btn.cm-btn-s
.cm-btn
.cm-btn.cm-btn-l
.cm-btn.cm-btn-xl
场景类型
按钮在不同的功能场景下,往往体现为不同的颜色。CMUI 定义了以下场景类名。
.cm-btn.cm-btn-primary
.cm-btn.cm-btn-info
.cm-btn.cm-btn-success
.cm-btn.cm-btn-danger
.cm-btn.cm-btn-warning
表单按钮
以上的各个类名除了可以用于 <a>
元素外,还可用于
<input>
和 <button>
这样的表单按钮元素。
表单内的按钮应该优先选择表单元素来实现。
表单按钮天生具备收缩包围的特性,在不指定宽度时,它们只呈现最小宽度。为使它们呈现出通长的块级效果,已对它们设置
width: 100%;
。
input.cm-btn @type="button"
button.cm-btn
按钮状态
悬停状态
鼠标悬停时可见此状态,不需要修改结构。
触屏设备可能不支持此状态。
激活状态
鼠标按下或手指触摸时可见此状态,不需要修改结构。
如果需要按钮一直保持在激活的状态(比如你需要做一个具有开关功能的按钮),可以通过添加
.active
类来实现效果。效果如下(仅列出两种颜色的示例):
.cm-btn.active
.cm-btn.cm-btn-primary.active
禁用状态
表单按钮(<button>
、<input>
元素)具有
disabled
属性时,可见此状态。
对于由 <a>
元素实现的按钮,需要添加
.disabled
类。
不同颜色按钮的禁用效果都是一样的:
a.cm-btn.disabled
注意
- 被禁用的按钮添加
.active
类无效。 - 被禁用的按钮无法响应点击动作。如果你真的需要监听它们的点击事件,则只能为它们包一层容器,然后监听容器的点击事件。
按钮的排列组合
并排的按钮
如果需要呈现并排的按钮,请使用以下结构:
.cm-btn-line
.cm-btn
.cm-btn
.cm-btn
注意
如果需要调整各按钮的宽度,建议给 max-width
和
min-width
属性指定百分比值。
按钮组合
如果需要将多个按钮合并为一组,请使用以下结构:
.cm-btn-group
.cm-btn
.cm-btn
.cm-btn