전체 카탈로그
OverlayLightbox7 props

Lightbox

A fullscreen overlay for viewing images and videos at full resolution. Supports single-item and gallery modes with prev/next navigation, optional zoom and pan for images, and na...

공식 문서 열기
live previewOverlay

Preview

Architecture detail
Architecture detail
Architecture detail

Import

import {Lightbox} from '@astryxdesign/core/Lightbox';

Astryx 문서 권장 방식대로 root barrel이 아니라 컴포넌트 subpath에서 가져옵니다.

When to use

A fullscreen overlay for viewing images and videos at full resolution. Supports single-item and gallery modes with prev/next navigation, optional zoom and pan for images, and na...

lightboximagevideoviewergalleryzoomfullscreenmedia

Important props

mediaLightboxMedia | LightboxMedia[]required

Theming targets

astryx-lightbox

Best practices

  • DoAlways provide alt text for every image for screen reader accessibility.
  • DoUse gallery mode with onIndexChange for multi-image sets.
  • DoEnable hasZoom only when viewing high-resolution images that benefit from close inspection.
  • Do notUse the lightbox for non-image content; it is specialized for images.