Getting Started
Overview
Installation
Theme
Colors
Customize Theme
Playground
Theme Generator
Typography
Forms
Basic Inputs
Button Toggle
Buttons
Checkbox
Input
Radio
Segmented
Slide Toggle
Select
Autocomplete
Country Select
Currency Select
Date Format Select
Select
Timezone
Custom Inputs
Form Renderer
Inline Text Edit
Input Mask
Number Input
Password Strength
Phone Input
Pin Input
Components
Navigation
Breadcrumbs
Navigation
Rail Navigation
Side Panel
Sidebar
Tab Panel
Components
68
Action Required
Alert
Announcement
Avatar
Badge
Block Loader
Bottom Sheet
Card
Card Overlay
Carousel
Chips
Code Highlighter
Color Picker
Color Switcher
Command Bar
Comment Editor
Comparison Slider
Confirm
Content Fade
Cookie Popup
Crop
Datepicker
Dialog
Divider
Drawer
Emoji Picker
Empty State
Expand
Expansion Panel
Filter Builder
Gauge
Grid
Guided Tour
Icon
Image Placeholder
Image Resizer
Image Viewer
Image Zoom Viewer
Incidents
Keyboard
Layout
List
Marquee
Menu
Notifications
Paginator
Panel
Popover
Progress Bar
Progress Spinner
Resizable Container
Screen Loader
Sidenav
Signature Pad
Skeleton
Slider
Snackbar
Split Pane
Stepper
Suggestions
Table
Tabs
Text Editor
Thumbnail Maker
Tiles
Timeline
Timepicker
Toolbar
Tooltip
Tree
Upload
Video Viewer
Micro Charts
Bar Chart
Line Chart
Pie Chart
Libraries
Kanban Board
Basic Example
Overview
Image Designer
Basic Example
Overview
Video Player
Basic Example
Carousel Example
Minimal Example
Overview
Visual Builder
Basic Example
Overview
Content Editor
Content Builder
Overview
Data View
Basic
Column pinning
Column settings
Custom cell renderers
Custom empty state
Embedded
Filter data
Loading state
Overview
Pinning and pagination
Refresh
Resizable columns
Server side
Server side (empty state)
Sticky columns
With action bar
With pagination
With selection
With sorting
 Purchase

Image viewer

Image Viewer opens a full-size image in a focused overlay from a thumbnail, card, or gallery item. Wrap the image group with ngsImageViewer, mark each clickable item with ngsImageViewerPicture, and pass sourceUrl for the full-size image.

The overlay supports close, loading state, zoom in and out, drag/pan when zoomed, and optional title, caption, and description through inputs or Angular templates. Use it for galleries, attachments, product images, media previews, portfolio cards, and other places where a user clicks a preview to inspect the full image.

Do not use Image Viewer for inline zoom inspection without an overlay, editing, crop selection, displayed-width resizing, before/after comparison, plain static images, video previews, or missing image placeholders. Use ImageZoomViewer, ImageDesigner, Crop, ImageResizer, ComparisonSlider, a normal img, VideoViewer, or ImagePlaceholder for those cases.

Key features:
  • Opens a full-size sourceUrl from a clickable preview.
  • Supports title, caption, and description content.
  • Includes zoom and drag/pan behavior in the overlay.
  • Works with any preview markup inside ngsImageViewerPicture.

The NgStarter Angular Image Viewer component lets you open a full-size image in a focused lightbox-style overlay from a thumbnail, card, or gallery item. Use ngsImageViewer on a group and ngsImageViewerPicture on each clickable preview item when users should click a thumbnail or card to inspect a full-size image from sourceUrl. It includes examples for Basic image viewer, Image viewer with caption and description, and Image viewer with title.

Basic image viewer

Click a preview item to open its full-size sourceUrl in the viewer overlay.

Image viewer with caption and description

Add caption and description templates when the full-size image needs supporting context in the overlay.

Image viewer with title

Add a title when the viewer should identify the image, author, item, or media record.