Manual:$wgResponsiveImages

Thumbnail settings: $wgResponsiveImages
Whether or not to output high-resolution images for high-DPI displays
Introduced in version:1.21.0 (Gerrit change 24115; git #Id80ebd0)
Removed in version:Still in use
Allowed values:(boolean)
Default value:true

Details

edit

Whether or not to output high-resolution images for high-DPI displays.

This is primarily targeted at tablet browsers and newer desktops and laptops, such as the MacBook Pro with Retina display. On these high-DPI devices, raster images appear blurry or pixelated by default without special treatment.

When generating thumbnail images, thumbnails are rendered not only at the requested size, but at 1.5x and 2x the requested size. The HTML5 srcset attribute is included on the img specifying these larger images for the appropriate display densities.

Native support for the srcset attribute was first added to WebKit browsers in August 2013 and has since been adopted by most modern browsers, now (as of 2020) reaching over 94% of users globally.

Known limitations

edit

This code applies only to images created through Linker :

  • article thumbnails (1.21+)
  • file: page detail displays (1.23+)
  • image galleries (1.25+)
  • the imageinfo API (1.36+)


Display densities

edit

Currently (as of 1.39) the densities used (1.5x and 2x) are hardcoded and not configurable. 1x is the implied default density of the main image.