FEATURES.md

About Features

Please read the Feature Flag Guide for a detailed explanation.

Feature Flags

• ember-libraries-isregistered

  Add isRegistered to Ember.libraries. This convenience method checks whether a library is registered with Ember or not.

• ember-routing-core-outlet

  Provides a non-virtual version of OutletView named CoreOutletView. You would use CoreOutletView just like you're use OutletView: by extending it with whatever behavior you want and then passing it to the {{outlet}} helper's view property.

  The only difference between them is that OutletView has no element of its own (it is a "virtual" view), whereas CoreOutletView has an element.

• ember-application-visit

  Provides an API for creating an application instance and specifying an initial URL that it should route to. This is useful for testing (you can have multiple instances of an app without having to run serially and call reset() each time), as well as being critical to for FastBoot.

• ember-application-instance-initializers

  Splits apart initializers into two phases:

  • Boot-time Initializers that receive a registry, and use it to set up code structures
  • Instance Initializers that receive an application instance, and use it to set up application state per run of the application.

  In FastBoot, each request will have its own run of the application, and will only need to run the instance initializers.

  In the future, tests will also be able to use this differentiation to run just the instance initializers per-test.

  With this change, App.initializer becomes a "boot-time" initializer, and issues a deprecation warning if instances are accessed.

  Apps should migrate any initializers that require instances to the new App.instanceInitializer API.

• ember-application-initializer-context

  Sets the context of the initializer function to its object instead of the global object.

  Added in #10179.

• ember-testing-checkbox-helpers

  Add check and uncheck test helpers.

  check:

  Checks a checkbox. Ensures the presence of the checked attribute

  Example:

  check('#remember-me').then(function() {
    // assert something
  });

  uncheck:

  Unchecks a checkbox. Ensures the absence of the checked attribute

  Example:

  uncheck('#remember-me').then(function() {
    // assert something
  });

• ember-routing-named-substates

  Add named substates; e.g. when resolving a loading or error substate to enter, Ember will take into account the name of the immediate child route that the error/loading action originated from, e.g. 'foo' if FooRoute, and try and enter foo_error or foo_loading if it exists. This also adds the ability for a top-level application_loading or application_error state to be entered for loading/error events emitted from ApplicationRoute.

  Added in #3655.

• ember-htmlbars-component-generation

  Enables HTMLBars compiler to interpret <x-foo></x-foo> as a component invocation (instead of a standard HTML5 style element).

• ember-htmlbars-inline-if-helper

  Enables the use of the if helper in inline form. The truthy and falsy values are passed as params, instead of using the block form.

  Added in #9718.

• ember-htmlbars-attribute-syntax

  Adds the class="{{color}}" syntax to Ember HTMLBars templates. Works with arbitrary attributes and properties.

  Added in #9721.

• ember-htmlbars-each-in

  Adds a helper for enumerating over the properties of an object in a Handlebars templates. For example, given this data:

  {
    "Item 1": 1234,
    "Item 2": 3456
  }

  And this template:

  {{#each-in items as |key value|}}
    <p>{{key}}: {{value}}</p>
  {{/each-in}}

  The following output would be produced:

  <p>Item 1: 1234</p>
  <p>Item 2: 3456</p>

• ember-routing-transitioning-classes

  Disables eager URL updates during slow transitions in favor of new CSS classes added to link-tos (in addition to active class):

  • ember-transitioning-in: link-to is not currently active, but will be when the current underway (slow) transition completes.
  • ember-transitioning-out: link-to is currently active, but will no longer be active when the current underway (slow) transition completes.

  Added in #9919

• ember-metal-stream

  Exposes the basic internal stream implementation as Ember.Stream.

  Added in #9693

• ember-htmlbars-each-with-index

  Adds an optional second parameter to {{each}} block parameters that is the index of the item.

  For example,

  <ul>
    {{#each people as |person index|}}
       <li>{{index}}) {{person.name}}</li>
    {{/each}}
  </ul>

  Added in #10160

• ember-router-willtransition

  Adds willTransition hook to Ember.Router. For example,

  Ember.Router.extend({
    onBeforeTransition: function(transition) {
      //doSomething
    }.on('willTransition')
  });

  Added in #10274

• ember-views-component-block-info

  Adds a couple utility methods to detect block/block param presence:

  • hasBlock

    Adds the ability to easily detect if a component was invoked with or without a block.

    Example (hasBlock will be false):

    {{! templates/application.hbs }}
    
    {{foo-bar}}
    
    {{! templates/components/foo-bar.js }}
    {{#if hasBlock}}
      This will not be printed, because no block was provided
    {{/if}}

    Example (hasBlock will be true):

    {{! templates/application.hbs }}
    
    {{#foo-bar}}
      Hi!
    {{/foo-bar}}
    
    {{! templates/components/foo-bar.js }}
    {{#if hasBlock}}
      This will be printed because a block was provided
      {{yield}}
    {{/if}}

  • hasBlockParams

  Adds the ability to easily detect if a component was invoked with block parameter supplied.

  Example (hasBlockParams will be false):

  {{! templates/application.hbs }}
  
  {{#foo-bar}}
    Hi!.
  {{/foo-bar}}
  
  {{! templates/components/foo-bar.js }}
  {{#if hasBlockParams}}
    {{yield this}}
    This will not be printed, because no block was provided
  {{/if}}

  Example (hasBlockParams will be true):

  {{! templates/application.hbs }}
  
  {{#foo-bar as |foo|}}
    Hi!
  {{/foo-bar}}
  
  {{! templates/components/foo-bar.js }}
  {{#if hasBlockParams}}
    {{yield this}}
    This will be printed because a block was provided
  {{/if}}

  Addd in #10461

• ember-routing-htmlbars-improved-actions

  Using the (action subexpression, allow for the creation of closure-wrapped callbacks to pass into downstream components. The returned value of the (action subexpression (or submit={{action 'save'}} style subexpression) is a function. mut objects expose an INVOKE interface making them compatible with action subexpressions.

  Per RFC #50

• ember-htmlbars-get-helper

  The Syntax: {{get object path}}

  A new keyword/helper that can be used to allow your object and/or key values to be dynamic.

  Example:

  context = {
    displayedPropertyTitle: 'First Name',
    displayedPropertyKey: 'firstName'
  };

  <h2>{{displayedPropertyTitle}}</h2>
  
  <ul>
  {{#each people as |person|}}
    <li>{{get person displayedPropertyKey}}</li>
  {{/each}}
  </ul>

  This allows the template to provide displayedPropertyTitle and displayedPropertyKey to render a list for a single property for each person.. E.g. a list of all firstNames, or lastNames, or ages.

  Addd in #11196

• ember-htmlbars-helper

  Implements RFC emberjs/rfcs#53, a public helper api.

• ember-htmlbars-dashless-helpers

  Implements RFC emberjs/rfcs#58, adding support for dashless helpers.

• ember-debug-handlers

  Implemencts RFC emberjs/rfcs#65, adding support for custom deprecation and warning handlers.

• ember-registry-container-reform

  Implements RFC emberjs/rfcs#46, fully encapsulating and privatizing the Container and Registry classes by exposing a select subset of public methods on Application and ApplicationInstance.

  Application initializers now receive a single argument to initialize: application.

  Likewise, ApplicationInstance initializers still receive a single argument to initialize: applicationInstance.