Image

Además de las características nativas de img, soporta la carga perezosa, marcador de posición personalizado y fallo de carga, etc.

Uso básico

Indica cómo la imagen debe ser redimensionada para que se adapte a su contenedor por medio de fit, al igual que de forma nativa, object-fit.

fill
contain
cover
none
scale-down

Placeholder

Personalice el placeholder del contenido mientras la imagen aún no ha sido cargada por medio de slot = placeholder

Default
Custom
Loading...

Fallo de carga

Personalice el contenido cuando ocurra algún error al cargar la imagen por medio de slot = error

Default
Custom

Carga perezosa

TIP

La carga nativa loading ha sido soportada desde 2.2.3, puede usar loading = "lazy" para reemplazar lazy = true.

Si el navegador actual soporta carga perezosa nativa, la carga perezosa nativa se utilizará primero, de lo contrario se implementará a través de scroll.

Use la carga perezosa por medio de lazy = true. La imagen se cargará hasta que se desplace a la vista cuando esté configurada. Puede indicar el contenedor de desplazamiento que añade el listener de desplazamiento a través del scroll-container. Si no está definido, será el contenedor padre más cercano cuya propiedad overflow es auto o scroll.

Vista previa de la imagen

permita una vista previa grande configurando la propiedad previewSrcList. Puede indicar la primera imagen previsualizada con initial-index. La posición inicial por defecto es 0.

API de imagen

Atributos de la imagen

NombreDescripciónTipoPor defecto
srcorigen de la imagen, igual que nativa.string''
fitindica cómo la imagen debe ser redimensionada para que se adapte a su contenedor por medio de fit, al igual que de forma nativa, object-fit.enum''
hide-on-click-modalal habilitar la vista previa, utilice esta bandera para controlar si al hacer clic en el fondo puede salir del modo de vista previa.booleanfalse
loading 2.2.3Indicates how the browser should load the image, same as native.enum
lazysi se usara la carga perezosa.booleanfalse
scroll-containerthe container to add scroll listener when using lazy load. By default, the container to add scroll listener when using lazy load.string / object
altatributo nativo alt.string
referrerpolicyatributo nativo referrerPolicy.string
crossoriginnative attribute crossorigin.enum
preview-src-listpermite vista previa de imágenes grandes.object[]
z-indexestablecer el z-index de la vista previa de la imagen.number
initial-indexíndice de imagen de vista previa inicial, debe ser menor que la longitud de url-list.number0
close-on-press-escapewhether the image-viewer can be closed by pressing ESC.booleantrue
preview-teleportedsi adjuntar la visualización previa al body. Un atributo anidado del elemento padre debe tener este atributo establecido en true.booleanfalse
infinitewhether the viewer preview is infinite.booleantrue
zoom-ratethe zoom rate of the image viewer zoom event.number1.2
min-scale 2.4.0the min scale of the image viewer zoom event.number0.2
max-scale 2.4.0the max scale of the image viewer zoom event.number7

Eventos de imagen

NombreDescripciónTipo
loadigual que el load nativo.Function
errorigual que el error nativo.Function
switchse dispara cuando las imágenes cambian.Function
closese dispara al hacer clic en el botón de cerrar o con hide-on-click-modal habilitado haciendo clic en el fondo.Function
showtrigger when the viewer displaysFunction

Slots de Image

NombreDescripción
placeholdercontenido personalizado cuando la imagen no se ha cargado todavía.
errorcontenido personalizado cuando la carga de imagen falle.
viewercustom content when image preview.

API del visor de imágenes

Atributos del visor de imágenes

NombreDescripciónTipoPor defecto
url-listlista de enlaces de la vista previa.object[]
z-indexz-index del fondo de la previsualización.number / string
initial-indexíndice de imagen de vista previa inicial, debe ser menor que la longitud de url-list.number0
infinitesi la vista previa es infinita.booleantrue
hide-on-click-modalsi el usuario puede emitir un evento de cierre al hacer clic en el fondo.booleanfalse
teleportedsi añadir la imagen misma al body. Un atributo anidado del elemento padre debe tener este atributo establecido en true.booleanfalse
zoom-rate 2.2.27the zoom rate of the image viewer zoom event.number1.2
min-scale 2.4.0the min scale of the image viewer zoom event.number0.2
max-scale 2.4.0the max scale of the image viewer zoom event.number7
close-on-press-escapewhether the image-viewer can be closed by pressing ESC.booleantrue

Eventos del visor de imágenes

NombreDescripciónTipo
closese dispara al hacer clic en el botón de cerrar o con hide-on-click-modal habilitado haciendo clic en el fondo.Function
switchse dispara cuando las imágenes cambian.Function
rotate 2.3.13trigger when rotating images.Function

Image Viewer Exposes

NameDescripciónType
setActiveItemcambiar imagen manualmenteFunction

Fuente

ComponentesStyleDocumentación

Contribuidores