Sheet
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/sheet.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/kit"
"github.com/dyike/keel/ui/theme"
)
func init() {
registerSection("sheet", "overlays", func() core.Widget { return el.Root(newSheetGallery()) })
}
type sheetGallery struct{ right, bottom *kit.SheetView }
func newSheetGallery() *sheetGallery {
body := func() el.View {
menu := kit.Menu().Item(demoText("Copy order number", "复制订单号"), "", nil).Item(demoText("View action log", "查看操作记录"), "", nil)
menu.Trigger(kit.Button(demoText("Order actions", "订单操作"), menu.Toggle))
return el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().Gap(8).Child(el.Text(demoText("Order SO-1001", "订单 SO-1001")).Bold(), el.Text(demoText("East China Logistics · Awaiting payment · ¥300.00", "华东物流 · 待付款 · ¥300.00")).TextColor(theme.Muted),
kit.DescriptionList().Item(demoText("Owner", "负责人"), demoText("Alex Chen", "张三")).Item(demoText("Created at", "创建时间"), "2026-10-01 09:30").Render(cx), menu.Render(cx))
})
}
g := &sheetGallery{right: kit.Sheet(el.Right, demoText("Order details", "订单详情")).MarginTop(32).Body(body()), bottom: kit.Sheet(el.Bottom, demoText("Bulk actions", "批量操作")).Size(220).Body(body())}
g.right.PanelStyle(func(e *el.DivEl) { e.P(24).Gap(theme.SpaceLg).Border(1, theme.Border) })
g.right.Footer(kit.Button(demoText("Done", "完成"), func() { g.right.SetValue(false) }))
g.bottom.Footer(kit.Button(demoText("Close panel", "关闭面板"), func() { g.bottom.SetValue(false) }))
return g
}
func (g *sheetGallery) Render(cx *el.Context) el.Element {
return el.Div().P(24).Gap(12).Items(el.Start).Child(
el.Text(demoText("Sheet: drag the inner edge to resize. Esc or clicking the backdrop closes it.", "Sheet:拖动内侧边缘调整尺寸,Esc 或点遮罩关闭")).Bold(),
el.Div().Row().Wrap().Gap(8).Child(
kit.Button(demoText("Details on the right", "右侧详情"), func() { g.right.SetValue(true) }).Size(galleryTouchSize(cx)).Render(cx),
kit.Button(demoText("Bottom panel", "底部面板"), func() { g.bottom.SetValue(true) }).Size(galleryTouchSize(cx)).Variant(kit.ButtonSecondary).Render(cx),
),
g.right.Render(cx), g.bottom.Render(cx),
)
}
贴着窗口某条边的模态面板,用于详情、设置、较长的表单。
details := kit.Sheet(el.Right, "订单详情").Body(view).Size(400)
details.SetValue(true)
- 方向:
el.Right、el.Left、el.Top、el.Bottom。 - 尺寸:
Size(dp)对左右方向是宽度,对上下方向是高度,默认 360;不会超过窗口。 - 打开时用
kit.SheetSlide(200ms)从边缘滑入。开启减少动画时直接出现在最终位置,自动化模式下默认就是这样。 - 关闭方式和 Dialog 相同:Esc、点击遮罩、标题栏的关闭按钮,关闭时调用
OnClose(fn)。 - 内容区可以滚动。焦点限制在面板内,关闭后焦点回到原来的位置。
Value()/SetValue(bool)读取或设置是否打开,SetTitle修改标题。也可以在回调里调用sheet.Show(cx),抽屉直接挂到窗口根部,不必放进视图树,关闭后自动取下;同一个实例不要同时 Render。需要el.Root。
Agent:角色是 dialog,名字是标题;关闭按钮的名字是"关闭"。
验证:go run ./examples/components -section sheet。
Sheet 的正文可以包含 Menu、Popover 等浮层;父层先登记,Esc 从最内层关闭,最后才关闭 Sheet。SetDisabled(true) 关闭并阻止重新打开,祖先禁用或隐藏也会关闭模态层,恢复启用不会自动重开。用户关闭回调至多执行一次。
滑入距离使用受窗口约束后的实际宽高。尺寸为 NaN 或无穷时忽略;关闭后立即重新打开会重新开始动画,不要求中间先渲染一次关闭状态。示例“订单操作”可验证嵌套菜单。
Footer(views...) 设置独立页脚,复制传入切片,支持多个操作按钮与换行;正文继续独立滚动,页脚不随正文滚动。无正文时页脚靠面板底部,空参数清除页脚,nil 子项忽略。页脚适合少量操作,需为标题和页脚留出足够面板高度。
Keyboard(bool)、Overlay(bool)、OverlayClosable(bool)、CloseButton(bool) 分别控制 Esc、遮罩颜色、外部点击关闭和标题关闭按钮,默认均开启。隐藏遮罩仍保持模态阻挡和焦点约束;关闭按钮不受 Keyboard/OverlayClosable 限制。配置可在打开期间更新,程序 SetValue(false) 始终可用。
MarginTop(dp) 给面板顶部预留空间,例如 MarginTop(32) 避开标题栏。四个方向均在剩余窗口区域内布局;顶部面板从预留区下沿滑入,底部面板仍贴底,左右面板缩短高度。绘制和点击区域同步裁剪,动画不会覆盖预留区。默认 0,负数和非有限值忽略;超出窗口高度时面板完全裁剪,仍可按 Esc 关闭。遮罩和模态阻挡继续覆盖整个窗口,点击顶部预留区按 OverlayClosable 处理。
PanelStyle(func(*el.DivEl)) 在默认外观之后配置面板配色、文字颜色、边框、圆角、阴影、内边距和内容间距;PanelStyle(nil) 恢复默认。回调每帧接收新元素,不应保存引用。面板身份和 Size/窗口约束在回调后设置,正文与操作继续通过 Body/Footer 提供。显式设置颜色的子组件保持自身颜色,未设置的文字继承面板颜色。
details.PanelStyle(func(panel *el.DivEl) {
panel.Bg(theme.Surface).Border(1, theme.Border).P(24).Gap(theme.SpaceLg)
})
Resizable(bool) 控制内侧边缘的 6dp 调整把手,默认开启。左右面板拖动宽度,上下面板拖动高度;把手支持 Tab 聚焦,方向键沿对应轴移动 16dp,Home/End 调到最小/最大尺寸。用户调整范围为 80dp 到可用窗口尺寸;窗口不足 80dp 时以实际空间为限,垂直方向扣除 MarginTop。
PanelSize() 返回请求尺寸;OnResize(func(float32)) 通知用户调整结果,程序调用 Size 不触发。调整从屏幕上的实际尺寸开始;取消指针拖动恢复起始尺寸(仍受当前窗口约束)。关闭、禁用调整或程序设置尺寸会结束当前拖动。应用可在回调中保存尺寸;重新打开仍保留尺寸。默认新增把手会增加一个键盘停靠点,可用 Resizable(false) 恢复固定尺寸行为。
进退场共用根视图管理的 presence 生命周期。逻辑关闭时立即禁用退场内容并解除模态、释放焦点,画面继续完成短暂退场;中途重开从当前姿态反向,减少动态效果时跳过过渡。Show 挂载持续到退场完成,移除组件会取消生命周期。这些行为位于工作分支,尚未包含在 v0.4.2 中。