|
| 1 | +--- |
| 2 | +template: overrides/main.html |
| 3 | +--- |
| 4 | + |
| 5 | +# Browser support |
| 6 | + |
| 7 | +Material for MkDocs goes at great lengths to support the largest possible range |
| 8 | +of browsers while retaining the simplemost possibilities for customization via |
| 9 | +modern CSS features like [custom properties] and [mask images]. |
| 10 | + |
| 11 | + [custom properties]: https://caniuse.com/css-variables |
| 12 | + [mask images]: https://caniuse.com/mdn-css_properties_mask-image |
| 13 | + |
| 14 | +## Supported browsers |
| 15 | + |
| 16 | +The following table lists all browsers for which Material for MkDocs offers full |
| 17 | +support, so it can be assumed that all features work without degradation. If you |
| 18 | +find a feature not to be working in a browser in the supported version range, |
| 19 | +please [open an issue]: |
| 20 | + |
| 21 | +<figure markdown> |
| 22 | + |
| 23 | +| Browser | Version | Release date | | | Usage | |
| 24 | +| ------------------------------------ | ------: | -----------: | ------: | -----: | ---------: | |
| 25 | +| | | | desktop | mobile | overall | |
| 26 | +| :fontawesome-brands-chrome: Chrome | 49+ | 03/2016 | 25.65% | 38.33% | 63.98% | |
| 27 | +| :fontawesome-brands-safari: Safari | 10+ | 09/2016 | 4.63% | 14.96% | 19.59% | |
| 28 | +| :fontawesome-brands-edge: Edge | 79+ | 01/2020 | 3.95% | n/a | 3.95% | |
| 29 | +| :fontawesome-brands-firefox: Firefox | 53+ | 04/2017 | 3.40% | .30% | 3.70% | |
| 30 | +| :fontawesome-brands-opera: Opera | 36+ | 03/2016 | 1.44% | .01% | 1.45% | |
| 31 | +| | | | | | __92.67%__ | |
| 32 | + |
| 33 | + <figcaption markdown> |
| 34 | + |
| 35 | +Browser support matrix sourced from [caniuse.com].[^1] |
| 36 | + |
| 37 | + </figcaption> |
| 38 | +</figure> |
| 39 | + |
| 40 | + [^1]: |
| 41 | + The data was collected from [caniuse.com] in January 2022 and is primarily |
| 42 | + based on browser support for [custom properties], [mask images] and the |
| 43 | + [:is pseudo selector] which are not completely polyfillable. |
| 44 | + |
| 45 | +Note that the usage data is based on global browser market share, so it could |
| 46 | +in fact be entirely different for your target demographic. It's a good idea to |
| 47 | +check the distribution of browser types and versions among your users. |
| 48 | + |
| 49 | + [open an issue]: https://github.com/squidfunk/mkdocs-material/issues/new/choose |
| 50 | + [caniuse.com]: https://caniuse.com/ |
| 51 | + [:is pseudo selector]: https://caniuse.com/css-matches-pseudo |
| 52 | + |
| 53 | +## Other browsers |
| 54 | + |
| 55 | +Albeit your site might not look as perfect as when viewed with a modern browser, |
| 56 | +the following older browser versions might work with some additional effort: |
| 57 | + |
| 58 | +- :fontawesome-brands-firefox: __Firefox 31-52__ – icons will render as little |
| 59 | + boxes due to missing support for [mask images]. While this cannot be |
| 60 | + polyfilled, it might be mitigated by hiding icons with [additional CSS]. |
| 61 | +- :fontawesome-brands-edge: __Edge 16-18__ – the spacing of some elements might be |
| 62 | + a little of due to missing support for the [:is pseudo selector], which can be |
| 63 | + mitigated with some [additional CSS]. |
| 64 | +- :fontawesome-brands-internet-explorer: __Internet Explorer__ - no support, |
| 65 | + mainly due to missing support for [custom properties]. The last version of |
| 66 | + Material for MkDocs to support Internet Explorer is |
| 67 | + [:octicons-tag-24: 4.6.3][IE support]. |
| 68 | + |
| 69 | + [additional CSS]: customization.md#additional-css |
| 70 | + [IE support]: https://github.com/squidfunk/mkdocs-material/releases/tag/4.6.3 |
0 commit comments