Tag 标签

定义/Definition

进行标记和分类的小标签,用于标记事物的属性和维度,以及进行分类。

规则 / Rule

  • 移动端标签文字必须显示完全,标签内允许文字换行;

  • 只读型样式设计避免有点击感

代码演示

标签类型

标签类型分为选择型标签和只读型标签,只读型标签无交互过程,仅展示内容。

  1. import { Tag, WingBlank, WhiteSpace } from 'antd-mobile';
  2. ReactDOM.render(
  3. <div className="tag-container">
  4. <WhiteSpace />
  5. <WingBlank size={20}>
  6. <Tag type="action" size="large">大号标签</Tag>
  7. <WhiteSpace />
  8. <Tag type="action" size="small">小号标签</Tag>
  9. <WhiteSpace />
  10. <Tag type="read" size="large">只读标签大</Tag>
  11. <WhiteSpace />
  12. <Tag type="read" size="small">只读标签小</Tag>
  13. <WhiteSpace />
  14. </WingBlank>
  15. <WhiteSpace />
  16. </div>
  17. , mountNode);

标签失效状态

添加 disabled 属性即可让标签处于不可用状态,同时标签样式也会改变。

  1. import { Tag, WingBlank, WhiteSpace } from 'antd-mobile';
  2. ReactDOM.render(
  3. <div className="tag-container">
  4. <WhiteSpace />
  5. <WingBlank size={20}>
  6. <Tag type="action" disabled>不可点大标签</Tag>
  7. <WhiteSpace />
  8. <Tag type="action" size="small" disabled>不可点小标签</Tag>
  9. <WhiteSpace />
  10. </WingBlank>
  11. <WhiteSpace />
  12. </div>
  13. , mountNode);

可关闭标签

添加 closeable 属性可以让标签项消失,当手势点击到整个标签的热区时,该标签项就被删除。

  1. import { Tag, WingBlank, WhiteSpace } from 'antd-mobile';
  2. function onClose() {
  3. console.log('tag closing');
  4. }
  5. function afterClose() {
  6. console.log('tag closed');
  7. }
  8. function onChange(selected) {
  9. console.log(`tag selected: ${selected}`);
  10. }
  11. ReactDOM.render(
  12. <div className="tag-container">
  13. <WhiteSpace />
  14. <WingBlank size={20}>
  15. <Tag type="action" size="large" closable>可关闭标签</Tag>
  16. <WhiteSpace />
  17. <Tag
  18. type="action"
  19. size="large"
  20. closable
  21. onClose={onClose}
  22. onChange={onChange}
  23. afterClose={afterClose}
  24. >事件</Tag>
  25. </WingBlank>
  26. <WhiteSpace />
  27. </div>
  28. , mountNode);

标签选中项

添加 selected 属性即可让标签处于被选中状态。

  1. import { Tag, WingBlank, WhiteSpace } from 'antd-mobile';
  2. ReactDOM.render(
  3. <div className="tag-container">
  4. <WhiteSpace />
  5. <WingBlank size={20}>
  6. <Tag type="action" size="large" selected>大号标签默认选中</Tag>
  7. <WhiteSpace />
  8. <Tag type="action" size="small" selected>小号标签默认选中</Tag>
  9. <WhiteSpace />
  10. </WingBlank>
  11. <WhiteSpace />
  12. </div>
  13. , mountNode);

Tag标签 - 图1

API

成员说明类型默认值
typeTag 类型,可选值为action(操作)或 read(只读)Stringread
sizeTag 大小,可选值为largesmallStringlarge
closable是否可关闭, type='action' & size='large'Booleanfalse
disabled是否不可用Booleanfalse
onChange切换选中回调函数Function
onClose关闭前的回调Function
afterClose关闭后的回调Function