MujicaUI/docs/components/344-lightbox.md

344 Lightbox 灯箱

用途

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

最小示例

images := []data.ViewerImage{{Source: ui.NewBitmap(examplePhoto), Alt: "The grand hall"}}
open, index := false, 0
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	if input.Button(c, "View photos", input.ButtonOptions{}).Clicked() {
		open = true
	}
	media.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。