拖动属性
`createDraggable()` 函数返回的 `Draggable` 实例上可用的属性。
const draggable = createDraggable(target, parameters);
┌──────────┐
draggable.│progressX │
draggable.│progressY ├─ Properties
draggable.│velocity │
└──────────┘
名称 | 描述 |
---|---|
snapX | 获取并设置 x 轴的吸附值 (`Number|Array<Number>`) |
snapY | 获取并设置 y 轴的吸附值 (`Number|Array<Number>`) |
滚动速度 | 获取并设置可拖动容器自动滚动的速度值 (`Number`) |
滚动阈值 | 获取并设置自动滚动开始前与容器边缘的阈值距离 (`Number`) |
拖拽速度 | 获取并设置可拖动元素被拖动的速度值 (`Number`) |
最大速度 | 获取并设置可拖动元素的最大速度限制 (`Number`) |
最小速度 | 获取并设置可拖动元素的最小速度限制 (`Number`) |
速度乘数 | 获取并设置应用于速度计算的乘数 (`Number`) |
释放缓动 | 获取并设置应用于可拖动元素动画的缓动函数 (`Function`) |
releaseSpring | 获取用于在释放后移动可拖动元素的内部弹簧 (`Spring`) |
容器内边距 | 获取并设置容器的内边距值 [上, 右, 下, 左] (`Array<Number>`) |
容器摩擦 | 获取并设置应用于容器内的摩擦力值 (`Number`) |
containerBounds | 获取容器的边界 [上, 右, 下, 左] (`Array<Number>`) |
containerArray | 如果提供了多个容器,则获取容器元素数组 (`Array<HTMLElement>|null`) |
$container | 获取并设置容器元素 (`HTMLElement`) |
$target | 获取并设置目标元素 (`HTMLElement`) |
$trigger | 获取触发元素 (`HTMLElement`) |
$scrollContainer | 获取滚动容器 (窗口或容器元素) (`Window|HTMLElement`) |
x | 获取并设置 x 坐标 (`Number`) |
y | 获取并设置被拖动元素的 y 坐标 (`Number`) |
progressX | 获取并设置 x 坐标相对于容器的进度 (0-1) (`Number`) |
progressY | 获取并设置 y 坐标相对于容器的进度 (0-1) (`Number`) |
velocity | 获取可拖动元素的当前速度 (`Number`) |
angle | 获取可拖动元素的当前弧度角 (`Number`) |
xProp | 获取映射的 x 属性名称 (`String`) |
yProp | 获取映射的 y 属性名称 (`String`) |
destX | 获取当前定义的 x 轴目标 (`Number`) |
destY | 获取当前定义的 y 轴目标 (`Number`) |
deltaX | 获取 x 轴的当前增量 (`Number`) |
deltaY | 获取 y 轴的当前增量 (`Number`) |
enabled | 如果可拖动元素已启用,则返回 `true` (`Boolean`) |
grabbed | 如果元素当前正在被抓取,则返回 `true` (`Boolean`) |
dragged | 如果元素当前正在被拖动,则返回 `true` (`Boolean`) |
光标 | 获取并设置光标行为 (`Boolean|DraggableCursorParams`) |
disabled | 获取 [x, y] 轴的禁用状态 (`Array<Number>`) |
fixed | 如果目标元素具有 `position:fixed` 样式,则返回 `true` (`Boolean`) |
useWin | 如果使用窗口作为容器,则返回 `true` (`Boolean`) |
isFinePointer | 获取并设置是否正在使用精细指针(例如鼠标) (`Boolean`) |
initialized | 如果可拖动元素已初始化,则返回 `true` (`Boolean`) |
canScroll | 如果可以自动滚动,则返回 `true` (`Boolean`) |
contained | 如果可拖动元素在边界内,则返回 `true` (`Boolean`) |
manual | 如果处于手动控制模式,则返回 `true` (`Boolean`) |
released | 如果元素刚刚被释放,则返回 `true` (`Boolean`) |
updated | 如果位置刚刚更新,则返回 `true` (`Boolean`) |
scroll | 获取当前滚动位置 {x, y} (`Object`) |
coords | 获取当前和之前的坐标 [x, y, prevX, prevY] (`Array<Number>`) |
snapped | 获取 [x, y] 轴的吸附状态 (`Array<Number>`) |
pointer | 获取当前和之前的指针位置 [x, y, prevX, prevY] (`Array<Number>`) |
scrollView | 获取滚动视图尺寸 [宽度, 高度] (`Array<Number>`) |
dragArea | 获取拖动区域边界 [x, y, 宽度, 高度] (`Array<Number>`) |
scrollBounds | 获取滚动容器边界 [上, 右, 下, 左] (`Array<Number>`) |
targetBounds | 获取目标元素边界 [上, 右, 下, 左] (`Array<Number>`) |
window | 获取窗口尺寸 [宽度, 高度] (`Array<Number>`) |
pointerVelocity | 获取当前指针速度 (`Number`) |
pointerAngle | 获取当前指针的弧度角 (`Number`) |
activeProp | 获取正在动画的活动属性 (`String`) |
onGrab | 获取并设置元素被抓取时触发的回调函数 (`Function`) |
onDrag | 获取并设置拖动时触发的回调函数 (`Function`) |
onRelease | 获取并设置释放时触发的回调函数 (`Function`) |
onUpdate | 获取并设置任意位置更新时触发的回调函数 (`Function`) |
onSettle | 获取并设置运动稳定时触发的回调函数 (`Function`) |
onSnap | 获取并设置元素吸附时触发的回调函数 (`Function`) |
onResize | 获取并设置容器/元素大小调整时触发的回调函数 (`Function`) |
onAfterResize | 获取并设置大小调整处理完成后触发的回调函数 (`Function`) |