Image

The v-img component is packed with features to support rich media. Combined with the vuetify-loader, you can add dynamic progressive images to provide a better user experience.

API

v-img
Name
alt
Default
undefined
Type
string

Components.Images.

Name
aspect-ratio
Default
undefined
Type
string | number

Components.Images.

Name
contain
Default
false
Type
boolean

Components.Images.

Name
gradient New in — v1.2
Default
undefined
Type
string

Components.Images.

Name
height
Default
undefined
Type
number | string

Components.Images.

Name
lazy-src
Default
undefined
Type
string

Components.Images.

Name
max-height
Default
undefined
Type
number | string

Components.Images.

Name
max-width
Default
undefined
Type
number | string

Components.Images.

Name
min-height
Default
undefined
Type
number | string

Components.Images.

Name
min-width
Default
undefined
Type
number | string

Components.Images.

Name
position
Default
'center center'
Type
string

Components.Images.

Name
sizes
Default
undefined
Type
string

Components.Images.

Name
src
Default
undefined
Type
string | object

Components.Images.

Name
srcset
Default
undefined
Type
string

Components.Images.

Name
transition
Default
fade-transition
Type
boolean | string

Components.Images.

Name
width
Default
undefined
Type
number | string

Components.Images.

Examples

Contain and Cover

If the provided aspect ratio doesn't match that of the actual image, the default behavior is to fill as much space as possible, clipping the sides of the image. Enabling the contain prop will prevent this, but will result in empty space at the sides.

Height

v-img will automatically grow to the size of its src, preserving the correct aspect ratio. You can limit this with the height and max-height props.

Fixed ratio

Gradients

The gradient prop can be used to apply a simple gradient overlay to the image. More complex gradients should be written as a class on the content slot instead.

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore