Configuración

Este módulo utiliza img-loader por debajo el cual se basa en mozjpeg, optipng, gifsicle y svgo.

Las opciones predeterminadas para estos optimizadores deberían ser suficientes en la mayoría de los casos, pero puede sobrescribir todas las opciones disponibles si lo deseas.

handleImages

  • Tipo: string[]
  • Por defecto: ['jpeg', 'png', 'svg', 'webp', 'gif']

@bazzite/nuxt-optimized-images registra el cargador webpack para todos estos tipos de archivos.

Si no quieres que uno de estos sea manejado por @bazzite/nuxt-optimized-images porque, por ejemplo, tienes otro plugin o una regla de carga personalizada, simplemente retírela del array.

Ten en cuenta que una imagen que se está manejando no significa que también se optimice automáticamente. El paquete de optimización requerido para esa imagen también tiene que ser instalado. Por favor, lea la sección paquetes de optimización para más información.

Si una imagen se maneja pero no se optimiza, significa que la imagen original se utilizará y se copiará para la compilación.

inlineImageLimit

  • Tipo: number
  • Por defecto: 1000

Los archivos más pequeños serán alineados con un data-uri por url-loader.

Este número define el tamaño máximo del archivo (en bytes) para que las imágenes se alineen. Si una imagen es más grande, se copiará a la carpeta estática de Nuxt.js. Las imágenes se optimizarán en ambos casos.

Para desactivar completamente el inlineado de la imagen, establece este valor en -1. Entonces, siempre obtendrás una URL de la imagen.

imagesName

  • Tipo: function
  • Por defecto: ({ isDev }) => isDev ? '[path][name][hash:optimized].[ext]' : 'img/[hash:7].[ext]'

El nombre de archivo de las imágenes optimizadas.

Advertencia

Asegúrate de mantener el fragmento [hash] para que reciban un nuevo nombre de archivo si el contenido cambia.

responsiveImagesName

  • Tipo: function
  • Por defecto: ({ isDev }) => isDev ? '[path][name]--[width][hash:optimized].[ext]' : 'img/[hash:7]-[width].[ext]'

El nombre de archivo de las imágenes responsive.

Advertencia

Asegúrate de mantener el fragmento [hash] para que reciban un nuevo nombre de archivo si el contenido cambia.

optimizeImagesInDev

  • Tipo: boolean
  • Por defecto: false

Para un desarrollo más rápido y HMR, las imágenes no se optimizan de forma predeterminada cuando se ejecutan en modo de desarrollo. En producción, las imágenes siempre se optimizan, independientemente de este ajuste.

mozjpeg

Advertencia

Requiere el paquete de optimización opcional imagemin-mozjpeg

  • Tipo: object
  • Por defecto: {}

mozjpeg se utiliza para optimizar las imágenes JPEG. Puede especificar las opciones para ello aquí. Las opciones predeterminadas de mozjpeg se utilizan si se omite esta opción.

pngquant

Advertencia

Requiere el paquete de optimización opcional imagemin-pngquant

  • Tipo: object
  • Por defecto: {}

pngquant se utiliza para optimizar las imágenes PNG por defecto. Las opciones predeterminadas de pngquant se utilizan si omite esta opción.

optipng

Advertencia

Requiere el paquete de optimización opcional imagemin-optipng

  • Tipo: object
  • Por defecto: {}

optipng es una forma alternativa de optimizar las imágenes PNG. Puedes especificar las opciones para ello aquí. Las opciones predeterminadas de optipng se utilizan si omite esta opción.

gifsicle

Advertencia

Requiere el paquete de optimización opcional imagemin-gifsicle

  • Tipo: object
  • Por defecto:
{
    interlaced: true,
    optimizationLevel: 3,
}

gifsicle se utiliza para optimizar las imágenes GIF. Puedes especificar las opciones para ello aquí. Las opciones predeterminadas de gifsicle se utilizan si omite esta opción.

svgo

Advertencia

Requiere el paquete de optimización opcional imagemin-svgo

  • Tipo: object
  • Por defecto: {}

svgo se utiliza para optimizar las imágenes e iconos svg. Puedes especificar las opciones para ello aquí. Las opciones predeterminadas de svgo se utilizan si omite esta opción.

Los plugins svgo pueden deshabilitarse o habilitarse en el array de plugins:

{
  svgo: {
    plugins: [
      { removeComments: false }
    ]
  }
}

webp

Advertencia

Requiere el paquete de optimización opcional webp-loader

  • Tipo: object
  • Por defecto: {}

imagemin-webp se utiliza para optimizar las imágenes de WebP y convertir otros formatos a WebP. Puedes especificar las opciones para ello aquí. Las opciones predeterminadas de imagemin-webp se utilizan si omite esta opción.

responsive

Advertencia

Requiere el paquete de optimización opcional responsive-loader

  • Tipo: object
  • Por defecto: {}

La configuración para responsive-loader puede definirse aquí.

defaultImageLoader

Advertencia

Requiere el paquete de optimización opcional responsive-loader

  • Tipo: string
  • Por defecto: 'img-loader'

Por defecto, img-loader maneja la mayoría de las peticiones.

TIP

Si usas mucho responsive-loader y no quieres añadir el parámetro de consulta ?resize a cada requerimiento, puedes establecer este valor en 'responsive-loader'.

Después de eso, responsive-loader manejará todas las imágenes JPEG y PNG por defecto, incluso sin un parámetro de consulta adicional. Ten en cuenta que no puedes usar ninguno de los parámetros de consulta que @bazzite/nuxt-optimized-images ofrece en estas imágenes porque la petición se reenvía y no se modifica.

Todos los demás formatos (SVG, WEBP y GIF) siguen funcionando como antes con img-loader y por lo tanto tienen todos los parámetros de consulta disponibles.

optimizeImages

  • Tipo: boolean
  • Por defecto: true

Si no deseas que las imágenes sean optimizadas, puedes establecer este valor en `false'.

Advertencia

Si no tienes ningún paquete de optimización instalado y esta opción está configurada como true, no se optimizará ninguna imagen. En este caso, se imprime una advertencia en la consola durante la compilación para informarte sobre una posible mala configuración.

Última Actualización: 3/1/2019, 5:40:04 PM