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 |
Other settings: Alphabetical | By function |
Details
editWhether 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
editThis 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
editCurrently (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.