Framework Compatibility - HelixDesignSystem/helix-ui GitHub Wiki

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.

Vanilla HTML

See HelixUI with Vanilla HTML for more details.

AngularJS 1.x

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.

Angular 2+

See HelixUI with Angular for more details.

React 15

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.