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.
- History of commits to AngularDart documentation
- History of commits to AngularDart examples
- Package changelogs:
AngularDart 5.0 beta / Dart 2.0 beta (July 2018)
- Updated Dart SDK and Angular package versions in
sdk: '>=2.0.0 <3.0.0'
- Switched to new build system:
- Added new
- Dropped all old pub
- Added new
web/index.htmlfiles because Dartium is no longer supported:
<script defer src="packages/browser/dart.js"></script>
<script defer src="main.dart" type="application/dart"></script>by
<script defer src="main.dart.js"></script>
testversion 0.12.30 or later runs chrome tests headless by default. We were already using version 0.12.30 along with the Angular 4 examples.
- Added error option to
- Changed app launching code in
import 'package:angular_app/app_component.template.dart' as ng;
- Switched to compile-time dependency injection:
Switched to using typed
Angular 4.x provider Angular 5 provider Bare class name
Provider(C, useClass: D)
ClassProvider(C, useClass: D)
Provider(C, useValue: v)
Provider(C, useFactory: f, deps: d)
(Compile-time DI makes explicitly declaring
Provider(C, useExisting: D)
For examples, see Files changed in the dependency-injection diff.
Switched to static configuration of root injectors in
web/main.dartfiles that formerly bootstrapped providers. For example, see
web/main.dartunder the Files changed tab of the toh-5 diff.
- Updated all
test/*_test.dartfiles and their Angular entry points:
import 'foo_test.template.dart' as ng;in the test file for
- For every function
NgTestBed.forComponent<AppComponent>(ng.FooComponentNgFactory, rootInjector: injector);where
injectoris an injector factory created by a newly added
injectorfield (as described above).
- Adjusted to new template syntax:
- Binding syntax:
ngFor microsyntax statements must be separated using semicolon (
Using a space or comma to separate statements is no longer supported.
- Switched to use of new Angular router API:
There are many Dart file changes (too many to list all here) including:
routerProviders, and provide through runApp() (recommended)
- Other Dart file changes:
- Template-syntax example changes due to the deprecation of
- Switched to using setter to detect changes to view children (
Dart 2 specific changes:
- Dart file changes:
- Dropped unnecessary
Angular doc changes:
- Added a description of
exportparameters to the Template Syntax page.
- Component Styles: dropped “Template inline styles” and “Template link tags” section since both forms of template styling are now ignored.
- 5.0 prep tracking issue
- Diff between 4.x and 5-dev branches
- Diff between 4.x and 5-dev branches for selected example apps:
HTML library tour (December 2017)
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
Router HashLocationStrategy (October 2017)
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). For details, see
Which location strategy to use.
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
- Updated package versions in
angular_forms: ^1.0.0for examples using forms
angular_router: ^1.0.0for examples using the router
- Updated transformers in
resolved_identifiersentry from the
angular: entry_points:for examples with component tests
- Changed imports in Dart files:
angular_forms/angular_forms.dartto files using
- Other Dart file changes:
const Provider<T>(x,y)for a provider of
Tinstances; this is a first step towards strongly-typed providers
Element, which requires an import of
- Changed the CSS pseudo selector
- Changed a component (PR#950) to use the new
@Component(RFC#374) to export enums to the component template
- Switched from the use of
outputsparameters to appropriate
- Switched from the use of
- Changed API doc URLs
angularchange affected API doc URLs.
Example: …/angular2/NgFor-class → …/angular/NgFor-class
angular_formsfor forms API elements, such as
angular_routerfor router API elements, such as
- Removed documentation for native view encapsulation since it is no longer supported.
- Diff between 3.x and 4-dev branches
- History for site-webdev/examples/ng (4-dev branch)
- 4.0 prep tracking issue
API reference (August 2017)
The API entries from both the
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.
- Component testing
- End-to-end (E2E) testing (placeholder)
API doc changes (July 2017)
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.
Example: …/angular2.common/NgFor-class → …/angular2/NgFor-class
The API doc homepage
now shows an
importstatement 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):
pubspec.yamlto make dartdevc the default development compiler.
- Moved most implementation Dart files under
lib/src/*, instead of
lib/*, to improve dartdevc performance.
- dartdevc documentation
- Dart 1.24 announcement
- PR #744 and other “src reorg” PRs
- PR #684 (pubspec changes)
AngularDart 3.1 (May 2017)
The examples changed to update the release and reflect new recommendations.
angular2.coreAPI doc references. Example: …/angular2.core/OnInit-class → …/angular2/OnInit-class
- To prepare for 3.1’s experimental compiler, in each example:
pubspec.yaml, moving the directives it listed to the relevant components’
COMMON_PIPESto the relevant components’
- Updated the
angular2dependency in each example’s pubspec:
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: Dart component file @Component( ... directives: const [CORE_DIRECTIVES], pipes: const [COMMON_PIPES])
Common directive constants include
Testing doc and code, part 1 (March-April 2017)
Created an initial Testing page and added component tests to the tutorial examples.
- Added the