rwjblueember-angle-bracket-invocation-polyfill
This addon provides a polyfill for angle bracket invocation syntax as described in RFC 311 and RFC 457. It's the same components you know and love, no longer surrounded by mustaches. \o/
Installation
ember install ember-angle-bracket-invocation-polyfillYou will additionally need to ensure ember-cli-htmlbars-inline-precompile is at least version 1.0.3.
Usage
The best usage guide are the RFCs themselves (emberjs/rfcs#311 emberjs/rfcs#457), but here are a few examples of "before"/"after" to whet your appetite:
Before:
{{site-header user=this.user class=(if this.user.isAdmin "admin")}}
{{#super-select selected=this.user.country as |s|}}
{{#each this.availableCountries as |country|}}
{{#s.option value=country}}{{country.name}}{{/s.option}}
{{/each}}
{{/super-select}}After:
<SiteHeader @user={{this.user}} class={{if this.user.isAdmin "admin"}} />
<SuperSelect @selected={{this.user.country}} as |s|>
{{#each this.availableCountries as |country|}}
<s.option @value={{country}}>{{country.name}}</s.option>
{{/each}}
</SuperSelect>Supported Features
- Supports invoking components via angle brackets using TitleCase
<FooBar></FooBar>- Supports invoking components via angle brackets with self-closing syntax
<FooBar />- Supports invoking components via angle brackets using paths
<some.thing></some.thing>- Supports invoking components via angle brackets using yielded block params
{{#with (component 'foo-bar') as |Foo|}}
<Foo></Foo>
{{/with}}- Supports passing arguments into invoked components with
@prefix
<FooBar @title={{whateverHere}}></FooBar>- Supports passing attributes to be added to the root element of the component without
@prefix
<FooBar data-test-foo-bar></FooBar>- Supports using
has-blockinside the invoked component to determine if a block was provided
<FooBar /> {{! checking `has-block` inside would be `false`}}
<FooBar></FooBar> {{! checking `has-block` inside would be `true`}}- Supports yielding block params from inside the invoked component
<FooBar as |qux|>{{qux}}</FooBar>- Supports passing
...attributesinto another angle bracket invocation
<FooBar ...attributes>- Supports passing
...attributesinto a non-component element
<div ...attributes></div>- Supports passing
...attributesinto tagless components - Supports invoking single word components:
<Title />- Supports invoking components nested in subfolders:
<Foo::Bar />- Completely inert when running Ember 3.10 or higher
- Supports Ember 2.12, 2.16, 2.18, 3.1, 3.2, 3.3, 3.4, 3.8, 3.9
- Test all the features listed above 😘
Addons
Any addons wanting to use angle bracket components (in either addon/ or addon-test-support/) need to install ember-angle-bracket-invocation-polyfill as a dependency.
Limitations
There are no known limitations, all features described in the RFC are polyfilled.
Contributing
Installation
git clone <repository-url>cd ember-angle-bracket-invocation-polyfillyarn install
Linting
yarn lint:jsyarn lint:js --fix
Running tests
ember test– Runs the test suite on the current Ember versionember test --server– Runs the test suite in "watch mode"ember try:each– Runs the test suite against multiple Ember versions
Running the dummy application
ember serve- Visit the dummy application at http://localhost:4200.
For more information on using ember-cli, visit https://ember-cli.com/.
License
This project is licensed under the MIT License.