Keel v0.5.1 English GitHub

ColorPicker

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

这是上方组件库展示案例的完整源码。examples/components/color_picker.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"image/color"

	"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("color_picker", "inputs", func() core.Widget {
		swatches := []color.NRGBA{}
		for _, c := range theme.Chart {
			swatches = append(swatches, c)
		}
		picker := kit.ColorPicker().Alpha().Swatches(swatches...)
		narrow := kit.ColorPicker().Alpha().Swatches(swatches...)
		narrow.SetValue(swatches[0])
		pop := kit.ColorPicker().Popup(true).Label(demoText("Theme color", "主题色")).Size(kit.ColorPickerSizeSmall)
		iconPop := kit.ColorPicker().Popup(true).Label(demoText("Icon trigger", "图标触发器")).Icon(kit.IconCheck).Size(kit.ColorPickerSizeLarge)
		rgbPop := kit.ColorPicker().Popup(true).Label(demoText("RGB format; opens to the right", "RGB 格式,向右弹出")).Format(kit.ColorRGB).Placement(el.Right, el.Start)
		hslPop := kit.ColorPicker().Popup(true).Alpha().Label(demoText("HSL with alpha", "HSL 带透明度")).Format(kit.ColorHSL)
		disabled := false
		return el.Root(el.ViewFunc(func(cx *el.Context) el.Element {
			// Taller than a small window: scroll rather than squeeze every row.
			return el.Div().P(24).Gap(24).Items(el.Start).Grow().ScrollY().Child(
				picker.Render(cx), kit.Button(demoText("Enable / disable color picker", "启用 / 禁用取色器"), func() { disabled = !disabled; picker.SetDisabled(disabled) }).Variant(kit.ButtonSecondary).Render(cx),
				el.Text(demoText("Built-in popups: ", "内置弹层:")).TextColor(theme.Muted), pop.Render(cx), iconPop.Render(cx),
				el.Text(demoText("Color format and popup placement (HEX / RGB / HSL can also be switched inside the panel): ", "颜色格式与弹出位置(面板里也可以切换 HEX / RGB / HSL):")).TextColor(theme.Muted), rgbPop.Render(cx), hslPop.Render(cx),
				el.Text(demoText("Narrow container (160dp): ", "窄容器(160dp):")).TextColor(theme.Muted), el.Div().W(el.Dp(160)).Child(narrow.Render(cx)))
		}))
	})
}

颜色选择器。

picker := kit.ColorPicker().Alpha().Swatches(presets...).OnChange(func(c color.NRGBA) { … })
picker.SetValue(theme.Primary)
  • 方块里拖动选择饱和度和亮度,色相条选择色相,Alpha() 后多一条不透明度条。方块和各个条都可以获得焦点,用方向键微调。
  • 十六进制输入框接受 #RGB、#RRGGBB、#RRGGBBAA,回车或失去焦点时生效,输入不合法时恢复原值。
  • Swatches(...) 在下方显示预设色块,根据可用宽度自动换行,并复制预设切片。
  • 颜色内部按 HSV 保存:把颜色拖成灰色或黑色后,色相不会丢失,再拖回来时还是原来的色相。
  • Popup(true) 使用内置触发按钮与锚定弹层;默认内联,也仍可自行组合 kit.Popover。

Agent:容器角色 group,名字是当前颜色的十六进制值;方块和各个条的角色是 slider(名字为"饱和度与亮度""色相""不透明度");输入框名为 HEX;预设色块是以十六进制值命名的按钮。

验证:go run ./examples/components -section color_picker,加 -theme dark 检查深色。

SetDisabled(true) 禁用色板、滑块、预设色和 HEX 输入,并取消尚未提交的 HEX 草稿。父容器禁用引起的失焦不会提交草稿。SetValue 在禁用期间仍可更新颜色且不调用 OnChange。

预设色和格式按钮无边框;勾选图标或着色底色表示当前选项,键盘或程序聚焦时显示内嵌焦点环。

默认宽度 240dp,放入窄容器时缩到可用宽度。滑块指示环根据实际布局定位,黑白双描边确保在亮色和暗色区域都可辨认。色相和透明度条的命中高度为 24dp,焦点有独立边框。

方向键微调,Shift + 方向键加速十倍;色相/透明度条支持 Home/End 到端点、PageUp/PageDown 十步调整。色块的选中状态同时用勾形图标和 Agent selected 表达,图标按合成后的背景选择黑或白。重复点击当前色块不重复触发回调。拖动取消保留最后一次有效颜色,不用取消事件的坐标覆盖它。

Label(text) 在选择器或触发器上方显示标签,并作为内置按钮的可访问名称。无标签时按钮使用当前 HEX。Icon(name) 替换触发器中的颜色块,IconNone 恢复颜色块;按钮始终显示当前 HEX。颜色修改继续使用原 OnChange。

Size(ColorPickerSizeXSmall/Small/Medium/Large) 同步调整弹层/内联面板宽度、色板高度、HEX 字段和触发按钮尺寸;面板宽度依次为 192/216/240/280dp,按钮高度为 24/28/32/40dp。默认 Medium 保留原内联布局,非法档位忽略。

SetOpen(bool) 程序设置弹层,IsOpen() 查询;仅 Popup 模式有效,不触发颜色回调。用户打开时焦点移到色板;Esc 或点击外部关闭,焦点回到触发按钮。关闭或禁用取消未提交的 HEX 草稿,已提交的颜色保留。切回内联也关闭弹层。键盘、禁用、草稿取消、尺寸切换和值保留通过 1×/2× 自动测试;真机弹层手感仍待验收。

颜色格式

Format(kit.ColorRGB) 选择显示和输入的格式:ColorHex(默认,#2563EB)、ColorRGB(R、G、B 三个 0–255 的输入框)、ColorHSL(H 0–360,S、L 百分比)。开启 Alpha() 时 RGB、HSL 多一个不透明度百分比输入框。面板里的 HEX / RGB / HSL 切换按钮让用户随时换格式,CurrentFormat() 读回当前格式。

  • 输入框按回车或失去焦点时生效;不是合法数值时恢复原值,超出范围的数会截到边界。
  • 弹层触发器上的文字跟随格式,如 rgb(37, 99, 235)、hsla(221, 83%, 53%, 0.8);Text() 返回同样的字符串。
  • kit.FormatColor(c, format, alpha) 可以单独用来格式化颜色。
  • 在 HSL 里输入的色相会保留,即使饱和度为 0 时颜色本身已经是灰色。

弹层位置

Placement(el.Top, el.End) 指定弹层在触发器的哪一侧打开、怎样对齐,和 Popover 相同。只对 Popup(true) 的取色器有效。