Terminal & Code: components 321-340

docs/components/328-minimap.md

@@ -0,0 +1,45 @@
+# 328 Minimap · 代码缩略图
+
+## 用途
+
+以细条绘制代码缩略图，框出编辑器可见区域；点击或拖动跳转，键盘可移动。
+
+## 最小示例
+
+```go
+lines := []string{"package court", "", "func Seal() {}", "func Herald() {}"}
+view := mujica.MinimapView{Top: 0, Visible: 2}
+draw := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if mujica.Minimap(c, lines, &view, mujica.MinimapOptions{Language: "go"}).Changed() {
+		fmt.Println("scroll editor to", view.Top)
+	}
+}
+ui.Render(draw, 400, 300, 1)
+```
+
+## 参数
+
+`func Minimap(c *ui.Context, lines []string, view *MinimapView, opts MinimapOptions) ChoiceResult`。`MinimapView{Top, Visible}` 是编辑器当前首行与可见行数，由调用方与编辑器同步（可用 `CodeViewerState.Visible` 与 `ScrollTo`）。每行 2 DIP、每字符 1 DIP；文件比缩略图高时缩略图随视图滚动，只绘制可见的行。
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `Language` | `string` | "" | 着色语言，同 CodeViewer。 |
+| `Width` | `float32` | 96 | 宽度（DIP）；负数 panic。 |
+| `Disabled` | `bool` | false | 不能跳转。 |
+
+## 状态
+
+可见区为 Selection 半透明填充加 AccentText 边框；聚焦时外侧焦点环；禁用。
+
+## 事件
+
+`Changed()`：用户移动了视图，读取 `view.Top`。
+
+## 键盘操作
+
+- Tab 聚焦；↑/↓ 移动一行，PageUp/PageDown 移动一屏，Home/End 到开头与结尾。
+
+## 限制
+
+- 缩略图按行独立着色，不跟踪跨行的块注释。