Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

aurelia-templating-binding

aurelia41.7kMIT1.6.0TypeScript support: included

An implementation of the templating engine's Binding Language abstraction which uses a pluggable command syntax.

aurelia, templating, html, databinding

readme

Aurelia

License: MIT npm Version ci Discourse status Twitter Discord Chat

aurelia-templating-binding

This library is part of the Aurelia platform and contains an implementation of the templating engine's Binding Language abstraction which uses a pluggable command syntax.

To keep up to date on Aurelia, please visit and subscribe to the official blog and our email list. We also invite you to follow us on twitter. If you have questions look around our Discourse forums, chat in our community on Gitter or use stack overflow. Documentation can be found in our developer hub.

Platform Support

This library can be used in the browser only.

Building The Code

To build the code, follow these steps.

  1. Ensure that NodeJS is installed. This provides the platform on which the build tooling runs.
  2. From the project folder, execute the following command:

    npm install
  3. Ensure that Gulp is installed. If you need to install it, use the following command:

    npm install -g gulp
  4. To build the code, you can now run:

    gulp build
  5. You will find the compiled code in the dist folder, available in three module formats: AMD, CommonJS and ES6.

  6. See gulpfile.js for other tasks related to generating the docs and linting.

Running The Tests

To run the unit tests, first ensure that you have followed the steps above in order to install all dependencies and successfully build the library. Once you have done that, proceed with these additional steps:

  1. Ensure that the Karma CLI is installed. If you need to install it, use the following command:

    npm install -g karma-cli
  2. Ensure that jspm is installed. If you need to install it, use the following commnand:

    npm install -g jspm
  3. Install the client-side dependencies with jspm:

    jspm install
  4. You can now run the tests with this command:

    karma start

    To test in Internet Explorer use this command:

    karma start --browsers IE

changelog

1.6.0 (2022-04-02)

Bug Fixes

1.6.0 (2022-04-02)

Bug Fixes

1.5.4 (2019-03-27)

Bug Fixes

  • all: change es2015 back to native-modules (d4f5514)

1.5.3 (2019-02-04)

Bug Fixes

  • all: change es2015 back to native-modules (d4f5514)

1.5.2 (2018-10-30)

Bug Fixes

  • Various fixes to let bindings.

1.5.1 (2018-10-02)

1.5.0 (2018-09-29)

Bug Fixes

  • BindingLanguage+Let: enhance implementation (863b6ef)

Features

  • Let: support let element (bef80fc)

1.4.2 (2018-06-20)

  • Updating dependencies.

1.4.1 (2018-02-14)

Bug Fixes

  • syntax-interpreter: use the hyphenated name (4e4c427), closes #122

1.4.0 (2017-10-02)

Bug Fixes

Features

1.3.0 (2017-02-26)

Features

1.2.0 (2017-01-09)

Features

  • options: default property support (e422b6c)

Performance Improvements

  • AttributeMap: use non-capturing regex group (fd4a7e7)

1.1.0 (2016-12-10)

Features

  • SyntaxInterpreter: add capture binding command (97fbfd7)

1.0.0 (2016-07-27)

1.0.0-rc.1.0.1 (2016-07-12)

Bug Fixes

  • InterpolationBinding: regression issue in array handling (5d772ca)

1.0.0-rc.1.0.0 (2016-06-22)

1.0.0-beta.1.2.4 (2016-05-10)

1.0.0-beta.1.2.3 (2016-05-05)

Bug Fixes

  • AttributeMap: handle standard SVG attributes (288ba120)

1.0.0-beta.1.2.2 (2016-05-03)

Bug Fixes

  • SyntaxInterpreter: one-way default binding mode for checkbox/radio value (124498c3)

1.0.0-beta.1.2.1 (2016-03-29)

Bug Fixes

  • SyntaxInterpreter: enable specifying oneTime default binding mode (74953349)

Features

  • attributeMap: map accesskey (5d9b1315)

1.0.0-beta.1.2.0 (2016-03-22)

Bug Fixes

  • determineDefaultBindingMode: only assign when conditions are matched (c952286f)

Features

  • syntax-interpreter: single quoted strings in options attributes (f26cd40a)

1.0.0-beta.1.1.2 (2016-03-01)

Bug Fixes

  • all: remove core-js dependency (213fbfe4)

Features

  • InterpolationBinding: add method to update one-time children (243aa759)
  • ref: support expressions (a98860b6)

1.0.0-beta.1.1.1 (2016-02-08)

1.0.0-beta.1.1.0 (2016-01-29)

Features

  • all: update jspm meta; core-js; aurelia deps (de63b6c5)

