TODO: Update the badge URLs for the new module's repo.
Installing and enabling this module turns on an ES5, Internet Explorer 11-compatible backwards compatibility build for the public-facing frontend JavaScript bundle in Apostrophe 3.x. Modern browsers will still get a modern build and will not pay a performance penalty, although there is a performance impact during development and deployment.
Limitations
-
There is not and never will be support for the admin UI in IE11. This module only addresses the "public" JavaScript (imported by
ui/src/index.js
files). -
This module will polyfill JavaScript language features via
babel
, but doesn't attempt to polyfill missing browser features. You can of course load your own polyfills. Some browser features, likeObserver
, cannot be polyfilled for IE11. -
ui/public
javaScript files are loaded exactly as-is, by design. If you need these to work in IE11, they must already be ES5. -
Using this module will add a lot of
npm install
time, as well as asset build time. IE11 is no longer supported by Microsoft and has most likely been uninstalled automatically from most systems.
Think it over: are you sure you need this module?
Installation
First update apostrophe
to at least version 3.26.0
. Prior to that release, there is no need for this module, since ES5 support was formerly included in the core.
Then you can add this module:
npm install @apostrophecms/asset-es5
Usage
Enable this module in the app.js
file:
require('apostrophe')({
shortName: 'my-project',
modules: {
'@apostrophecms/asset-es5': {}
}
});