| adjustExitTransitionByContentHeight | boolean | false | 否 | 根据内容高度动态调整退出动画。启用后,屏幕上的动画持续时间保持不变。因此,内容高度越大,退出速度越快,以确保动画在固定时间内完成。 |
| allowDragBeyondBottom | boolean | false | 否 | 如果为 true,则允许组件在拖动时超出底部边界。 |
| autoHeight | boolean | - | 否 | 自动弹窗高度,设置为 true 时,需要指定 contentId 属性,弹窗高度会根据内容高度动态变化,拖动区域在底部和当前高度之间,initHeight 和 maxHeight 不再有效 |
| bottomNode | ReactElement<any, string | JSXElementConstructor<any>> | - | 否 | 固定在弹窗底部的节点,不会受到拖动影响 |
| children | (prop: RenderFunction) => ReactElement | - | 是 | 弹窗的子元素 |
| closeOnMaskClick | boolean | true | 否 | 设置为 true 时,点击遮罩会关闭弹窗 |
| contentId | string | - | 否 | 弹窗内容的 ID, 在 autoHeight 为 true 时需要设置,用于获取内容高度 |
| contentStyle | CSSProperties | - | 否 | 弹窗内容的样式 |
| enableBounces | boolean | true | 否 | 是否需要松手回弹 |
| enableDrag | boolean | true | 否 | 是否启用拖动 |
| enableScrollContainerDraggable | boolean | true | 否 | 是否允许触摸在内部滚动容器区域时可拖拽Popup |
| enterDuration | number | 300 | 否 | 进入动画持续时间(毫秒) |
| enterEasingFunction | string | 'all ease-out' | 否 | 显示动画过渡效果 |
| exitDuration | number | 300 | 否 | 退出动画持续时间(毫秒) |
| exitEasingFunction | string | 'all ease-out' | 否 | 隐藏动画过渡效果 |
| heightPercent | HeightPercent | - | 否 | 弹窗的高度百分比 |
| main-thread:gesture | BaseGesture<BaseGestureConfig, GestureChangeEvent> | - | 否 | 如果你想使用手势,请使用这个属性 |
| maskEventThrough | boolean | false | 否 | 当设置为true的时候,遮罩事件会传递到子元素 |
| maskStyle | CSSProperties | - | 否 | 遮罩的样式 |
| maxHeight | number | screenHeight | 是 | 理论上能拖拽到的最大高度,当使用overlayMode时需要传入屏幕高度,当不使用overlayMode时,需要传入当前LynxView的高度 |
| onDrag | (eventParam: OnDragCallback) => void | - | 否 | 拖动回调 |
| onPopupPositionChange | (position: number) => void | - | 否 | 弹窗位置回调 |
| onPopupTopChange | (height: number) => void | - | 否 | 弹窗高度变化回调 |
| onRequestClose | () => void | - | 否 | 是否左滑或者点击返回键 |
| preload | boolean | true | 否 | 弹窗创建时预加载,这样在 visible 为 true 时会加快显示速度 |
| ref | ForwardedRef<PopupRef> | - | 否 | - |
| scrollContainerId | string | - | 是 | 根节点滚动容器的 ID(必需) |
| stopGesturePropagationWhenScrollAtTop | boolean | false | 否 | 当滚动容器滚动到顶部时,停止滚动容器的手势事件传播。 |