# RModal 与弹窗
`RModal` 继承 Naive UI Modal 的 `show`、`preset`、关闭事件和插槽,增加预设宽度和全屏卡片。声明式弹窗通过 `show` / `onUpdateShow` 或 `v-model:show` 控制。
```tsx
import { RModal } from '@/components'
import { NButton } from 'naive-ui'
import { defineComponent, ref } from 'vue'
export default defineComponent({
setup() {
const show = ref(false)
return () => (
<>
{
show.value = true
}}
>
查看报表
{
show.value = value
}}
preset="card"
title="库存报表"
cardWidth={960}
>
报表内容
>
)
},
})
```
| 属性 | 默认 | 作用范围 |
| ------------- | ------- | -------------------------- |
| `width` | `600` | 未指定预设时的宽度。 |
| `cardWidth` | `600` | `preset="card"` 的宽度。 |
| `dialogWidth` | `446` | `preset="dialog"` 的宽度。 |
| `fullscreen` | `false` | 仅 `card` 预设生效。 |
宽度接受数字或 CSS 尺寸。`fullscreen` 让卡片占满窗口,正文在溢出时滚动;它不调用浏览器全屏。`default`、`header`、`footer` 等插槽依 Naive UI 预设处理,组件原样转发。
## 交互示例
::: details 查看示例源码
<<< @/../admin/src/views/demo/modal-demo/index.tsx
:::
## 命令式弹窗
`@/components` 的 `useModal()` 已弃用,兼容代码仍可通过 `create(options)` 和 `destroyAll()` 调用。`create` 返回 Naive UI 弹窗句柄,支持 `fullscreen`、`width`、`cardWidth`、`dialogWidth` 等兼容配置。新代码从 `naive-ui` 导入 `useModal`,在 `NModalProvider` 的后代调用;需要模板专用全屏样式时用声明式 `RModal`。提示用户确认危险操作时也可以用全局 [Dialog Provider](./app)。
[组件源码](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RModal/src/Modal.tsx) · [兼容 Hook](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RModal/src/hooks/useModal.ts) · [回归用例](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/__test__/components/modal.spec.ts)