70 lines
2.4 KiB
Markdown
70 lines
2.4 KiB
Markdown
|
---
|
|||
|
|
name: arco-vue-popover
|
|||
|
|
description: "Arco Design Vue 气泡卡片 Popover 组件参考。用于 Vue 3、`@arco-design/web-vue`、`<a-popover>`、属性、事件、插槽、示例和实现细节。"
|
|||
|
|
user-invocable: false
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 气泡卡片 Popover
|
|||
|
|
|
|||
|
|
## 简介
|
|||
|
|
|
|||
|
|
鼠标移入或点击，弹出气泡，可对浮层上元素进行操作，承载复杂内容和操作。
|
|||
|
|
|
|||
|
|
## 基本用法
|
|||
|
|
|
|||
|
|
```vue
|
|||
|
|
<template>
|
|||
|
|
<a-popover title="Title">
|
|||
|
|
<a-button>Hover</a-button>
|
|||
|
|
<template #content>
|
|||
|
|
<p>Here is the text content</p>
|
|||
|
|
<p>Here is the text content</p>
|
|||
|
|
</template>
|
|||
|
|
</a-popover>
|
|||
|
|
</template>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## API
|
|||
|
|
|
|||
|
|
### `<popover>` 属性
|
|||
|
|
|
|||
|
|
|参数名|描述|类型|默认值|
|
|||
|
|
|---|---|---|:---:|
|
|||
|
|
|popup-visible **(v-model)**|文字气泡是否可见|`boolean`|`-`|
|
|||
|
|
|default-popup-visible|文字气泡默认是否可见（非受控模式）|`boolean`|`false`|
|
|||
|
|
|title|标题|`string`|`-`|
|
|||
|
|
|content|内容|`string`|`-`|
|
|||
|
|
|trigger|触发方式|`'hover' \| 'click' \| 'focus' \| 'contextMenu'`|`'hover'`|
|
|||
|
|
|position|弹出位置|`'top' \| 'tl' \| 'tr' \| 'bottom' \| 'bl' \| 'br' \| 'left' \| 'lt' \| 'lb' \| 'right' \| 'rt' \| 'rb'`|`'top'`|
|
|||
|
|
|content-class|弹出框内容的类名|`ClassName`|`-`|
|
|||
|
|
|content-style|弹出框内容的样式|`CSSProperties`|`-`|
|
|||
|
|
|arrow-class|弹出框箭头的类名|`ClassName`|`-`|
|
|||
|
|
|arrow-style|弹出框箭头的样式|`CSSProperties`|`-`|
|
|||
|
|
|popup-container|弹出框的挂载容器|`string \| HTMLElement`|`-`|
|
|||
|
|
|
|||
|
|
### `<popover>` 事件
|
|||
|
|
|
|||
|
|
|事件名|描述|参数|
|
|||
|
|
|---|---|---|
|
|||
|
|
|popup-visible-change|文字气泡显示状态改变时触发|visible: `boolean`|
|
|||
|
|
|
|||
|
|
### `<popover>` 插槽
|
|||
|
|
|
|||
|
|
|插槽名|描述|参数|
|
|||
|
|
|---|:---:|---|
|
|||
|
|
|title|标题|-|
|
|||
|
|
|content|内容|-|
|
|||
|
|
|
|||
|
|
## 常用模式
|
|||
|
|
|
|||
|
|
- **触发方式**：通过设置 `trigger`，可以指定不同的触发方式。
|
|||
|
|
- **弹出位置**：`Popover`支持 12 个不同的方位。分别为：`上左` `上` `上右` `下左` `下` `下右` `左上` `左` `左下` `右上` `右` `右下`。
|
|||
|
|
|
|||
|
|
## 最佳实践
|
|||
|
|
|
|||
|
|
- 新代码优先使用 Vue 3、Composition API 和 `<script setup lang="ts">`。
|
|||
|
|
- 模板属性使用 kebab-case，事件使用 `@event-name`，插槽使用 `#slot-name`。
|
|||
|
|
- 不要套用 React 专属 API，例如 JSX children、`Component.Sub` 或 `Form.useForm`。
|
|||
|
|
- 数据展示组件只负责呈现，分页、筛选、排序等远程状态放在业务层维护。
|
|||
|
|
- 大数据量场景优先使用组件自带的分页、虚拟滚动或懒加载能力。
|