Keel v0.5.1 English GitHub

DescriptionList

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

这是上方组件库展示案例的完整源码。examples/components/description_list.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("description_list", "display", func() core.Widget {
		order := kit.DescriptionList().Columns(2).Vertical().Bordered(true).
			Item(demoText("Order number", "订单号"), "SO-123").Item(demoText("Customer", "客户"), demoText("Alex / Ada Lovelace", "张三 / Ada Lovelace")).
			Separator().Item(demoText("Notes", "备注"), demoText("Mixed description; long values wrap. This description spans two columns.", "中英文 mixed description;长值可以换行,这条说明跨两列展示。")).Span(2).
			Item(demoText("Status", "状态"), demoText("Awaiting shipment", "待发货")).Item(demoText("Channel", "渠道"), demoText("Online store", "线上商店"))
		basic := kit.DescriptionList().Size(theme.TextSm).Item(demoText("Project", "项目"), "Keel").Item(demoText("Version", "版本"), "0.1.0")
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(theme.SpaceXl).Gap(theme.SpaceLg).Child(el.Text(demoText("Order information · Two-column layout", "订单信息 · 两列布局")), order.Render(cx), el.Text(demoText("Compact list", "紧凑列表")), basic.Render(cx))
		}))
	})
}

kit.DescriptionList().Item("订单号", "SO-1001").ItemView("状态", view).LabelWidth(96) 按行显示标签和值,默认标签列 96dp,值列占剩余宽度并换行,顶部对齐。窄容器允许标签列收缩。

纯文本条目向 Agent 暴露一个 text,名字为“标签:值”。ItemView 接受 el.View,每帧调用其 Render,保留子视图的语义和交互,标签单独可读。SetItems 替换全部文本条目,参数为 Description 列表。

组件本身无键盘操作。验证:go run ./examples/components -section description_list -theme dark,省略 theme 查看浅色。

Columns(n) 设置每行条目列数,最少一列。Span(n) 设置最近追加条目的跨度,布局时限制在 1 到当前列数;剩余列放不下时换行,不回填前面行的空位。Separator() 插入满行分隔线,后续条目从新行开始。SetItems 会清除之前的富内容、跨度和分隔线。

kit.DescriptionList().Columns(2).Vertical().Bordered(true).
    Item("订单号", "SO-123").Item("客户", "张三").
    Separator().Item("备注", "说明跨两列展示").Span(2)

Vertical() 把每个条目的标签放在值上方;列数和跨度仍然有效。默认横排,LabelWidth 仅在横排时生效。

Bordered(true) 为各条目增加内边距和主题边框,默认无边框。Size(sp) 调整文字大小和间距档,推荐 theme.TextSm、theme.TextBody、theme.TextLg;默认继承文字大小。尺寸忽略非正数和非有限值,标签宽度允许 0,但忽略负数和非有限值。

列数由调用方设置,不会根据窗口宽度自动切换;窄容器内文字换行。小屏可用 Columns(1),富内容自己的固定最小宽度仍须适合容器。多列和跨列保留文本语义,富内容按钮保留键盘、点击和禁用继承。