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、padding 或边界引用会触发重定位,开关 dad 保留当前位置;没有公开拖拽事件或位置持久化。选择器需要在布局中真实存在,容器应有明确尺寸。服务端不创建拖拽 DOM;浏览器挂载后建立交互,关闭拖拽或卸载时释放监听器,最后一个卡片卸载后移除共享容器。继承 Card 属性和插槽,进场动画尊重减少动态效果设置。
交互示例
查看示例源码
tsx
import { useI18n } from '@/hooks'
import RDraggableCard from '@ray-template/ui/draggable-card'
import type { DefaultPosition } from '@ray-template/ui/draggable-card'
import { NButton, NCard, NFlex, NSelect, NSwitch, NTag } from 'naive-ui'
import DemoPage from './components/DemoPage'
const positions = [
'center',
'top-center',
'bottom-center',
'top-left',
'top-right',
'bottom-left',
'bottom-right',
] as const
const options = positions.map((value) => ({ label: value, value }))
export default defineComponent({
name: 'DraggableCardDemo',
setup() {
const { t } = useI18n('demoDetails')
const target = useTemplateRef<HTMLElement>('target')
const position = ref<DefaultPosition>('center')
const draggable = ref(true)
const scope = ref<'bounded' | 'body' | null>(null)
return () => (
<DemoPage title={t('drag.title')} description={t('drag.intro')}>
<NCard title={t('drag.stage')}>
<div class="r-demo-card-stack">
<NFlex align="center">
<NSelect
value={position.value as string}
options={options}
style={{ width: '150px' }}
aria-label={t('drag.position')}
onUpdateValue={(value: DefaultPosition) => {
position.value = value
}}
/>
<NSwitch
v-model:value={draggable.value}
aria-label={t('drag.enable')}
/>
<NTag bordered={false}>
{draggable.value ? t('drag.enable') : t('drag.locked')}
</NTag>
<NButton
type="primary"
onClick={() => {
scope.value = scope.value === 'bounded' ? null : 'bounded'
}}
>
{t('drag.bounded')}
</NButton>
<NButton
onClick={() => {
scope.value = scope.value === 'body' ? null : 'body'
}}
>
{t('drag.body')}
</NButton>
</NFlex>
<div ref="target" class="r-demo-stage r-demo-stage--drag">
<span>{t('drag.bounds')}</span>
</div>
</div>
</NCard>
{scope.value && target.value && (
<RDraggableCard
restrictionElement={
scope.value === 'bounded' ? target.value : 'body'
}
width="min(220px, calc(100vw - 56px))"
defaultPosition={position.value}
title={t(`drag.${scope.value}`)}
closable
dad={draggable.value}
onClose={() => {
scope.value = null
}}
>
<NTag bordered={false}>
{draggable.value ? t('drag.enable') : t('drag.locked')}
</NTag>
</RDraggableCard>
)}
</DemoPage>
)
},
})tsx
import { RDraggableCard } from '@/components'
export const renderFloatingHelp = () => (
<RDraggableCard
title="帮助"
width={320}
defaultPosition="bottom-right"
padding={{ x: 24, y: 24 }}
>
拖动标题可移动此卡片
</RDraggableCard>
)