Skip to content
This repository has been archived by the owner on Sep 3, 2021. It is now read-only.

Latest commit

 

History

History
109 lines (93 loc) · 4.84 KB

compatibility.md

File metadata and controls

109 lines (93 loc) · 4.84 KB
Raw

Browser Compatibility

Toolkit was engineered for the latest in mobile and desktop browsers, but this doesn't stop it from degrading gracefully for older browsers. Degrading allows for plugins in older browsers to function as normal by removing animations, reducing the amount of CSS styles being used, or by simplifying JavaScript functionality.

Supported Browsers

For the most part, the latest 3 versions of the following modern browsers are officially supported. Anything older will not be supported (depending on context and severity of issue).

  • Chrome (Windows, Mac, iOS, Android)
  • Firefox (Windows, Mac)
  • Safari (Mac, iOS)
  • Internet Explorer (Windows)
  • Opera (Windows)

While older versions are not officially supported, Toolkit will function to some extent. The following minimum versions should support most (if not all) of Toolkit's functionality.

  • Chrome 11+
  • Firefox 10+
  • Safari 5.1+
  • Internet Explorer 9+
  • Opera 12+

Internet Explorer 9

Although IE9 is supported, it does not support many of the features implemented by modern browsers, which is represented in the table below. Support is determined through caniuse.com and can be verified by clicking on the table row titles.

Feature Internet Explorer 8 Internet Explorer 9
HTML5 Elements Can be enabled with modernizr or normalize.css ✓
CSS3 Animations Falls back to element display toggling as the JavaScript layer does not use animations
CSS3 Transitions Any transition effects will be instant
CSS3 Box Sizing Has partial support ✓
CSS3 Colors No rgba() or hsla() support ✓
CSS3 Selectors No advanced selector support ✓
Em Scaling ✓ ✓
Rem Scaling Instances of rem will need to be overwritten ✓
Media Queries Can be enabled with respond.js ✓
matchMedia() Can be enabled with matchMedia polyfill

Internet Explorer 8

IE8 is not supported in any form for Toolkit 2, and any integration and bug fixing is on you, the developer. However, IE8 does work to some extent in Toolkit 1, but any of the new features in Toolkit 2 are not backported.

If you really need to support IE8, the following libraries will aid in that effort. We highly suggest not supporting IE8, as it is a 5 year old browser that will simply increase technical debt.

Compatibility Mode

Toolkit is not supported in older Internet Explorer compatibility modes. Be sure that the latest rendering mode for IE is being used by including the following meta tag in your page.

<meta http-equiv="X-UA-Compatible" content="IE=edge">