For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/en/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/en/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/en/components/image.md.
A3S UI
  • English
  • next

      • Image

      Combines an image, alternative text, caption, and loading state into a stable reading unit that avoids layout shift.

      Live preview
      Official A3S OS mark
      Official identity asset rendered with a stable aspect ratio.

      Usage

      <figure class="image" data-state="ready" data-aspect="square">
  <img src="/logo.png" alt="Official A3S OS mark" width="480" height="480" /><figcaption>Official identity asset rendered with a stable aspect ratio.</figcaption>
</figure>

      Contract

      SurfaceValue
      Root selectorfigure.image
      Native root<figure>
      Statesloading, ready, error
      Events—
      Methods—

      Product boundary

      It does not proxy remote media, moderate content, or edit pixels. Enlarged inspection belongs to Image Viewer and choice tasks belong to Image Select.

      The component publishes a reusable interaction boundary only. Data fetching, persistence, permission, trusted content, and business entities remain host-owned.

      Accessibility

      Informative images need accurate alt text; decorative images use empty alt. Declare dimensions or aspect ratio and provide textual recovery for failure.