MujicaUI/docs/components/079-image-viewer.md

079 ImageViewer · 图片查看器

用途

在窗口上方的模态层中查看图片：放大、缩小、平移、适应窗口、上一张/下一张，以及键盘操作与关闭。

最小示例

picture := ui.MustParseSVG([]byte(`<svg xmlns="http://www.w3.org/2000/svg" width="240" height="160"><rect width="240" height="160" fill="#AD9164"/><path d="M120 20 L200 80 L120 140 L40 80 Z" fill="#7D2034"/></svg>`))
open, index := true, 0
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	data.ImageViewer(c, &open, &index, []data.ViewerImage{{Source: picture, Alt: "Rose window"}})
}
ui.Render(view, 400, 300, 1)

参数

func ImageViewer(c *ui.Context, open *bool, index *int, images []ViewerImage) ChoiceResult。ViewerImage 字段：Source（*ui.Bitmap 或 *ui.SVG，必填）、Alt（说明文字与无障碍名称）。关闭时返回的 Element 为 nil。

字段	类型	默认值	含义
open	*bool	必填	为 true 时显示；Escape、点击遮罩或关闭按钮设为 false。
index	*int	必填	当前图片下标；越界 panic。
images	[]ViewerImage	必填	至少一张。

状态

缩放 25%–800%（相对适应窗口），按钮在边界处禁用；适应窗口时“适应”按钮禁用；首张/末张时上一张/下一张禁用。

事件

ChoiceResult.Changed()：切换了图片，*index 已更新。关闭通过 *open 变为 false 观察。

键盘操作

• • / -：放大、缩小；0：适应窗口。
• ←/→：上一张、下一张；Shift+方向键：平移。
• 滚轮：缩放；拖动图片：平移。
• Escape：关闭；Tab 在工具按钮与图片之间移动。

限制

• 基于 MyGo ui.DialogBase，焦点限制与关闭后的焦点恢复由 MyGo 处理。
• 图片解码由调用方完成（ui.DecodeBitmap），组件不读取文件或网络。
• 不支持旋转与触控板捏合手势。