https://github.com/apostrophecms/asset-es5

For those who still require IE11 support for the frontend build.
https://github.com/apostrophecms/asset-es5

Last synced: 9 days ago
JSON representation

For those who still require IE11 support for the frontend build.

• Host: GitHub
• URL: https://github.com/apostrophecms/asset-es5
• Owner: apostrophecms
• License: mit
• Created: 2022-07-22T20:04:41.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-03-13T17:39:46.000Z (10 months ago)
• Last Synced: 2024-12-19T18:15:23.892Z (15 days ago)
• Language: JavaScript
• Size: 17.6 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
**TODO:** Update the badge URLs for the new module's repo.



  


  
ES5 Support for ApostropheCMS

  


    

      

    

    

      

    

    

      

    

    

      

    

  



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, like `Observer`, 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:

```javascript

require('apostrophe')({

  shortName: 'my-project',

  modules: {

    '@apostrophecms/asset-es5': {}

  }

});

```