NSGo

核心概念

文本

用 span、字体、装饰、选择和文档展示文本。

一段文本

core.Text 是一个段落，由平台自己的文本引擎在引擎侧排版，再由主线程绘制。它的尺寸来自字体和宽度，并在盒子内换行。

core.Text{Content: "Hello from NSGo", Style: core.Style{
	FontSize:   15,
	LineHeight: 22,
	FontWeight: core.FontWeightSemibold,
}}

Content 是固定内容，ContentFunc 跟随 signal，因此会变化的文本在函数里读取它。MaxLines 限制显示的行数，EllipsizeMode 在开头、中间或结尾截断，WhiteSpaceNoWrap 让段落保持一行。AdjustsFontSizeToFit 会缩小文本，直到它放进盒子和行数限制。

文本字段像 CSS 一样继承：位于设置了 FontSize、Color 或 LineHeight 的视图中的文本会采用这些值，除非自己设置。TextAlign、TextTransform、LetterSpacing、TextDecoration、TextDecorationStyle、TextDecorationColor，以及 TextShadowColor、TextShadowOffset 和 TextShadowRadius 设置行与字形的样式。

Span 与链接

Spans 把文本拆成若干段，每段有自己的样式。带 OnPress 的 span 是链接；按在其他 span 上会触发文本自己的 OnPress。

core.Text{Style: core.Style{FontSize: 15}, Spans: []core.Span{
	{Content: "继续即表示你同意"},
	{Content: "服务条款", Style: core.Style{TextDecoration: core.TextDecorationUnderline}, OnPress: openTerms},
	{Content: "和"},
	{Content: "隐私政策", Style: core.Style{TextDecoration: core.TextDecorationUnderline}, OnPress: openPrivacy},
	{Content: "。"},
}}

SpansFunc 在读取的值变化时重新给出 span，只有不同的部分会重新排版，因此代码编辑器的行会在高亮到达时重新着色。span 的 Background 和 CornerRadius 会在每一行字符后面画一个盒子。Visibility: core.VisibilityHidden 原地隐藏一个 span：它的文字仍占着位置，显示时各行不会移动，复制和屏幕阅读器都会略过它，适合逐词淡入的文字。

Attachment 把一个视图放进文本，替代 span 的内容。它按自身尺寸布局，随周围的文字换行，并接收自己的按压，因此图标、图片或小按钮可以出现在一行里。

core.Text{Style: core.Style{FontSize: 17, LineHeight: 24}, Spans: []core.Span{
	{Content: "用 "},
	{Attachment: core.Icon{SVG: lucide.Search, Style: core.Style{FontSize: 17}}},
	{Content: " 搜索 NSGo"},
}}

字体

FontFamily 指定一个字体系列或 CSS 列表（Inter, "Noto Sans SC", sans-serif），前面的字体缺少的字符由后面的字体补上。FontWeight、FontStyle、FontVariant、LineHeight、LineHeightMultiple、LetterSpacing 和 LetterSpacingEm 设置字形和间距，core.FontMonospace 是平台等宽字体。

把应用的字体放在 resources/ 下并在第一个视图前注册，或在运行时注册字体字节：

func main() { nsgo.Run(Root, nsgo.Fonts("fonts/Inter-Regular.ttf", "fonts/Inter-Bold.ttf")) }

cx.RegisterFont(data) // 一个 TrueType 或 OpenType 字体

字体到达前排版的文本会重新排版。cx.Env().FontScale() 是用户的文本大小，文本默认跟随它，NoFontScaling 可以关闭，MaxFontSizeMultiplier 限制最大倍数。

选择与测量

SelectableOn 让用户选择和复制文本，带 Selectable 的 View 让其中的文本按文档顺序一起选择，像网页一样。SelectionColor 设置高亮颜色。cx.MeasureText 测量一个字符串在某个字体下的尺寸，适合按文本宽度排列的列；OnTextLayout 在每次布局后报告行。

文档

base/textview 用相同的原语显示 Markdown 或 HTML：标题、段落、列表、表格、代码、脚注、提示块、图片、公式和链接。

textview.TextView{
	Markdown: "## NSGo\n\n用 **Go** 写的原生视图。",
	Styles:   ui.TextViewStyles(cx),
	OnLinkPress: func(e textview.LinkPressEvent) {
		if strings.HasPrefix(e.URL, "#") {
			return
		}
		cx.OpenURL(e.URL, nil)
	},
}

公式（$…$、$$…$$）默认显示 TeX 源码；应用传入 base/formula 的 RenderMath: formula.RenderMath 后才会排版，字号和颜色与周围文本一致，读屏时使用应用的语言，复制时得到 TeX。它会让桌面应用增大约 6.5 MB，网页应用增大约 3 MB（gzip 压缩后），其中包括字体。在其他地方显示公式用 formula.View，支持 TeX 和 Typst。

mermaid 代码块默认显示源码；应用传入 base/diagram 的 RenderDiagram: diagram.RenderDiagram 后，会用 limu 把它画成原生图表，支持流程图、时序图、类图、状态图、实体关系图、甘特图、饼图、思维导图、时间线等，使用平台字体，并随应用的浅色或深色外观切换。图比文本宽时可以横向滚动，复制时得到源码；仍在流式输出中的代码块会先显示为代码，写完后再画成图。在其他地方显示图表用 diagram.View。

textview.Parse 读取 Markdown，textview.ParseHTML 读取 HTML，得到应用也可以自己构建的块。Options.Streaming 修复仍在到达的文档：补全末尾未闭合的语法，并暂缓显示含义还要由后续字符决定的最后一行，例如单独的列表标记，让回复不会把标记闪成文本；StreamingCaret 在末尾绘制光标，适合逐字生成的回复。

textview.Search 在加入它的各个视图里查找文本，视图通过 Search 字段或上层的 textview.ProvideSearch 加入。查找栏用 SetQuery、Open 和 Close 驱动它，Count 和 Selected 给出位置，Next 和 Previous 按阅读顺序逐个切换匹配。视图给每个匹配加上 PartSearch，给选中的匹配再加 PartSearchSelected，颜色由应用的样式决定；视图还会把选中的匹配滚动到视野内，并且不改动用户的选择。

search := textview.NewSearch(cx)
textview.ProvideSearch(cx, search)
search.SetQuery("readme")
search.Open()

下一步

在 GitHub 上编辑此页