-
Notifications
You must be signed in to change notification settings - Fork 25
Framework Compatibility
Even though HelixUI strives to remain platform-agnostic, we also want to build functionality in a way that provides the least resistance for integration into a consumer's technology stack. As such, you should avoid implementing any business logic into new functionality (no API calls, no permission/authorization logic, no URLs, etc.).
Click one of the links below to read about HelixUI compatibility for various frameworks.
| Framework | Versions | Supported? |
|---|---|---|
| Vanilla HTML / No Framework | - | YES |
| AngularJS | 1.x and earlier |
no |
| Angular | 2.x and later |
YES |
| React 15 | 15.x |
no |
| React 16+ | 16.x and later |
YES |
| VueJS 2.x | 2.x |
YES |
Keep reading to learn more about framework compatibility issues and strategies to correct or work around them.
See HelixUI with Vanilla HTML for more details.
AngularJS (0.x - 1.x) is not supported.
However, according to custom-elements-everywhere.com, AngularJS 1.7.8 has perfect compatibility with custom elements. Compatibility with earlier versions of AngularJS 1.x are unknown, though.
If you are using AngularJS, you might want to consider upgrading or porting to a modern framework. As announced by the AngularJS team, AngularJS 1.7 is the last feature release and will remain in a 3-year Long Term Support period. On June 30, 2021, AngularJS will reach the end of its support.
See HelixUI with Angular for more details.
React 15 is not supported.
It lacks support for the slot attribute, which is required in order to take advantage of Light DOM redistribution into Shadow DOM slots. For this redistribution to happen, the slot attribute needs to be present in the rendered markup. React 15 ignores unknown attributes and slot isn't a known attribute, so it's missing from the rendered markup. This results in Light DOM elements being redistributed into the wrong Shadow DOM slots.
See HelixUI with React for more details.
See HelixUI with VueJS for more details.