mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-18 08:53:34 +08:00
2.5 KiB
2.5 KiB
RDraggableCard
基于 Naive UI Card 和 Interact.js。卡片 Teleport 到应用创建的容器,不参加原父节点的普通布局流。设置标题后可拖动卡片头部,否则拖动内容区;组件没有开放改变尺寸的交互。
| 属性 | 默认 | 说明 |
|---|---|---|
dad |
true |
是否启用拖拽。 |
restrictionElement |
'body' |
拖动边界,支持 CSS 选择器、元素或可解包的目标;选择器取第一个匹配。 |
restrictRectOptions |
默认边界,endOnly: true |
覆盖 Interact.js 边界限制。 |
defaultPosition |
{ x: 0, y: 0 } |
相对限制容器的偏移,或预设位置。 |
padding |
无 | 初次定位时相对边界的 { x, y } 间距。 |
width / zIndex |
600 / 无 |
卡片宽度与层级。 |
animation |
false |
启用进场过渡。 |
位置可用 top-left、top-right、bottom-left、bottom-right、center、top-center、bottom-center。替换 defaultPosition 引用会触发重定位;没有公开拖拽事件或位置持久化。选择器需要在布局中真实存在,容器应有明确尺寸。组件初始化会访问 document,仅在浏览器侧渲染。继承 Card 属性和插槽。
交互示例
::: details 查看示例源码 <<< @/../admin/src/views/demo/draggable-card.tsx :::
import { RDraggableCard } from '@/components'
export const renderFloatingHelp = () => (
<RDraggableCard
title="帮助"
width={320}
defaultPosition="bottom-right"
padding={{ x: 24, y: 24 }}
>
拖动标题可移动此卡片
</RDraggableCard>
)