Skip to main content
Version: 3.x

DraggableSheet

半屏可拖拽组件 该组件需配合 DraggableSheetContext 接口使用。 目前仅在 Skyline 渲染引擎下支持。 页面内拖拽是一种常见的交互效果,开发者可通过手势系统灵活实现。draggable-sheet 组件封装了常见的交互逻辑,实现起来更加简单。 该组件需结合 scroll-view 使用。scroll-view 组件声明 associative-container 属性后,可与 draggable-sheet 关联起来。

支持情况:

参考文档

类型

ComponentType<DraggableSheetProps>

DraggableSheetProps

参数类型默认值必填说明
initialChildSizenumber0.5初始时占父容器的比例
minChildSizenumber0.25最小时占父容器的比例
maxChildSizenumber1.0最大时占父容器的比例
snapbooleanfalse拖拽后是否自动对齐关键点
snapSizesany[][]拖拽后对齐的关键点,无需包含最小和最大值
onSizeUpdateWorkletstring尺寸发生变化时触发,仅支持 worklet 作为回调。event = {pixels, size}

API 支持度

API微信小程序H5React NativeHarmony
DraggableSheetProps.initialChildSize✔️
DraggableSheetProps.minChildSize✔️
DraggableSheetProps.maxChildSize✔️
DraggableSheetProps.snap✔️
DraggableSheetProps.snapSizes✔️
DraggableSheetProps.onSizeUpdateWorklet✔️