Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎polski • ‎português • ‎português do Brasil
Thumbnail settings: $wgResponsiveImages
Whether or not to output high-resolution images for high-DPI displays
Introduced in version: 1.21.0
Removed in version: still in use
Allowed values: (boolean)
Default value: true
Other settings: Alphabetical | By function


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 reaching roughly 90% of users globally.

For current browsers, compatibility JavaScript is loaded which checks window.devicePixelRatio for most browsers, and a compatibility fallback for IE 10, and applies srcset -> src change automatically. On browsers with native srcset support, this disables itself automatically.

Known limitations[edit]

Currently (as of 1.21) this code applies only to images created through Linker methods; image galleries and file: page detail displays are not currently affected. This should be changed at some point by migrating support lower down in the MediaHandler arena.

Display densities[edit]

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