50 lines
1.8 KiB
Markdown
50 lines
1.8 KiB
Markdown
# 248 PromptLibrary · 提示模板库
|
||
|
||
## 用途
|
||
|
||
按分类与搜索浏览提示模板，预览模板，填写 `{{变量}}` 后插入。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
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 选择。
|
||
|
||
## 限制
|
||
|
||
- 过滤只在模板切片、查询或分类变化时重算。
|
||
- 变量为简单占位替换，不支持条件或循环。
|