Sheet
一个适用于 ReactLynx 的方向性 Sheet 组件,支持底部面板、侧边抽屉、拖拽交互和吸附点基础能力。- 支持受控与非受控两种显示方式。
- 支持吸附点配置,包括百分比高度与内容自适应高度。
- 支持通过
SheetRootRef进行命令式控制。
你可以查看源码来了解它的运行原理,也欢迎大家提 MR 来丰富其能力。
Sheet 是用于上下文操作、详情面板和临时流程的滑动面板。它支持底部面板、顶部面板、侧边抽屉、吸附点、拖拽、点击遮罩关闭,以及受控和命令式两种使用方式。
基本用法
从 SheetRoot、SheetView、SheetBackdrop 和 SheetContent 开始。将视觉面板放在 SheetContent 上,再用遮罩和拖拽手势完成自然关闭。
示例
自动高度
当面板高度应跟随内容变化时,使用 fit 吸附点。它适合菜单、短表单,以及高度无法提前确定的内容。
受控状态
当打开状态属于页面时,使用 show 和 onShowChange。如果其他 UI、埋点或导航逻辑需要与面板状态同步,这就是合适的模型。
不同方向
使用 side 选择 Sheet 是底部面板、顶部面板还是抽屉。需要跟随 RTL 布局时优先使用 start 和 end,必须固定物理边缘时使用 left 或 right。
命令式控制
当父级需要直接控制面板时,使用 SheetRootRef。open、close、snapTo、expand 和 collapse 适合工具栏操作或多步骤流程联动。
结构
组件 API
SheetRoot
The root component of the Sheet, containing all of its child components.
[最小角度, 最大角度]。
落在这些范围内的手势会驱动 Sheet 移动,范围外的手势则继续透传给子组件。rtl,并以 RTL 模式解析逻辑抽屉方向。为 false 时,start 为左侧、end 为右侧;为 true 时,start 为右侧、end 为左侧。物理 left 和 right 不受 enableRTL 影响。value 表示换算后的像素值。top / bottom)启用橡皮筋效果,水平抽屉(left / right / start / end)禁用。
如果为 true,启用默认橡皮筋效果(系数 0.5)。
如果为 false,禁用橡皮筋效果。
如果为数字,启用指定系数的橡皮筋效果。
如果为对象,允许指定系数和最大距离。top / bottom)下,用于计算百分比吸附点和关闭阈值。left / right / start / end)中用于百分比吸附点和关闭计算。bottom 保持现有底部弹层行为,top 提供顶部弹层行为,left 和 right 提供物理抽屉方向,start 和 end 提供逻辑抽屉方向并根据 enableRTL 解析。top / bottom 模式下相对于屏幕高度,在 left / right / start / end 模式下相对于屏幕宽度
- 'fit' 在 top / bottom 模式下动态解析为测量的内容高度,在 left / right / start / end 模式下动态解析为测量的内容宽度
索引顺序与该数组顺序一致。SheetBackdrop
The backdrop mask of the Sheet.
SheetView
The view container of the Sheet. Can be x-overlay-ng or view.
Controls the Sheet's overlay layer and stacking order.
'spark'、'bullet' 和 'bulletPopup' 都是原生容器名称。
例如在 TikTok 中通常应设置为 'spark',在抖音中通常应设置为 'bullet'。
在 iOS 上,这个属性也可以是任意一个用于承载 Sheet 的原生视图控制器。
通过它可以将 Sheet 放到正确的原生层级中。container 为非空字符串时生效。
用于调整周边元素的显示层级。SheetContent
The main content of the Sheet.
'fit' 才能根据测量得到的抽屉宽度完成解析。style 属性设置,该属性会应用到移动的 surface 层。
在水平抽屉模式下,应在这里设置抽屉宽度,这样 'fit' 才能根据测量得到的抽屉宽度完成解析。SheetHandle
The handle of the Sheet.