DXUI

Text：文本与 Label ​

用 Text 构建文本与 Label。本页包含可运行示例、完整属性及行为限制。

完整示例 ​

先完成环境准备。下面是完整 main.go，执行 go run .。

go
package main

import (
	"github.com/dxui-org/dxui"
	"log"
)

func main() {

	app := dxui.NewApp(dxui.AppOptions{
		Title:      "Text",
		Width:      640,
		Height:     480,
		Background: dxui.RGBA(248, 250, 252, 255),
	})
	if err := app.Run(func() dxui.View {
		return dxui.Box(
			dxui.BoxProps{
				Gap: 16,
				Style: dxui.Style{
					Padding: dxui.Padding(24),
				},
			},
			dxui.Text(dxui.TextProps{
				Value:    "Hello dxui",
				Wrap:     dxui.TextWrapWords,
				MaxLines: 2,
				Style: dxui.Style{
					Width: dxui.Px(240),
					Text: dxui.TextStyle{
						Size: 20,
					},
				},
			}),
		)
	}); err != nil {

		log.Fatal(err)
	}
}

参数与 API ​

go
func Text(props TextProps) View
go
func Label(value string) View
字段类型用途、默认与约束
Keystring同父级稳定唯一身份；默认空。动态列表使用业务 ID，勿用可变索引。
StyleStyle局部布局、绘制和文本样式；零值使用固有尺寸与主题默认。
TokenComponentToken组件主题条目；空值选择该组件默认。
StatesStateStyles真实交互状态的绘制补丁，不能伪造状态或改变布局。
PointerPointerBehavior默认 PointerAuto；PointerNone 排除整个子树的指针参与，不等同 Disabled。
Valuestring应用拥有的当前值；行为、范围和零值见本页说明。
WrapTextWrap默认 TextNoWrap；TextWrapWords 简单按词换行。
MaxLinesint正数限制可见行数；0 不限制，负数使构建失败。

行为与边界 ​

Label(value) 等价于默认 Text；TextNoWrap 为零值。TextWrapWords 使用简单分词换行，合并空白，并非完整 Unicode 换行。MaxLines 为正时限制行数。无效 UTF-8 替换为 U+FFFD。文本本身不是可选择的编辑器；中文依赖字体覆盖。

所有组件共享身份、样式与指针规则。字段引用的枚举、结构体及源码注释见完整声明参考。示例运行方式包含构建验证方法。