For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/image.md.
v0.0.57
  • 简体中文
  • Image

    数据展示@rockshin/tao-ui

    支持全屏预览、图片组切换、缩放旋转、失败回退与进度占位的图片组件。

    每个示例都可以独立复制运行。带设备预览的示例可通过工具栏切换桌面与手机宽度。

    示例

    预览图片

    点击图片或聚焦后按 Enter 打开预览,Escape 关闭并恢复焦点。

    390 × 640
    TSX

    浏览图片组

    PreviewGroup 注册子图片,支持按钮或方向键切换前后图片。

    390 × 640
    TSX

    受控打开预览

    通过 open 和 onOpenChange 控制预览,可以从其他操作按钮打开。

    390 × 640
    TSX

    失败回退与仅缩略图

    源图加载失败后显示 fallback;preview:false 让图片保持普通展示。

    Fallback illustration
    Non-interactive thumbnail
    TSX

    进度占位

    进度由应用提供;本例通过滑块控制进度,到达 100% 后展示图片。

    45%
    TSX

    自定义遮罩提示与样式

    定制悬停提示和图片语义部件,同时保留预览行为。

    390 × 640
    TSX

    自定义预览操作

    actionsRender 接收默认工具栏与变换操作,本例增加 Reset。

    390 × 640
    TSX

    手机图片预览

    全屏预览为操作栏和安全区预留空间,可在手机壳中检查缩放、适配与切换。

    390 × 640
    TSX

    API

    ImagePreviewGroup

    属性说明类型默认值

    Image

    属性说明类型默认值