Docs
Media gallery pattern
Use split galleries by default when photos and videos should appear in distinct sections.
Standard
- Use `SplitMediaGallerySection` when photos and videos must render in separate sections (default recommendation).
- Use `MediaGallerySection` for mixed photo and video sections when a unified gallery is desired.
- Keep media items in normalized arrays and pass them as props.
- Keep `showFilters` optional and default to user-friendly category groups.
- Core media visibility must not depend on JavaScript.
- Use optional photo lightbox as enhancement only, not as primary access path.
- Lightbox navigation (prev/next controls + keyboard arrows) is part of the standard behavior.
- Optional page behaviors (shuffle, max photos/videos, info notice, social CTA) are module props.
Reference
- Live example: Media gallery example page
- Component: `template/src/components/patterns/MediaGallerySection.tsx`
- Wrapper: `template/src/components/patterns/SplitMediaGallerySection.tsx`