跳转到正文

RDraggableCard ​

基于 Naive UI Card 和 Interact.js。卡片 Teleport 到应用创建的容器,不参加原父节点的普通布局流。设置标题后可拖动卡片头部,否则拖动内容区;组件没有开放改变尺寸的交互。

属性默认说明
dadtrue是否启用拖拽。
restrictionElement'body'拖动边界,支持 CSS 选择器、元素或可解包的目标;选择器取第一个匹配。
restrictRectOptions默认边界,endOnly: true覆盖 Interact.js 边界限制。
defaultPosition{ x: 0, y: 0 }相对限制容器的偏移,或预设位置。
padding无初次定位时相对边界的 { x, y } 间距。
width / zIndex600 / 无卡片宽度与层级。
animationfalse启用进场过渡。

位置可用 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>
)

组件源码