40 lines
1.0 KiB
Markdown
40 lines
1.0 KiB
Markdown
# 237 CitationBadge 引用编号
|
||
|
||
## 用途
|
||
|
||
行内引用编号；悬停预览来源；点击定位来源。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
var cites mujica.CitationState
|
||
src := mujica.Source{Title: "The Palace of Versailles", URL: "https://example.com/versailles"}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
if mujica.CitationBadge(c, 1, src, &cites).Changed() {
|
||
fmt.Println("show source", cites.Active)
|
||
}
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`n` 为从 1 开始的引用编号；`src.Title`、`src.URL` 必填；`st` 为与来源卡片共享的 CitationState；`Active=0` 表示尚未选中。
|
||
|
||
## 状态
|
||
|
||
默认、悬停、键盘焦点与祖先禁用；业务状态由调用方提供。
|
||
|
||
## 事件
|
||
|
||
每次点击或键盘激活触发 ChoiceResult.Changed() 并定位来源；重复激活同一引用也会重新定位。
|
||
|
||
## 键盘操作
|
||
|
||
Tab 到引用；Enter、Space 定位；悬停或键盘焦点 500 毫秒后预览；Escape 关闭预览。
|
||
|
||
## 限制
|
||
|
||
编号按调用方引用顺序映射；预览内容来自调用方。
|