# avatar (w-avatar)

- **Import**: `WAvatar` from `win-design-next`
- **Tag**: `<w-avatar>`
- **说明**: Avatar 头像
- **分类**: general
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/avatar.md`

## API

## API

### Attributes

| 名称    | 说明                                         | 类型                                                              | 默认值  |
| ------- | -------------------------------------------- | ----------------------------------------------------------------- | ------- |
| icon    | 设置 Avatar 的图标类型，具体参考 Icon 组件   | ^[string] / ^[Component]                                          | —       |
| size    | Avatar 大小                                  | ^[number] / ^[enum]`'large' \| 'default' \| 'small'`              | default |
| shape   | Avatar 形状                                  | ^[enum]`'circle' \| 'square'`                                     | circle  |
| src     | Avatar 图片的源地址                          | `string`                                                          | —       |
| src-set | 图片 Avatar 的原生 `srcset` 属性             | `string`                                                          | —       |
| alt     | 图片 Avatar 的原生 `alt` 属性                | `string`                                                          | —       |
| fit     | 当展示类型为图片的时候，设置图片如何适应容器 | ^[enum]`'fill' \| 'contain' \| 'cover' \| 'none' \| 'scale-down'` | cover   |

### Events

| 名称  | 说明               | 类型                            |
| ----- | ------------------ | ------------------------------- |
| error | 图片加载失败时触发 | ^[Function]`(e: Event) => void` |

### Slots

| 插槽名  | 说明               |
| ------- | ------------------ |
| default | 自定义头像展示内容 |
