docs(agents): add design references

This commit is contained in:
2026-08-10 23:34:28 +08:00
parent a2383fc8a1
commit 72a83f5fcd
86 changed files with 8889 additions and 0 deletions

View File

@@ -0,0 +1,64 @@
---
name: arco-vue-modal-patterns
description: "Arco Design Vue 弹窗与反馈模式。用于 `a-modal``v-model:visible`、确认流程、弹窗表单、Message、Notification 和 Drawer。"
user-invocable: false
---
# 弹窗与反馈模式
详细 API 参考 [modal.md](../components/feedback/modal.md)、[drawer.md](../components/feedback/drawer.md) 和 [message.md](../components/feedback/message.md)。
## 受控弹窗
```vue
<script setup lang="ts">
import { ref } from 'vue';
const visible = ref(false);
</script>
<template>
<a-button type="primary" @click="visible = true">打开</a-button>
<a-modal v-model:visible="visible" title="编辑">
<p>内容</p>
</a-modal>
</template>
```
## 弹窗内表单
```vue
<script setup lang="ts">
import { reactive, ref } from 'vue';
import { Message } from '@arco-design/web-vue';
const visible = ref(false);
const form = reactive({ name: '' });
const handleBeforeOk = async () => {
if (!form.name) {
Message.error('请输入名称');
return false;
}
Message.success('保存成功');
return true;
};
</script>
<template>
<a-modal v-model:visible="visible" title="编辑" :on-before-ok="handleBeforeOk">
<a-form :model="form" layout="vertical">
<a-form-item field="name" label="名称" required>
<a-input v-model="form.name" />
</a-form-item>
</a-form>
</a-modal>
</template>
```
## 使用要点
- 弹窗和抽屉的可见性使用 `v-model:visible`
- 异步确认、表单校验、关闭拦截使用文档中的 `on-before-ok` 或关闭前钩子。
- 轻量结果反馈使用 `Message`;需要标题、正文或更复杂内容时使用 `Notification`
- `Message``Notification` 是全局服务 API不是 `<a-message>``<a-notification>` 组件标签。