Skip to content

FloatDrawer 浮动面板 ​

uvx-float-drawer 提供可拖拽高度的浮动抽屉,支持阻尼、惯性、最小/最大高度和位置事件。高度相关属性单位为 vh,手柄高度和圆角单位为 px。

平台兼容性 ​

AndroidiOS鸿蒙H5微信
3.9+4.11+4.61+4.0+4.41+

基础用法 ​

vue
<uvx-float-drawer :initial-height="35" :max-height="70" :min-height="35">
   <template #main><view><text>页面主内容</text></view></template>
   <template #float><view><text>面板内容</text></view></template>
</uvx-float-drawer>

页面内容放在 main 插槽,浮动面板内容放在 float 插槽;组件不渲染默认插槽内容。position-change 的 height 为当前高度(vh),percentage 为相对窗口高度的百分比。

API ​

Props ​

属性说明类型默认值
initial-height初始高度及中间吸附点,单位 vhnumber35
max-height最大高度,单位 vhnumber70
min-height最小高度,单位 vhnumber35
handle-height拖拽手柄高度,单位 pxnumber20
damping拖拽阻尼系数number1
inertia速度吸附灵敏度,0 表示关闭number1
bg-color面板背景色,为空时跟随主题string""
radius面板顶部圆角,单位 pxstring | number15
show-on-tab-bar是否为 TabBar 预留底部空间booleanfalse
show-indicator是否显示拖拽指示器booleantrue
disabled是否禁用拖拽booleanfalse
z-index层级number100
u-style / u-class自定义样式和类名string""

Events ​

事件说明参数
position-change高度变化height: number, percentage: number
drag-start / drag-end拖拽开始和结束-

Slots ​

名称说明
main页面主内容区域
float可拖拽浮动面板内的滚动内容

参考 ​

uvx-ui · uni-app x 组件库