1.0.0-beta.1.0.2 (2015-12-16)

  • performance improvements

1.0.0-beta.1.0.1 (2015-12-03)

Bug Fixes

  • binding-language: apply default modes to options props (d025af9b)

1.0.0-beta.1 (2015-11-16)

0.17.1 (2015-11-15)

Bug Fixes

  • InterpolationBinding: obey binding mode when called by signal (d0c5ef1a)

0.17.0 (2015-11-10)

Bug Fixes

  • all: remove support for the global fallback binding command (5eb01aa5)
  • index: update to latest container api (f7001741)

Features

  • binding-behaviors: add support for binding behaviors (5fa455bd)

0.16.1 (2015-10-15)

Bug Fixes

  • InterpolationBinding:

0.16.0 (2015-10-13)

Bug Fixes

  • InterpolationBinding:
    • plug memory leak (feedc533)
    • handle array mutation Fixes aurelia/framework#77 (70cfdcfc)
  • SyntaxInterpreter:
    • handle array access in items (19d186e0)
    • use attributeMap when two-way binding (c473d14d)
  • TemplatingBindingLanguage: map contenteditable attribute (25336a2f)
  • all:
    • update to new templating apis (20168204)
    • update to latest plugin api (5b26230e)
    • update to new bindingMode API (9152dc1b)
    • upgrade compiler (9676dd24)
    • use attributeMap to map class and for to property names (c6671d53)
    • typos in binding language and options syntax (17f91fe0)
    • rename Filter to ValueConverter (e0753f5c)
  • attribute-map: add rowspan and colspan attributes (eb8667a3)
  • attributeMap: do not remap style (1813f392)
  • binding-language:
    • map tabindex attr to tabIndex prop (851479bc)
    • string interpolation renders empty string for number 0 (9eff937a, closes #3)
    • interpolation bindings should support value converters (95045ac3)
    • fix non-default binding mode overwrites (8b49ae59)
  • build:
    • update linting, testing and tools (9c763bac)
    • add missing bower bump (4cb8c02c)
  • index:
    • update to latest configuration api (9731a85a)
    • fix compiler error in plugin install function (7d1de765)
  • interpolation-binding: errors on undefined or null expression eval (212a13d0)
  • package:
    • change jspm directories (fd49210a)
    • update dependencies (c361659a)
    • update deps and fix bower semver ranges (a9bffa70)
    • update dependencies (f8927df5)
    • update Aurelia dependencies (b07b1f85)
    • update dependencies to latest (5f5fae4a)
    • update the templating dependency to latest (5e12d55a)
    • update templating to latest version (28bfb5c8)
    • update templating to latest version (ae5ed8e1)
    • update dependencies to latest versions (f7e960fa)
    • update dependencies to latest (b5379b2a)
    • update dependencies to latest versions (5c07af5b)
  • syntax: delegate and trigger now prevent default actions (7d6be6d4)
  • syntax-interpeter: destructuring syntax in for parses incorrectly (87c735aa, closes #36)
  • syntax-interpreter:
    • make repeater to work with new behavior model (5e1137e3)
    • incorrect string interpolation syntax (5bf69639)
    • use inspected attribute value for options (4916ac3f)
    • handle non bound options values (c13d9dd9)

Features

  • all: make ref bindings work with api properties (9541e397)
  • attributeMap: scrollTop/scrollLeft binding (26220cc9)
  • binding-language:
    • enable removing interpolated attributes (e66f5f42)
    • new binding language interface (4fae8ad8)
    • new syntax for element refs (a24d5967)
    • enable usage as plugin (0900eb76)
  • build: update compiler and switch to register module format (219e215b)
  • docs: generate api.json from .d.ts file (ea1742b7)
  • input: Adds default binding mode for input type file (a6b34b67)
  • syntax-interpreter:
    • add support for key value iterations in for (72c8c371)
    • enable dynamic commands (880cc153)
    • use provided default bindings for .bind (b59c3f21)
    • support call expression and name binding modes (97b4a83f)
  • test: fixup to work with pal (9a3f07ba)

0.15.0 (2015-09-05)

Bug Fixes

  • build: update linting, testing and tools (9c763bac)

Features

  • docs: generate api.json from .d.ts file (ea1742b7)

0.14.0 (2015-08-14)

Bug Fixes

  • all: update to new templating apis (20168204)
  • index: update to latest configuration api (9731a85a)

0.13.2 (2015-07-29)

  • Add readonly as default bindable property

0.13.1 (2015-07-13)

Features

  • input: Adds default binding mode for input type file (a6b34b67)

0.13.0 (2015-07-02)

Features

  • binding-language: enable removing interpolated attributes (e66f5f42)

0.12.0 (2015-06-08)

Bug Fixes

  • attribute-map: add rowspan and colspan attributes (eb8667a3)
  • attributeMap: do not remap style (1813f392)
  • syntax-interpeter: destructuring syntax in for parses incorrectly (87c735aa, closes #36)

Features

  • all: make ref bindings work with api properties (9541e397)
  • attributeMap: scrollTop/scrollLeft binding (26220cc9)

0.11.0 (2015-04-30)

Bug Fixes

  • InterpolationBinding: handle array mutation Fixes aurelia/framework#77 (70cfdcfc)
  • SyntaxInterpreter: use attributeMap when two-way binding (c473d14d)
  • TemplatingBindingLanguage: map contenteditable attribute (25336a2f)
  • all:
    • update to latest plugin api (5b26230e)
    • update to new bindingMode API (9152dc1b)

0.10.0 (2015-04-09)

Bug Fixes

  • all: upgrade compiler (9676dd24)
  • syntax-interpreter: make repeater to work with new behavior model (5e1137e3)

0.9.0 (2015-03-25)

Features

  • BindingLanguage: warn on interpolation in style attribute
  • SyntaxInterpreter: enable two-way binding of contenteditable elements

0.8.7 (2015-02-28)

Bug Fixes

  • package: change jspm directories (fd49210a)

0.8.6 (2015-02-28)

Bug Fixes

  • package: update dependencies (c361659a)

0.8.5 (2015-02-19)

Bug Fixes

  • binding-language: map tabindex attr to tabIndex prop (851479bc)
  • build: add missing bower bump (4cb8c02c)

Features

  • syntax-interpreter: add support for key value iterations in for (72c8c371)

0.8.4 (2015-01-29)

Bug Fixes

  • binding-language: string interpolation renders empty string for number 0 (9eff937a, closes #3)

0.8.3 (2015-01-25)

Bug Fixes

  • interpolation-binding: errors on undefined or null expression eval (212a13d0)

0.8.2 (2015-01-24)

Bug Fixes

  • package: update deps and fix bower semver ranges (a9bffa70)

0.8.1 (2015-01-23)

Bug Fixes

  • binding-language: interpolation bindings should support value converters (95045ac3)

0.8.0 (2015-01-22)

Bug Fixes

  • binding-language: fix non-default binding mode overwrites (8b49ae59)
  • package: update dependencies (f8927df5)
  • syntax-interpreter: incorrect string interpolation syntax (5bf69639)

Features

  • syntax-interpreter:
    • enable dynamic commands (880cc153)
    • use provided default bindings for .bind (b59c3f21)

0.7.2 (2015-01-12)

Bug Fixes

  • all: use attributeMap to map class and for to property names (c6671d53)

0.7.1 (2015-01-12)

Bug Fixes

  • syntax-interpreter: use inspected attribute value for options (4916ac3f)

0.7.0 (2015-01-12)

Bug Fixes

  • all: typos in binding language and options syntax (17f91fe0)
  • package: update Aurelia dependencies (b07b1f85)
  • syntax-interpreter: handle non bound options values (c13d9dd9)

Features

  • binding-language:
    • new binding language interface (4fae8ad8)
    • new syntax for element refs (a24d5967)

0.6.0 (2015-01-07)

Bug Fixes

  • package: update dependencies to latest (5f5fae4a)

0.5.0 (2015-01-06)

Bug Fixes

  • all: rename Filter to ValueConverter (e0753f5c)
  • index: fix compiler error in plugin install function (7d1de765)

Features

  • binding-language: enable usage as plugin (0900eb76)
  • build: update compiler and switch to register module format (219e215b)
  • syntax-interpreter: support call expression and name binding modes (97b4a83f)

0.4.0 (2014-12-22)

Bug Fixes

  • package: update the templating dependency to latest (5e12d55a)

0.3.2 (2014-12-18)

Bug Fixes

  • package: update templating to latest version (28bfb5c8)

0.3.1 (2014-12-18)

Bug Fixes

  • package: update templating to latest version (ae5ed8e1)

0.3.0 (2014-12-17)

Bug Fixes

  • package: update dependencies to latest versions (f7e960fa)

0.2.1 (2014-12-12)

Bug Fixes

  • package: update dependencies to latest (b5379b2a)
  • syntax: delegate and trigger now prevent default actions (7d6be6d4)

0.2.0 (2014-12-11)

Bug Fixes

  • package: update dependencies to latest versions (5c07af5b)