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

    Data Display@rockshin/tao-ui

    Images with full-screen preview, grouped navigation, zoom and rotation, fallbacks and progress placeholders.

    Each example can be copied and run independently. Use the device control on framed previews to switch between desktop and phone widths.

    Examples

    Preview an image

    Click the image or focus it and press Enter. Escape closes the preview and restores focus.

    390 × 640
    TSX

    Browse an image group

    PreviewGroup registers its children and supports previous/next navigation with buttons or arrow keys.

    390 × 640
    TSX

    Open a controlled preview

    Control open and onOpenChange to launch the preview from another action.

    390 × 640
    TSX

    Fallback and thumbnail-only mode

    fallback is shown after the source fails. preview:false keeps the image non-interactive.

    Fallback illustration
    Non-interactive thumbnail
    TSX

    Progress placeholder

    The progress value belongs to the application. This example controls it with a range input and shows the image at 100%.

    45%
    TSX

    Custom cover and styles

    Customize the hover cover and image slot without changing the preview behavior.

    390 × 640
    TSX

    Custom preview actions

    actionsRender receives the existing toolbar and transform actions. This example adds Reset.

    390 × 640
    TSX

    Preview on a phone

    The full-screen preview reserves space for actions and safe-area padding. Use the phone shell to check fit and navigation.

    390 × 640
    TSX

    API

    ImagePreviewGroup

    PropertyDescriptionTypeDefault Value

    Image

    PropertyDescriptionTypeDefault Value