angular 5.0.0-alpha+3 angular: ^5.0.0-alpha+3 copied to clipboard
Fast and productive web framework
5.0.0-alpha+3 #
New features #
-
Provider
is now soft-deprecated (not preferred), and new more-typed classes exist:ClassProvider
,ExistingProvider
,FactoryProvider
, andValueProvider
. Each also has a.forToken
named constructor that infers theProvider<T>
'sT
value from the providedOpaqueToken<T>
'sT
. This is meant to help with the move to strong mode and DDC, and is now the preferred way to configure dependency injection. -
Any variation of
multi: true
when configuring dependency injection is now soft-deprecated (not preferred), and theMultiToken
class has been added. AMultiToken<T>
now represents anOpaqueToken<T>
wheremulti: true
is implicitly alwaystrue
:
const usPresidents = const MultiToken<String>('usPresidents');
@Component(
selector: 'presidents-list',
providers: const [
const ValueProvider.forToken(usPresidents, 'George Washington'),
const ValueProvider.forToken(usPresidents, 'Abraham Lincoln'),
],
)
class PresidentsListComponent {
// Will be ['George Washington', 'Abraham Lincoln'].
final List<String> items;
PresidentsListComponent(@Inject(usPresidents) this.items);
}
- We are starting to support the new build system at
dart-lang/build
. More information and documentation will be included in a future release, but we expect to drop support forpub serve/build
by 5.0.0 final.
Breaking changes #
- Dartium is no longer supported. All development of your AngularDart
applications is now required to be in DDC. With incoming language
and library changes this would have been required regardless, but we expect
to have faster build tools available (instead of
pub serve
) soon.
Bug fixes #
-
Fixed a bug where
ReflectiveInjector
would return anObject
instead of throwingArgumentError
when resolving an@Injectable()
service that injected a dependency with one or more annotations (i.e.@Inject(...)
). -
Fixed a bug where
DatePipe
didn't formatmillisecondsSinceEpoch
in the local time zone (consistent with how it formatsDateTime
).
5.0.0-alpha+2 #
Breaking changes #
-
Replaced
Visibility.none
withVisibility.local
. The former name is misleading, as a directive is always capable of providing itself locally for injection via another token. -
RenderComponentType
is no longer part of the public API. -
Dropped support for
@AngularEntrypoint
and rewriting entrypoints to automatically useinitReflector()
andbootstrapStatic
. This will no longer be supported in the new build system so we're encouraging that manual changes are made as of this release:
// test/a_test.dart
import 'a_test.template.dart' as ng;
void main() {
ng.initReflector();
}
// web/a_app.dart
import 'package:angular/angular.dart';
import 'a_app.template.dart' as ng;
@Component(selector: 'app', template: '')
class AppComponent {}
void main() {
bootstrapStatic(AppComponent, [/*providers*/], ng.initReflector);
}
- Use of the template annotation
@deferred
does not work out of the box with the standard bootstrap process (bootstrap/bootstrapStatic
), only the experimentalbootstrapFactory
. We've added a backwards compatible compiler flag,fast_boot
, that may be changed tofalse
. We don't expect this to impact most users.
transformers:
angular:
fast_boot: false
Bug fixes #
-
Fixed a bug where errors thrown in event listeners were sometimes uncaught by the framework and never forwarded to the
ExceptionHandler
. Closes https://github.com/dart-lang/angular/issues/721. -
The
$implicit
(iterable) value in*ngFor
is now properly typed whenever possible. It was previously always typed asdynamic
, which caused dynamic lookups/calls at runtime, and hid compilation errors. -
Fixed a bug where an
@deferred
components were still being linked to ininitReflector()
.
Refactors #
- Added
Visibility.all
as the default visibility of all directives. This has no user-facing implications yet, but will allow migrating the default fromVisibility.all
toVisibility.local
.
5.0.0-alpha+1 #
NOTE: As of angular 5.0.0-alpha+1
dependency_overrides
are required:
dependency_overrides:
analyzer: ^0.31.0-alpha.1
This is because we are starting to use and support the Dart 2.0.0 SDK, which is evolving. We expect to no longer require overrides once we are at a beta release, but this is unlikely until sometime in early 2018.
New features #
- Added an optional input to
NgTemplateOutlet
namedngTemplateOutletContext
for setting local variables in the embedded view. These variables are assignable to template input variables declared usinglet
, which can be bound within the template. See theNgTemplateOutlet
documentation for examples.
Breaking changes #
-
Removed
WrappedValue
.AsyncPipe.transform
will no longer return aWrappedValue
when the transformed result changes, and instead will rely on regular change detection. -
Pipes no longer support private types in their
transform
method signature. This method's type is now used to generate a type annotation in the generated code, which can't import private types from another library. -
Removed the following from the public API:
APPLICATION_COMMON_PROVIDERS
BROWSER_APP_COMMON_PROVIDERS
BROWSER_APP_PROVIDERS
PACKAGE_ROOT_URL
ErrorHandlingFn
UrlResolver
WrappedTimer
ZeroArgFunction
appIdRandomProviderFactory
coreBootstrap
coreLoadAndBootstrap
createNgZone
createPlatform
disposePlatform
getPlatform
In practice, most of these APIs were never intended to be public and never had a documentation or support, and primarily existed for framework-internal consumption. Others have been made obsolete by new language features in Dart.
In particular, the UrlResolver
class was no longer needed by the framework
itself, and there is a cost to supplying APIs that we don't use. Clients that
need this code (deprecated as of 4.x) can copy it safely into their own
projects.
-
Removed unused
context
parameter fromTemplateRef.createEmbeddedView
. -
Removed deprecated getters
onStable
|onUnstable
fromNgZone
. They have been reachable asonTurnDone
|onTurnStart
for a few releases.
Bug fixes #
- Correctly depend on
analyzer: ^0.31.0-alpha.1
.
Refactors #
- Use the new generic function syntax, stop using
package:func
. - Now using
code_builder: '>=2.0.0-beta <3.0.0'
.
5.0.0-alpha #
We are now tracking the Dart 2.0 SDK. It is not recommended to use the 5.0.0-alpha series of releases unless you are using a recent dev release of the Dart SDK. We plan to exit an alpha state once Dart 2.0 is released.
If you are individually depending on angular_compiler
, we require:
dependencies:
angular_compiler: '^0.4.0-alpha`
New features #
- Both
ComponentFactory
andComponentRef
are now properly typed<T>
whereT
is the type of the@Component
-annotated class. Prior to this release,ComponentFactory
did not have a type, andComponentRef<T>
was alwaysComponentRef<dynamic>
.
Breaking changes #
-
preserveWhitespace
is nowfalse
by default in@Component
. The old default behavior can be achieved by settingpreserveWhitespace
totrue
. -
Classes annotated
@Component
can no longer be treated like services that were annotated with@Injectable()
, and now fail when they are used within aReflectiveInjector
. Similar changes are planned for@Directive
. -
Removed
inputs
field fromDirective
. Inputs now must be declared using inline@Input
annotations.
Bug fixes #
-
Fixed a bug where injecting the
Injector
in a component/directive and passing a second argument (as a default value) always returnednull
. It now correctly returns the second argument (closes #626). -
No longer invoke
ExceptionHandler#call
with anull
exception. -
Using
Visibility.none
no longer applies to providers directly on the@Component
or@Directive
; in practice this makesnone
closer to thelocal
visibility in AngularDart v1, orself
elsewhere in AngularDart; we might consider a rename in the future. -
Fixed a bug where the hashcode of an item passed via
ngFor
changing would cause a strange runtime exception; while it is considered unsupported for a mutable object to have an overridenhashCode
, we wanted the exception to be much better.
Refactors #
- The
StylesheetCompiler
is now aBuilder
, and is being integrated as part of the template code genreator instead of a separate build action. This will let us further optimize the generated code.
Performance #
- Types bound from generics are now properly resolved in a component when inheriting from a class with a generic type. For example, the following used to be untyped:
class Container<T> {
@Input()
T value;
}
class StringContainerComponent implements Container<String> {}
4.0.0 #
We are now named package:angular
instead of package:angular2
. As such
you cannot pub upgrade
from angular2 3.x
-> angular2 4.x
, and you need to
manually update your dependencies instead:
dependencies:
angular: ^4.0.0
AngularDart will start tracking the upcoming Dart 2.0 alpha SDK, and as such,
4.0.0 will be the last stable release that fully supports Dart 1.24.0. We may
release small patches if needed, but otherwise the plan is to release 4.0.0 and
then immediately start working on 5.0.0-alpha
, which uses the new Dart SDK.
Breaking changes #
-
@Pipe
-annotated classes are no longer considered@Injectable
, in that they aren't usable within aReflectiveInjector
. You can get this behavior back by adding the@Injectable()
annotation to the@Pipe
-annotated class. Similar changes are in progress for@Component
and@Directive
. -
PLATFORM_{PIPES|DIRECTIVES|PROVIDERS}
, which was only supported in an older version of the compiler, was removed. All of these must be manually included in lists in an@Directive
or@Component
annotation. -
Removed
formDirectives
fromCOMMON_DIRECTIVES
list; replaceCOMMON_DIRECTIVES
with[CORE_DIRECTIVES, formDirectives]
for components that use forms directives. -
Forms API has been moved to a new package,
angular_forms
, which is going to be versioned and maintained alongside the core framework. This should allow better segmentation of code and easier contributions. -
The router package is now being published separate as
package:angular_router
(not throughpackage:angular/router.dart
). In the near future it will be updated to a more Dart idiomatic "2.0" router, but for now it is an exact replica of the previous router. -
Removed
@{Component|Directive}#queries
. This is replable using the same member-level annotation (i.e.@{Content|View}Child{ren}
). -
DynamicComponentLoader
was renamedSlowComponentLoader
to encourage users to preferComponentLoader
. Additionally, argumentsprojectableNodes:
andonDestroy:
callbacks were removed - they were mostly unused, and confusing since they were undocumented. -
Removed
angular/platform/browser_static.dart
; replace imports withangular/angular.dart
. -
Removed
angular/platform/common_dom.dart
; replace imports withangular/angular.dart
. -
Removed
angular/testing.dart
; Useangular_test
package instead. -
Removed
angular/platform/testing.dart
. -
Removed
platform/testing/browser_static.dart
. -
Removed
MockNgZone
. -
Removed
ViewEncapsulation.native
, which is no longer supported. -
Renamed
FORM_DIRECTIVES
toformDirectives
. -
Removed
angular/common.dart
; replace imports withangular/angular.dart
. -
Removed
angular/compiler.dart
; compiler should only be invoked via the transformers or viapkg:build
directly usingangular/source_gen.dart
. -
Deprecated
@View()
annotation was completely removed. -
Deprecated second parameter to
ExceptionHandler
was completely removed. -
Removed the runtime (
dart:mirrors
-based) interpreter. It is now required to always use the AngularDart transformer to pre-compile the code, even during development time in Dartium.package:angular2/reflection.dart
was also removed. -
The
bootstrap
function now always throws a runtime exception, and both it andbootstrapStatic
are accessible viaangular.dart
instead ofplatform/browser.dart
andplatform/browser_static.dart
#357. -
Returning
false
from an event handler will no longer cancel the event. See #387 for details. -
Removed
Query
andViewQuery
. Please useContentChild
/ContentChildren
andViewChild
/ViewChildren
in their place instead. -
Removed the
use_analyzer
flag for the transformer. This is alwaystrue
. #404. -
Removed all other unused or unsupported flags from the transformer. There is now a single
CompilerFlags
class that is universally supported for all build systems. -
Removed a number of classes that were never intended to be public.
-
Removed the second parameter to
ExceptionHandler
, which was a no-op anyway. -
Removed
outputs
field fromDirective
. Outputs now must be declared using inlineOutput
annotations.
New features #
-
Added support for functional directives: lightweight, stateless directives that apply a one-time transformation.
-
One is defined by annotating a public, top-level function with
@Directive()
. -
The function parameters specify its dependencies, similar to the constructor of a regular directive.
-
Only the
selector
andproviders
parameters of the@Directive()
annotation are permitted, because the other parameters are stateful. -
The function return type must be
void
.
-
@Directive(selector: '[autoId]')
void autoIdDirective(Element element, IdGenerator generator) {
element.id = generator.next();
}
- Added
visibility
property toDirective
. Directives and components that don't need to be injected can setvisibility: Visibility.none
in their annotation. This prevents the compiler from generating code necessary to support injection, making the directive or component non-injectable and reducing the size of your application.
// This component can't be injected by other directives or components.
@Component(selector: 'my-component', visibility: Visibility.none)
class MyComponent { ... }
- Added
ComponentLoader
, a high-level imperative API for creating components at runtime. It uses internal code-paths that already existed, and is much more future proof.ComponentLoader
is usable within a@Directive()
, an@Component()
, and injectable services.
// An `ExampleComponent`s generated code, including a `ComponentFactory`.
import 'example.template.dart' as ng;
class AdBannerComponent implements AfterViewInit {
final ComponentLoader _loader;
AdBannerComponent(this._loader);
@override
ngAfterViewInit() {
final component = _loader.loadDetached(ng.ExampleComponentNgFactory);
// Do something with this reference.
}
}
-
You can now directly inject
dart:html
'sElement
orHtmlElement
instead ofElementRef
, which is "soft deprecated" (will be deprecated and removed in a future release). -
findContainer
has now been exposed from NgForm allowing easier creation of custom form implementations. -
setUpControl
has been exposed from the forms API to allow forms to setup their controls easier. -
Inheritance for both component and directive metadata is now complete! Any field or method-level annotations (
@Input
,@Output
,@ViewChild|Children
,@ContentChild|Children
) are now inherited through super types (extends
,implements
,with
) #231:
class BaseComponent {
@Input()
String name;
}
// Also has an input called "name" now!
@Component(selector: 'comp')
class ConcreteComponent extends BaseComponent {}
- Inputs that are of type
bool
now receive a default value oftrue
instead of a value ofnull
or an empty string. This allows a much more HTML-friendly syntax for your components:
<!-- All of these set a value of disabled=true -->
<fancy-button disabled></fancy-button>
<fancy-button [disabled]></fancy-button>
<fancy-button [disabled]="true"></fancy-button>
<!-- Value of disabled=false -->
<fancy-button [disabled]="false"></fancy-button>
@Component()
class FancyButton {
@Input()
bool disabled = false;
}
- Added
exports: [ ... ]
to@Component
, which allows the limited use of top-level fields and static methods/fields in a template without making an alias getter in your class. Implements #374.
import 'dart:math' show max;
@Component(
selector: 'comp',
exports: const [
max,
],
// Should write '20'
template: '{{max(20, 10)}}',
)
class Comp {}
-
Limitations:
- Only top-level fields that are
const
(notfinal
) can be exported.
- Only top-level fields that are
-
Added
@deferred
as the first "compile-time" directive (it has no specific runtime code nor is it listed in adirectives: [ ... ]
list. Implements #406.
import 'package:angular2/angular2.dart';
import 'expensive_comp.dart' show ExpensiveComp;
@Component(
selector: 'my-comp',
directives: const [ExpensiveComp],
template: r'''
<expensive-comp @deferred></expensive-comp>
''',
)
class MyComp {}
-
Added preliminary support for component inheritance. Components now inherit inputs, outputs, host bindings, host listeners, queries, and view queries from all supertypes.
-
We use a new open sourcing tool called "CopyBara" that greatly simplifies both releasing and taking open source contributions. We are able to release to github more often, and accept PRs much more easily. You can view our bleeding
github-sync
branch for what has yet to be merged intomaster
. -
We no longer emit
ng_*.json
files as part of the compile process #276. -
Attribute selectors (
<ng-content select="custom-action[group='1']">
) is now supported #237. -
Lifecycle interfaces no longer need to be "re-implemented" on classes in order for the compiler to pick them up - we now respect the dependency chain #19.
-
Provider(useValue: ...)
now accepts "complex const data structures", with the caveat that your data structure must not be invoking a private constructor #10.
Deprecations #
- Support for shadow piercing combinators
/deep/
and>>>
to prevent style encapsulation is now deprecated./deep/
is already deprecated and will be removed in Chrome 60. Its alias>>>
is limited to the static profile of selectors, meaning it's not supported in style sheets. Continued use of these combinators puts Angular at risk of incompatibility with common CSS tooling.::ng-deep
is a drop-in replacement, intended to provide the same functionality as/deep/
and>>>
, without the need to use deprecated or unsupported CSS syntax #454.
Bug fixes #
-
Compiler now warns when annotations are added to private classes or functions.
-
Compiler now warns when injecting into a field that is non-existent.
-
Fixed a long-standing bug on
ngSwitch
behavior in Dartium. -
Fixed a bug in
@deferred
when nested views has DI bindings. Fixes #578. -
The transformer now fails if any unsupported arguments are passed in.
-
Fixed a bug where
@deferred
did not work nested inside of<template>
:
<template [ngIf]="someCondition">
<expensive-comp @deferred></expensive-comp>
</template>
-
ngForm
now allowsonSubmit
to be called with anull
value. -
Using
inputs|outputs
in the@Component
annotation to rename an existing@Input()
or@Output()
now logs and fails the build during compilation. -
Symbol collisions with
dart:html
no longer cause a runtime exception, all framework use ofdart:html
is now scoped behind a prefixed import. -
Properly annotate methods in generated
.template.dart
code with@override
. -
Updated the documentation for
OnInit
andOnDestroy
to mention more specifics about the contract and document "crash detection" cases where they may be called more than once. -
*ngIf
now properly checks that inputs do not change during change detection #453. -
Properly typed
TrackByFn
as anint
not anum
#431. -
Import aliases are supported by the compiler #245.
Performance #
-
Various small reductions to the size of generated code and the runtime.
-
Directives now generate their own change detector class (behind the scenes) instead of the code being re-created into every component that uses a directive.
-
Remove redundant calls to
dbg(...)
in dev-mode. This reduces the amount of work done and speeds up developer runtimes, such as those using the DartDevCompiler (DDC). -
Some change detection code that was duplicated across all generated templates were moved internally to a new
AppView#detectHostChanges
method. -
Introduced a new
AppViewData
structure in the generated code that decreases code size ~2% or more in some applications due to better code re-use and emit in dart2js. -
We no longer change detect literals and simple
final
property reads. -
Some of the enums used to manage change detection state have been simplified to
int
in order to reduce the cost in the generated code.
3.1.0 #
New features #
-
Exposed
TouchFunction
andChangeFunction
typedefs to make the transition to strong-mode easier for teams relying on these function definitions. We might remove them in a future release when they are no longer needed. -
Added a flag to use an experimental new compiler that uses the Dart analyzer to gather metadata information. This flag will be turned on by default in
4.0
:
transformers:
angular2/transform/codegen:
use_analyzer: true
WARNING: Using use_analyzer: true
requires discontinuing use of the
platform_*
options, and fails-fast if both flags are used. See
https://goo.gl/68VhMa for details.
WARNING: Using use_analyser: true
doesn't yet work with most third-party
packages due to a bug.
Deprecations #
- Using
dart:mirrors
(i.e. running AngularDart without code generation) is now formally deprecated. In4.0+
code generation will be the only way to run an AngularDart application, even in development mode. Please ensure you are using our transformer: https://goo.gl/rRHqO7.
Bug fixes #
-
CSS errors are now just warnings, and can be ignored. This is due to using a CSS parser for encapsulation - and the AngularDart transformer aggressively runs on all CSS files in a given package. We hope to make this smoother in a future release.
-
Do not generate
throwOnChanges
checks outside of dev-mode.
Performance #
- Bypasses the deprecated event plugin system for all native DOM events.
- At runtime
interpolate
is now represented by multiple functions (faster). KeyValueDiffer
(NgClass
,NgStyle
) optimized for initial add/removals.- No longer generates event handler registrations for directive outputs.
3.0.0 #
New features #
composeValidators
andcomposeAsyncValidators
now part of the public API.angular2/testing.dart
includes a test-onlyisDebugMode
function.- (Forms)
AbstractControl.markAsDirty
now emits a status change event.
Breaking changes #
-
Requires at least Dart SDK
1.23.0
. -
Injecting
null
is no longer supported. -
Remove unused
useProperty
argument in DIProvider
api. -
ReflectionCapabilities.isReflectionEnabled
renamed toreflectionEnabled
. -
Malformed CSS warnings are errors now.
-
Removed forms async validators. Alternative:
control.valueChange((value) { rpc.validate(change).then((errors) { if (errors != null) control.setErrors(errors); }); });
-
Removed
TitleService
. To update the title, usedart:html
:document.title = 'My title';
-
DynamicComponentLoader
now has a simplified API:loadAsRoot
,loadAsRootIntoNode
replaced by a singleload
method that always creates the component root node instead of hoisting into an existing node. -
Removed
viewBindings
fromComponent
. This has been interchangeable withviewProviders
for a while now.BEFORE:
dart @Component(viewBindings: const [])
AFTER:
dart @Component(viewProviders: const [])
-
Removed
EventManager
from the public API. Code generation is now closer todocument.addEventListener
and having this interception layer would not allow further optimizations. -
Removed
IterableDifferFactory
andKeyValueDifferFactory
from the public API. We have planned compiler optimizations that will no longer allow overriding our diffing implementations. Looking into alternatives before a final3.0.0
release that are lower cost. -
ASYNC_VALIDATORS
can no longer return aStream
instance, onlyFuture
. -
The experimental
NgTestBed
was removed. Usepackage:angular_test
now. -
By default, the
ExceptionHandler
is aBrowserExceptionHandler
, which prints exceptions to the console. If you don't want this behavior (i.e. releasing to production), make sure to override it. -
ElementRef.nativeElement
is nowfinal
(no setter). -
DOM adapter is now completely removed from the API and generated code
-
A
name
parameter is now required for all@Pipe(...)
definitions:BEFORE:
dart @Pipe(name: 'uppercase')
AFTER:
dart @Pipe('uppercase')
-
DomEventsPlugin
now requires a strongly typed interface todart:html
. -
Null
is no longer propagated as an initial change value. Code should be updated to either deliver a different initial value or components with an@Input()
should have an appropriate default value.BEFORE
<my-component [value]="null"></my-component> ... String _value; set value(String value) { _value = value ?? 'Default name'; }
AFTER
String _value = 'Default name'; set value(String value) { _value = value; }
-
Removed the
isFirstChange()
method ofSimpleChange
. Instead, check whetherpreviousValue
isnull
. -
Removed
NgPlural
, deprecated as of 2.1.0. -
Removed
ObservableListDiffFactory
, deprecated as of 2.1.0. -
Event handlers are bound at initialization time. Therefore, the following will no longer work, because
clickHandler
isnull
during initialization.@Component( selector: 'my-component', template: '<div (click)="clickHandler($event)"></div>') class MyComponent { Function clickHandler; }
-
Removed
Component.moduleId
, which was unused.
Deprecations #
@View
will be removed in4.0
, only use@Component
instead.EventEmitter
is now@Deprecated
: UseStream
andStreamController
.ngSwitchCase
replacesngSwitchWhen
(soft deprecation).XHR
is deprecated, along with the runtime/reflective compiler.IterableDiffers
andKeyValueDiffers
are deprecated. The cost of looking up to see if a custom differ is available is too high for almost no use. Before they're removed, we'll have other customization options.
Bug fixes #
- Updated various documentation to make cleaner and use Dart, not TS, samples.
- Perf: Added performance improvements around generated code and type inference.
- Fix: Key-value differ now detects removals when first key moves.
- Fix:
<ng-content select="...">
does not emit incorrect code (regression). - Perf: Optimized how reflective providers are resolved on application startup.
ngSwitchWhen
now properly compares identity in Dartium.Component/Directive#selector
is now a@required
property.- Angular warns in the console if using Dartium without checked mode.
- Various performance improvements for both code size and runtime.
- Various Dart idiomatic/style guide updates to the codebase.
ngIf
now throws again if the bound value changes during change detection.- Fixed a bug where the router didn't work on a root path in IE11.
- Fixed generated code that caused a strong-mode warning on
AppView<...>
. - Fixed a bug where DDC didn't work properly with "pure"
Pipe
s. - Some simple types are now propagated to the generated
.template.dart
file. - When setting up a new
NgControl
,valueAccessor
no longer can throw an NPE - Re-enabled
strong-mode
analysis within the project, and fixed some errors.
Refactoring #
- We now use the formal
<T>
generic type syntax for methods, not/*<T>*/
. - Removed
NgZoneImpl
, all the code exists inNgZone
now. - We now generate specific code for view and content children (faster).
- Projectable nodes now use the visitor pattern in
AppView
. - In generated
.template.dart
change detected primitives are typed. - Moved
renderType
as a static class member in generated code.
2.2.0 #
API changes #
- Breaking changes
- Using
@ViewQuery|Children|Content|
in a constructor is no longer valid. This caused significant extra code to need to be generated for a case that is relatively rare. Code can safely be moved into a setter in most cases.
- Using
BEFORE ```dart class MyComponent { QueryList
MyComponent(@ContentChildren(ChildComponent) this._childComponents); } ```
AFTER ```dart class MyComponent { QueryList
@ContentChildren(ChildComponent) set childComponents(QueryList
Bug fixes #
- Importing
angular2/reflection.dart
now works properly.
2.1.1 #
API changes #
- Introduced
angular2/reflection.dart
as canonical way to opt-in to mirrors. In 2.2.0 it will be considered deprecated to enable runtime reflection by any other means.
2.1.0 #
API changes #
- Breaking changes
NgControlStatus
no longer included inCOMMON_DIRECTIVES
and inFORM_DIRECTIVES
. Needs to be manually included in your bootstrap or migrated off of
- Deprecations
- Using
@Query
in a component constructor; move to field-level Renderer
: Usedart:html
directlyNgControlStatus
: A form control should set class they are interested inNgPlural
: Was never formally supported in Angular Dart. Recommend usingpackage:intl
with getters on your@Component
pointing to anIntl.message
call until we have formal template support (planned)ObservableListDiff
: Not properly implemented, will re-introduce later
- Using
- Removed support for
InjectorModule
- was never formally supported
Bug fixes and other changes #
- Documentation fixes and cleanups across the codebase
- Code size and runtime performance improvements across the codebase
- More reduction of STRONG_MODE exceptions in the compiler
- Removed
InjectorModule
code (from TS-transpiler era) - Fixed a bug with
ExceptionHandler
not being called during change detection - Fixed a bug where controls were not marked dirty when an error was set
2.0.0 Release #
API changes #
- Implemented NgTestBed to improve test infrastructure goo.gl/NAXXlN.
- Removed Metadata classes used for angular annotations.
- Added ComponentState to provide push change detection with better ergonomics and code generation.
- ViewContainerRef.createEmbeddedView index parameter removed instead introduced insertEmbeddedView.
- Added support for minimal code generation when user explicitly marks component with preserveWhitespace:false.
Bug fixes and other changes #
- Improved ngFor performance.
- Improved shared style host performance.
- Improved @ViewChild/@ViewChildren performance.
- Code and documentation cleanups.
- Strong mode fixes.
2.0.0-beta.22 #
API changes #
- POTENTIALLY BREAKING Observable features new use the new
observable
package, instead ofobserve
. - Removed
Renderer.createViewRoot
.
Bug fixes and other changes #
- Improved compiler errors.
- Fixes to reduce code size.
- Support the latest
pkg/build
. - Now require Dart SDK 1.19 at a minimum.
- Added
.analysis_options
to enforce a number of style rules.
2.0.0-beta.21 #
Our push towards better performance has started showing results in this release. This update provides 5-10% speedup in components. >20% reduction in Dart code size emitted from compiler.
API changes #
- Added support for '??' operator in template compiler.
- Removed unused animation directives to create more Darty/compile time version.
- Removed unused i18n pipes to prepare for dart:intl based solution.
- Language facades removed (isPresent, isBlank, getMapKey, normalizeBool, DateWrapper, RegExpWrapper, StringWrapper, NumberWrapper, Math facades, SetWrapper, ListWrapper, MapWrapper, StringMapWrapper, ObservableWrapper, TimerWrapper).
- Deprecated unused ROUTER_LINK_DSL_TRANSFORM.
- Refactor(element.dart) is now app_element.dart.
- AppView moved to app_view. DebugAppView moved to debug/debug_app_view.dart.
- The deprecated injection Binding and bind have been removed.
- Remove global events and disposables (instead of :window type targets, use dart APIs).
Bug fixes and other changes #
- Improved change detection performance.
- Improved error messages reported by template compiler.
- Optimized [class.x]="y" type bindings.
- Switched to js_util for browser_adapter to make angular CSP compliant.
- Started strongly typing element members in compiled template code.
- Cheatsheet and code docs updated.
- Router fixes
2.0.0-beta.20 #
API changes #
- Added ngBeforeSubmit event to ngForm API to allow better validation.
- Global events removed from event binding syntax (dart:html APIs provide better alternative).
Bug fixes and other changes #
- Reduced template code size.
- Cleanup of facades.
- Class Documentation updates.
- ngForm submit changed to sync.
- Removed disposables in generated template code.
2.0.0-beta.19 #
API changes #
- Remove existing implementation of web workers, to be replaced in the future with Dart import override for dart:html.
Bug fixes and other changes #
- Remove throwOnChanges parameter from all change detection calls in generated template.dart.
- Unused and empty assertArrayOfStrings API removed.
- Update BrowserDomAdapter from dart:js to package:js.
- Reset change detection to guard against template exception.
- Delete unused files.
- Clean up the NgIf directive and remove facades.
- Enabled Travis-CI.
- Update tests that should only run in the browser.
- Add angular transformer which deletes any pre-existing generated files from Bazel.
- Add DI library entrypoint to support VM tests.
- Fix the Math facade (improper annotation): @Deprecated(description).
- Clean up animation classes.
- Remove library name declarations.
- Run dart formatter on all code.
- Remove unused testing/lang_utils.dart.
2.0.0-beta.18 #
This is the first release of Angular 2 for Dart that is written directly in Dart, instead of generated from TypeScript.
API changes #
The Provider
constructor and provide()
function are now more intuitive when
they have a single argument.
Before, const Provider(Foo)
or provide(Foo)
would provide a null
object.
To provide a Foo
object, you had to use const Provider(Foo, useClass:Foo)
or
provide(Foo, useClass:Foo)
. Now you can omit the useClass:Foo
. Either of the
following provides a Foo
instance:
const Provider(Foo)
// or
provide(Foo)
If you want the old behavior, change your code to specify useValue
:
const Provider(Foo, useValue: null)
// or
provide(Foo, useValue: null)
Known issues #
- Some types of dependency injection don't work. (https://github.com/dart-lang/angular2/issues/10)
Bug fixes and other changes #
- Fix lower bound of pkg/build dependency.
- Fixes for dependency upper bounds: build and protobuf.
- Bumping min version of pkg/intl and pkg version.
- Remove redundant declaration of
el
. - Security Update. Secure Contextual Escaping Implementation.
- Fix Intl number formatting.
- Enforce strong mode for angular2.dart.
- Updating README and CONTRIBUTING.md for first release.
- Enforce dartfmt for dart/angular2.
- Add //dart/angular2/build_defs with default resolved_identifiers.
- Import cleanup.
- Annotate browser-only tests.
- Include .gitignore in files sent to GitHub.
- Fix a strong mode error in angular2 (strong mode type inference miss).
- Add compiler tests.
- Delete unused libraries in lib/src.
- Updated pubspec: authors, description, homepage.
- Angular strong mode fixes for DDC support.
- Add _LoggerConsole implementation of Console for the TemplateCompiler.
- Mark Binding and bind() as deprecated. Replaced by Provider and provide().