# Tag 标签

### 介绍

用于标记和分类的标签。

### 安装

``` javascript
// react
import { Tag } from '@nutui/nutui-react';
```

## 代码实例

### 基础用法

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag type="primary">标签</Tag>
      <Tag type="success">标签</Tag>
      <Tag type="danger">标签</Tag>
      <Tag type="warning">标签</Tag>
    </>
  )
}
export default App;
```

:::

### 空心样式

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag plain>标签</Tag>
    </>
  )
}
export default App;
```

:::

### 圆角样式

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag round type="primary">标签</Tag>
    </>
  )
}
export default App;
```

:::

### 标记样式

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag mark type="primary">标签</Tag>
    </>
  )
}
export default App;
```

:::

### 可关闭标签

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag  closeable onClose={()=>alert('Tag closed')}  type="primary">标签</Tag>
    </>
  )
}
export default App;
```

:::

### 自定义颜色

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag color="#FA685D">标签</Tag>
      <Tag color="#E9E9E9" textColor="#999999">标签</Tag>
      <Tag color="#FA2400" plain>标签</Tag>
    </>
  )
}
export default App;
```

:::


### 点击事件

:::demo

```tsx
import React from "react";
import { Tag } from '@nutui/nutui-react';

const App = () => {
  return (
    <>
      <Tag type='primary' onClick={()=>alert('Tag clicked')}>标签</Tag>
    </>
  )
}
export default App;
```

:::

### 展示控制

:::demo

```tsx
import React, {useState} from "react";
import { Tag,Button } from '@nutui/nutui-react';

const App = () => {
  const  [isShow,setIsShow] = useState(true) // 是否展示Tag组件
  return (
    <>
    {
      isShow? (
        <Tag type='primary' onClick={()=>alert('Tag clicked')}>标签</Tag>
      ):null
    }  
    <Button type='default' size="small" onClick={()=>{setIsShow(false)}} >点击删除Tag</Button>
    </>
  )
  
}
export default App;
```

:::
## API

### Props

| 字段       | 说明                                             | 类型    | 默认值    |
|------------|--------------------------------------------------|---------|-----------|
| type       | 标签类型，可选值为primary success danger warning | string  | `default` |
| color      | 标签颜色                                         | string  | -         |
| texColor | 文本颜色，优先级高于color属性                    | string  | `white`   |
| plain      | 是否为空心样式                                   | boolean | `false`   |
| round      | 是否为圆角样式                                   | boolean | `false`   |
| mark       | 是否为标记样式                                   | boolean | `false`   |
| closeable  | 是否为可关闭标签                                 | boolean | `false`   |
| iconSize`v1.4.7` | 关闭标签的尺寸 | string \| number | `12px`|

### Event

| 事件名称 | 说明     | 回调参数 |
|----------|----------|----------|
| onClick`v1.2.2`    | 点击事件 | `event`    |
| onClose    | 关闭事件 | `event`    |



## 主题定制

### 样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 [ConfigProvider 组件](#/zh-CN/component/configprovider)。

| 名称 | 默认值 |
| --- | --- |
| --nutui-tag-padding | `0 4px`|
| --nutui-tag-font-size | `12px` |
| --nutui-tag-default-border-radius | `4px` |
| --nutui-tag-round-border-radius | `8px` |
| --nutui-tag-default-background-color | `#000000` |
| --nutui-tag-primary-background-color | `#3460fa` |
| --nutui-tag-success-background-color | `#4fc08d` |
| --nutui-tag-danger-background-color-plain | `#df3526` |
| --nutui-tag-warning-background-color | `#f3812e` |
| --nutui-tag-default-color | `#ffffff` |
| --nutui-tag-border-width | `1px` |
| --nutui-tag-height | `auto` |
