MujicaUI/docs/components/248-prompt-library.md

248 PromptLibrary · 提示模板库

用途

按分类与搜索浏览提示模板，预览模板，填写 {{变量}} 后插入。

最小示例

var state mujica.PromptLibraryState
templates := []mujica.PromptTemplate{{ID: "1", Category: "Letters", Title: "Invitation", Body: "Invite {{guest}}."}}
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	if v := mujica.PromptLibrary(c, &state, templates, mujica.PromptLibraryOptions{}); v.Inserted != "" {
		log.Println("insert", v.Inserted)
	}
}
ui.Render(view, 400, 300, 1)

参数

func PromptLibrary(c *ui.Context, s *PromptLibraryState, templates []PromptTemplate, opts PromptLibraryOptions) PromptLibraryView。另有 PromptLibraryVariables(body) 与 PromptLibraryFill(body, values)。

PromptTemplate：ID、Category、Title（ID 与 Title 必填）、Body（{{name}} 为变量，名称可含字母、数字、_.-）。

PromptLibraryState：Category（空为全部）、Query、Selected、Values（变量值）。

字段	类型	默认值	含义
Label	string	""	无障碍名称。
Disabled	bool	false	禁用全部操作。

状态

分类与模板行（选中：Selection 底 + 菱形）、无匹配、未选模板、预览（未填变量以 [名称] 标出，已填值酒红加粗）、插入按钮（变量未填全时禁用）、禁用。

事件

Inserted：变量已填好的模板正文，非空时由调用方插入输入框。

键盘操作

• Tab 依次进入分类列、搜索框、模板列、变量输入框、插入按钮；列内 ↑/↓ 移动；Enter/Space 选择。

限制

• 过滤只在模板切片、查询或分类变化时重算。
• 变量为简单占位替换，不支持条件或循环。