Keel v0.5.1 English GitHub

ResizableGroup

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/resizable_group.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("resizable_group", "shell", func() core.Widget {
		pane := func(label string) el.View {
			return el.ViewFunc(func(*el.Context) el.Element {
				return el.Div().Grow().ScrollY().Bg(theme.Surface).P(12).Child(el.Text(label))
			})
		}
		g := kit.ResizableGroup(kit.ResizablePanel{ID: "files", Content: pane(demoText("Files", "文件")), Size: 120, Min: 60, Max: 180}, kit.ResizablePanel{ID: "editor", Content: kit.Input(demoText("Edit content", "编辑内容")), Min: 100}, kit.ResizablePanel{ID: "preview", Content: pane(demoText("Preview", "预览")), Size: 120, Min: 60})
		visible := true
		compact := false
		sizes := [2]map[string]float32{g.Sizes(), {"files": 100, "editor": 160, "preview": 120}}
		return el.Root(el.ViewFunc(func(cx *el.Context) el.Element {
			width, _ := cx.ViewportSize()
			narrow := width < 640*max(float32(1), cx.TextScale())
			if narrow != compact {
				old, next := 0, 1
				if compact {
					old, next = 1, 0
				}
				sizes[old] = g.Sizes()
				g.SetVertical(narrow).SetSizes(sizes[next])
				compact = narrow
			}
			height := float32(320)
			if compact {
				height = 480 * max(float32(1), cx.TextScale())
			}
			label := demoText("Hide preview", "隐藏预览")
			if !visible {
				label = demoText("Show preview", "显示预览")
			}
			return el.Div().ScrollY().P(24).Gap(12).Items(el.Stretch).Child(kit.Button(label, func() { visible = !visible; g.SetVisible("preview", visible) }).Size(44).Render(cx), el.Div().H(el.Dp(height)).Items(el.Stretch).Child(g.Render(cx)))
		}))
	})
}

独立多面板分割容器,支持横纵排列和嵌套。与双面板 Resizable 并存。

g := kit.ResizableGroup(
    kit.ResizablePanel{ID: "files", Content: files, Size: 180, Min: 100, Max: 300},
    kit.ResizablePanel{ID: "editor", Content: editor, Min: 160},
    kit.ResizablePanel{ID: "preview", Content: preview, Size: 240, Min: 100},
)

默认横排;Vertical 改为纵排。ID 必须非空且唯一,空 ID 和重复 ID 后续项忽略。Size 为初始 dp,0 初始均分指定尺寸面板之外的剩余空间;Min 默认 0,Max 为 0 表示无上限,上限小于 Min 时以 Min 为准。放入有确定大小的父容器。

拖动只改变相邻可见两面板,其他面板不变。方向键每次 16dp,Home/End 到相邻范围边界;取消保留最后有效尺寸。SetDisabled 同时禁用把手和内容,HandleAppearance 使用与 Resizable 相同的把手配置。

窗口变化从最后一个可见面板向前分配余量,保留前面板尺寸;全部达到上限时尾部留空。空间不足以容纳最小尺寸时按各 Min 比例压缩,仍保留每条 6dp 把手。首次测量后请求下一帧收敛。

Sizes 返回按 ID 索引的尺寸副本。SetSizes 设置已知 ID 的有限非负尺寸,不触发回调,下一帧按容器范围收敛;显式 0 不再作为自动均分。OnChange 仅在用户实际调整后返回完整尺寸副本。

SetVisible(id, visible) 控制单面板显隐,隐藏内容继续声明并保留状态及尺寸;剩余面板重新分配空间,单侧仍遵守自身 Max。SetPanels 替换/重排配置,保留相同 ID 的尺寸,新 ID 使用 Size;更改已有 ID 的大小请用 SetSizes。被移除的面板及把手状态清理。显隐、配置和窗口变化不触发 OnChange。

SetVertical(bool) 支持运行时切换横纵方向,不会重建面板内容或触发 OnChange。尺寸及限制应用于新方向;如需分别记住横纵布局,请由应用保存两组尺寸。Gallery 在窄屏上下排列面板,并恢复各方向已保存的尺寸。