# 344 Lightbox 灯箱

## 用途

全窗口浏览图片：左右切换、显示说明文字，Escape 关闭后焦点回到触发控件。

## 最小示例

```go
images := []mujica.ViewerImage{{Source: ui.NewBitmap(examplePhoto), Alt: "The grand hall"}}
open, index := false, 0
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	if mujica.Button(c, "View photos", mujica.ButtonOptions{}).Clicked() {
		open = true
	}
	mujica.Lightbox(c, &open, &index, images)
}
ui.Render(view, 400, 300, 1)
```

## 参数

`func Lightbox(c *ui.Context, open *bool, index *int, images []ViewerImage) ChoiceResult`

与 ImageViewer 共用 `ViewerImage`（`Source`、`Alt`）。`Alt` 同时是说明文字。关闭时 `Element` 为 nil。

| 字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `open` | `*bool` | — | 是否显示；Escape、点击关闭或背景时设为 false。 |
| `index` | `*int` | — | 当前图片；越界 panic。 |
| `images` | `[]ViewerImage` | — | 至少一张，`Source` 须为 `*ui.Bitmap` 或 `*ui.SVG`。 |

## 状态

- 黑色遮罩铺满窗口，图片按 Contain 居中；首尾时对应切换按钮禁用。
- 打开时按弹层时长淡入，减少动画时直接出现。

## 事件

`Changed()` 在切换图片后为 true，并朗读“第 n 张，共 m 张”。

## 键盘操作

| 按键 | 作用 |
| --- | --- |
| ← / → | 上一张 / 下一张 |
| Home / End | 第一张 / 最后一张 |
| Escape | 关闭并把焦点还给打开它的控件 |

## 限制

- 不提供缩放与平移；需要时请用 ImageViewer。