Getting Started
Overview
Installation
Theme
Forms
Basic Inputs
Select
Custom Inputs
Components
Navigation
Components
69
Micro Charts
Libraries
Kanban Board
Image Designer
Video Player
Visual Builder
Content Editor
Data View
Latest npm version of @ngstarter-ui/componentsWeekly npm downloads of @ngstarter-ui/components
Purchase

Crop

Crop lets users select a crop area on top of an existing image or visual preview.

Use it when the user needs to move and resize a rectangle or circle selection before another part of the app applies the real image crop. The component emits the selected area as pixel values, percentages, and container dimensions through selectionApplied.

  • Interactive crop area
    Users can move the selection and resize it with visible handles.
  • Rectangle or circle shape
    Use rectangle for covers and thumbnails, or circle for avatar-style crops.
  • Coordinates only
    The component does not upload files, save images, or process the final bitmap.
Use it for:

Avatar dialogs, cover image forms, thumbnail preparation, media management screens, and content editor flows where another service or canvas step performs the actual crop.

PropTypeDefault
minWidth
Minimum width of the crop selection
number100
minHeight
Minimum height of the crop selection
number100
shape
Shape of the crop selection
'rectangle' | 'circle''rectangle'
EventDescription
selectionApplied
Emitted when the crop selection is changed or initialized