docs(agents): add design references
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
---
|
||||
name: arco-vue-link
|
||||
description: "Arco Design Vue 链接 Link 组件参考。用于 Vue 3、`@arco-design/web-vue`、`<a-link>`、属性、事件、插槽、示例和实现细节。"
|
||||
user-invocable: false
|
||||
---
|
||||
|
||||
# 链接 Link
|
||||
|
||||
## 简介
|
||||
|
||||
链接的基本用法。
|
||||
|
||||
## 基本用法
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<a-space>
|
||||
<a-link href="link">Link</a-link>
|
||||
<a-link href="link" disabled>Link</a-link>
|
||||
</a-space>
|
||||
</template>
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
### `<link>` 属性
|
||||
|
||||
|参数名|描述|类型|默认值|版本|
|
||||
|---|---|---|:---:|:---|
|
||||
|href|链接地址|`string`|`-`||
|
||||
|status|链接的状态|`'normal' \| 'warning' \| 'success' \| 'danger'`|`'normal'`||
|
||||
|hoverable|鼠标悬浮时存在底色|`boolean`|`true`|2.7.0|
|
||||
|icon|图标|`boolean`|`false`|2.7.0|
|
||||
|loading|链接是否为加载中状态|`boolean`|`false`|2.37.0|
|
||||
|disabled|链接是否禁用|`boolean`|`false`||
|
||||
|
||||
### `<link>` 事件
|
||||
|
||||
|事件名|描述|参数|
|
||||
|---|---|---|
|
||||
|click|点击时触发|ev: `MouseEvent`|
|
||||
|
||||
## 常用模式
|
||||
|
||||
- **链接的状态**:链接的状态分为 `normal` - **正常(默认)**、`success` - **成功**、`warning` - **警告**、`danger` - **危险**四种。
|
||||
- **悬浮状态底色**:可以通过 hoverable 属性设置是否在悬浮状态时隐藏底色。
|
||||
- **图标**:通过 `icon` 设置带图标的链接,设置为 `true` 时候显示默认图标。
|
||||
- **加载中状态**:通过设置 `loading` 可以让链接处于加载中状态。处于加载中状态的链接不会触发点击事件。
|
||||
|
||||
## 最佳实践
|
||||
|
||||
- 新代码优先使用 Vue 3、Composition API 和 `<script setup lang="ts">`。
|
||||
- 模板属性使用 kebab-case,事件使用 `@event-name`,插槽使用 `#slot-name`。
|
||||
- 不要套用 React 专属 API,例如 JSX children、`Component.Sub` 或 `Form.useForm`。
|
||||
- 基础组件保持语义清晰,主操作、次操作和危险操作要用不同 `type` 或 `status` 区分。
|
||||
- 图标、按钮、链接等交互元素要同时考虑禁用、加载和可访问文本。
|
||||
Reference in New Issue
Block a user