Changelog


This page summarizes changes to this site’s documentation and examples. Many of these changes are due to new releases of AngularDart, AngularDart Components, or the Dart SDK. Others are the result of new recommendations or documentation.

Also see:

Forms (October 2017)

Updated the forms page and its example app to use custom CSS classes instead of the ng-* classes associated with the deprecated NgControlStatus.

Router HashLocationStrategy (October 2017)

Switched to using HashLocationStrategy in the Router example and the Tutorial.

In this way, features like deep linking into the example apps work as expected when no server-side support is available (such as with GitHub Pages and with pub serve, which is often used during app development). See the Router section on Declaring router providers and directives for details.

AngularDart 4.0.0 (August 2017)

All pubspecs and imports changed, as well as API doc URLs, due to the angular2 package changing its name to angular.

  • Updated package versions in pubspec.yaml:
    • angular: ^3.1.0^4.0.0
    • angular_components: ^0.5.3^0.6.0
    • angular_test: ^1.0.0-beta^1.0.0
    • Added angular_forms: ^1.0.0 for examples using forms
    • Added angular_router: ^1.0.0 for examples using the router
  • Updated transformers in pubspec.yaml:
    • angular2angular
    • Removed resolved_identifiers entry from the angular transformer
    • Removed reflection_remover transformer entry
    • Added test/**_test.dart as an angular: entry_points: for examples with component tests
  • Changed imports in Dart files:
    • angular2/angular2.dartangular/angular.dart
    • angular2/common.dartangular/angular.dart
    • angular2/platform/browser.dartangular/angular.dart
    • angular2/platform/common.dartangular/angular.dart
    • angular2/router.dartangular_router/angular_router.dart
    • Added angular_forms/angular_forms.dart to files using formDirectives
  • Other Dart file changes:
    • FORM_DIRECTIVESformDirectives
    • COMMON_DIRECTIVESCORE_DIRECTIVES, formDirectives
    • const Provider(x,y)const Provider<T>(x,y) for a provider of T instances; this is a first step towards strongly-typed providers
    • Changed injected ElementRef to Element, which requires an import of dart:html
    • Changed the CSS pseudo selector /deep/ to ::ng-deep
    • Changed a component (PR#950) to use the new exports parameter of @Component (RFC#374) to export enums to the component template
    • Switched from the use of @Component inputs and outputs parameters to appropriate @Input() and @Output() annotations.
    • Switched from the use of <glyph> (GlyphComponent) to <material-icon> (MaterialIconComponent)
  • Changed API doc URLs
    • The angular2angular change affected API doc URLs.
      Example: …/angular2/NgFor-class → …/angular/NgFor-class
    • angular2angular_forms for forms API elements, such as formDirectives
    • angular2angular_router for router API elements, such as Route

More information:

API reference (August 2017)

The API entries from both the angular and angular_components packages have been combined into a single unified API reference.

Testing docs, part 2 (August 2017)

Created several test-related pages. The original page, Testing, is now mostly a table of contents.

All of these pages are drafts, and we’d appreciate your feedback.

API doc changes (July 2017)

Because common.dart is going away in 4.0, we changed API doc generation. We also fixed some bugs in the API doc homepage and added import information for each library.

  • angular2.commonangular2
    Example: …/angular2.common/NgFor-class → …/angular2/NgFor-class
  • The API doc homepage now shows an import statement next to each library’s heading.

Dart 1.24 (June 2017)

We did initial work to prepare the examples to use the Dart development compiler (dartdevc):

  • Updated pubspec.yaml to make dartdevc the default development compiler.
  • Moved most implementation Dart files under lib/src/*, instead of lib/*, to improve dartdevc performance.

More information:

AngularDart 3.1 (May 2017)

The examples changed to update the release and reflect new recommendations.

  • Replaced core.dart imports: angular2/core.dartangular2/angular2.dart
  • Updated angular2.core API doc references. Example: …/angular2.core/OnInit-class → …/angular2/OnInit-class
  • To prepare for 3.1’s experimental compiler, in each example:
    • Removed platform_directives from pubspec.yaml, moving the directives it listed to the relevant components’ directives lists.
    • Removed platform_pipes from pubspec.yaml, moving COMMON_PIPES to the relevant components’ pipes lists.
  • Updated the angular2 dependency in each example’s pubspec: ^3.0.0^3.1.0.

Here’s an example of moving the directive and pipe lists:

OLD: pubspec.yaml

transformers: - angular2: platform_directives: - 'package:angular2/common.dart#CORE_DIRECTIVES' platform_pipes: - 'package:angular2/common.dart#COMMON_PIPES'

NEW: component file (Dart)

@Component( ... directives: const [CORE_DIRECTIVES], pipes: const [COMMON_PIPES])

Common directive constants include COMMON_DIRECTIVES, CORE_DIRECTIVES, FORM_DIRECTIVES, and ROUTER_DIRECTIVES.

More information:

Testing doc and code, part 1 (March-April 2017)

Created an initial Testing page and added component tests to the tutorial examples.

Pubspec updates:

  • Added angular_test and test to the dev_dependencies list.
  • Added the reflection_remover and pub_serve transformers.

More information: