parent
089bfdf95f
commit
8ca208ff59
|
@ -1,221 +0,0 @@
|
||||||
# Change Log
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The Angular documentation is a living document with continuous improvements.
|
|
||||||
This log calls attention to recent significant changes.
|
|
||||||
|
|
||||||
## Updated to Angular 4.0. Documentation for Angular 2.x can be found at [v2.angular.io](https://v2.angular.io).
|
|
||||||
|
|
||||||
## All mention of moduleId removed. "Component relative paths" guide deleted (2017-03-13)
|
|
||||||
We added a new SystemJS plugin (systemjs-angular-loader.js) to our recommended SystemJS configuration.
|
|
||||||
This plugin dynamically converts "component-relative" paths in templateUrl and styleUrls to "absolute paths" for you.
|
|
||||||
|
|
||||||
We strongly encourage you to only write component-relative paths.
|
|
||||||
That is the only form of URL discussed in these docs. You no longer need to write @Component({ moduleId: module.id }), nor should you.
|
|
||||||
|
|
||||||
## NEW: Downloadable examples for each guide (2017-02-28)
|
|
||||||
Now you can download the sample code for any guide and run it locally.
|
|
||||||
Look for the new download links next to the "live example" links.
|
|
||||||
|
|
||||||
## Template Syntax/Structural Directives: refreshed (2017-02-06)
|
|
||||||
The [_Template-Syntax_](guide/template-syntax) and [_Structural Directives_](guide/structural-directives)
|
|
||||||
guides were significantly revised for clarity, accuracy, and current recommended practices.
|
|
||||||
Discusses `<ng-container>`.
|
|
||||||
Revised samples are more clear and cover all topics discussed.
|
|
||||||
|
|
||||||
## NEW: Samples re-structured with `src/` folder (2017-02-02)
|
|
||||||
All documentation samples have been realigned with the default folder structure of the Angular CLI.
|
|
||||||
That's a step along the road to basing the sample in the Angular CLI.
|
|
||||||
But it's also good in its own right.
|
|
||||||
It helps clearly separate app code from setup and configuration files.
|
|
||||||
|
|
||||||
All samples now have a `src/` folder at the project root.
|
|
||||||
The former `app/` folder moves under `src/`.
|
|
||||||
Read about moving your existing project to this structure in
|
|
||||||
<a href="https://github.com/angular/quickstart#updating-to-a-newer-version-of-the-quickstart-repo" target="Migrating samples/quickstart app to the src folder">
|
|
||||||
the QuickStart repo update instructions</a>.
|
|
||||||
|
|
||||||
Notably:
|
|
||||||
|
|
||||||
* `app/main.ts` moved to `src/main.ts`.
|
|
||||||
* `app/` moved to `src/app/`.
|
|
||||||
* `index.html`, `styles.css` and `tsconfig.json` moved inside `src/`.
|
|
||||||
* `systemjs.config.js` now imports `main.js` instead of `app`.
|
|
||||||
* Added `lite-server` configuration (`bs-config.json`) to serve `src/`.
|
|
||||||
|
|
||||||
## NEW: Reactive Forms guide (2017-01-31)
|
|
||||||
The new [**Reactive Forms**](guide/reactive-forms) guide explains how and why to build a "reactive form".
|
|
||||||
"Reactive Forms" are the code-based counterpart to the declarative "Template Driven" forms approach
|
|
||||||
introduced in the [Forms](guide/forms) guide.
|
|
||||||
Check it out before you decide how to add forms to your app.
|
|
||||||
Remember also that you can use both techniques in the same app,
|
|
||||||
choosing the approach that best fits each scenario.
|
|
||||||
|
|
||||||
## NEW: Deployment guide (2017-01-30)
|
|
||||||
|
|
||||||
The new [Deployment](guide/deployment) guide describes techniques for putting your application on a server.
|
|
||||||
It includes important advice on optimizing for production.
|
|
||||||
|
|
||||||
## Hierarchical Dependency Injection: refreshed (2017-01-13)
|
|
||||||
|
|
||||||
[Hierarchical Dependency Injection](guide/hierarchical-dependency-injection) guide is significantly revised.
|
|
||||||
Closes issue #3086.
|
|
||||||
Revised samples are clearer and cover all topics discussed.
|
|
||||||
|
|
||||||
## Miscellaneous (2017-01-05)
|
|
||||||
|
|
||||||
* [Setup](guide/setup) guide:
|
|
||||||
added (optional) instructions on how to remove _non-essential_ files.
|
|
||||||
* No longer consolidate RxJS operator imports in `rxjs-extensions` file; each file should import what it needs.
|
|
||||||
* All samples prepend template/style URLs with `./` as a best practice.
|
|
||||||
* [Style Guide](guide/styleguide): copy edits and revised rules.
|
|
||||||
|
|
||||||
## Router: more detail (2016-12-21)
|
|
||||||
|
|
||||||
Added more information to the [Router](guide/router) guide
|
|
||||||
including sections named outlets, wildcard routes, and preload strategies.
|
|
||||||
|
|
||||||
## HTTP: how to set default request headers (and other request options) (2016-12-14)
|
|
||||||
|
|
||||||
Added section on how to set default request headers (and other request options) to
|
|
||||||
HTTP guide.
|
|
||||||
|
|
||||||
## Testing: added component test plunkers (2016-12-02)
|
|
||||||
|
|
||||||
Added two plunkers that each test _one simple component_ so you can write a component test plunker of your own: <live-example name="setup" plnkr="quickstart-specs">one</live-example> for the QuickStart seed's `AppComponent` and <live-example name="testing" plnkr="banner-specs">another</live-example> for the Testing guide's `BannerComponent`.
|
|
||||||
Linked to these plunkers in "Testing" and "Setup anatomy" guides.
|
|
||||||
|
|
||||||
## Internationalization: pluralization and _select_ (2016-11-30)
|
|
||||||
|
|
||||||
The [Internationalization (i18n)](guide/i18n) guide explains how to handle pluralization and
|
|
||||||
translation of alternative texts with `select`.
|
|
||||||
The sample demonstrates these features too.
|
|
||||||
|
|
||||||
## Testing: karma file updates (2016-11-30)
|
|
||||||
|
|
||||||
* `karma.config` + `karma-test-shim` can handle multiple spec source paths;
|
|
||||||
see quickstart issue: [angular/quickstart#294](https://github.com/angular/quickstart/issues/294).
|
|
||||||
* Displays Jasmine Runner output in the karma-launched browser.
|
|
||||||
|
|
||||||
## QuickStart Rewrite (2016-11-18)
|
|
||||||
|
|
||||||
The QuickStart is completely rewritten so that it actually is quick.
|
|
||||||
It references a minimal "Hello Angular" app running in Plunker.
|
|
||||||
The new [Setup](guide/setup) page tells you how to install a local development environment
|
|
||||||
by downloading (or cloning) the QuickStart github repository.
|
|
||||||
You are no longer asked to copy-and-paste code into setup files that were not explained anyway.
|
|
||||||
|
|
||||||
## Sync with Angular v.2.2.0 (2016-11-14)
|
|
||||||
|
|
||||||
Docs and code samples updated and tested with Angular v.2.2.0.
|
|
||||||
|
|
||||||
## UPDATE: NgUpgrade Guide for the AOT friendly _upgrade/static_ module (2016-11-14)
|
|
||||||
|
|
||||||
The updated [NgUpgrade Guide](guide/upgrade) guide covers the
|
|
||||||
new AOT friendly `upgrade/static` module
|
|
||||||
released in v.2.2.0, which is the recommended
|
|
||||||
facility for migrating from AngularJS to Angular.
|
|
||||||
The documentation for the version prior to v.2.2.0 has been removed.
|
|
||||||
|
|
||||||
## ES6 described in "TypeScript to JavaScript" (2016-11-14)
|
|
||||||
|
|
||||||
The updated TypeScript to JavaScript guide explains how to write apps in ES6/7
|
|
||||||
by translating the common idioms in the TypeScript documentation examples
|
|
||||||
(and elsewhere on the web) to ES6/7 and ES5.
|
|
||||||
|
|
||||||
This was [removed in August 2017](https://github.com/angular/angular/pull/18694) but can still be
|
|
||||||
viewed in the [v2 documentation](https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html).
|
|
||||||
|
|
||||||
## Sync with Angular v.2.1.1 (2016-10-21)
|
|
||||||
|
|
||||||
Docs and code samples updated and tested with Angular v.2.1.1.
|
|
||||||
|
|
||||||
## npm _@types_ packages replace _typings_ (2016-10-20)
|
|
||||||
|
|
||||||
Documentation samples now get TypeScript type information for 3rd party libraries
|
|
||||||
from npm `@types` packages rather than with the _typings_ tooling.
|
|
||||||
The `typings.json` file is gone.
|
|
||||||
|
|
||||||
The [AngularJS Upgrade](guide/upgrade) guide reflects this change.
|
|
||||||
The `package.json` installs `@types/angular` and several `@types/angular-...`
|
|
||||||
packages in support of upgrade; these are not needed for pure Angular development.
|
|
||||||
|
|
||||||
## "Template Syntax" explains two-way data binding syntax (2016-10-20)
|
|
||||||
|
|
||||||
Demonstrates how to two-way data bind to a custom Angular component and
|
|
||||||
re-explains `[(ngModel)]` in terms of the basic `[()]` syntax.
|
|
||||||
|
|
||||||
## BREAKING CHANGE: `in-memory-web-api` (v.0.1.11) delivered as esm umd (2016-10-19)
|
|
||||||
|
|
||||||
This change supports ES6 developers and aligns better with typical Angular libraries.
|
|
||||||
It does not affect the module's API but it does affect how you load and import it.
|
|
||||||
See the <a href="https://github.com/angular/in-memory-web-api/blob/master/CHANGELOG.md#0113-2016-10-20">change note</a>
|
|
||||||
in the `in-memory-web-api` repo.
|
|
||||||
|
|
||||||
## "Router" _preload_ syntax and _:enter_/_:leave_ animations (2016-10-19)
|
|
||||||
|
|
||||||
The router can lazily _preload_ modules _after_ the app starts and
|
|
||||||
_before_ the user navigates to them for improved perceived performance.
|
|
||||||
|
|
||||||
New `:enter` and `:leave` aliases make animation more natural.
|
|
||||||
|
|
||||||
## Sync with Angular v.2.1.0 (2016-10-12)
|
|
||||||
|
|
||||||
Docs and code samples updated and tested with Angular v.2.1.0.
|
|
||||||
|
|
||||||
## NEW "Ahead of time (AOT) Compilation" guide (2016-10-11)
|
|
||||||
|
|
||||||
The NEW [Ahead of time (AOT) Compilation](guide/aot-compiler) guide
|
|
||||||
explains what AOT compilation is and why you'd want it.
|
|
||||||
It demonstrates the basics with a QuickStart app
|
|
||||||
followed by the more advanced considerations of compiling and bundling the Tour of Heroes.
|
|
||||||
|
|
||||||
## Sync with Angular v.2.0.2 (2016-10-6)
|
|
||||||
|
|
||||||
Docs and code samples updated and tested with Angular v.2.0.2.
|
|
||||||
|
|
||||||
## "Routing and Navigation" guide with the _Router Module_ (2016-10-5)
|
|
||||||
|
|
||||||
The [Routing and Navigation](guide/router) guide now locates route configuration
|
|
||||||
in a _Routing Module_.
|
|
||||||
The _Routing Module_ replaces the previous _routing object_ involving the `ModuleWithProviders`.
|
|
||||||
|
|
||||||
All guided samples with routing use the _Routing Module_ and prose content has been updated,
|
|
||||||
most conspicuously in the
|
|
||||||
[NgModule](guide/ngmodules) guide and [NgModule FAQ](guide/ngmodule-faq) guide.
|
|
||||||
|
|
||||||
## New "Internationalization" guide (2016-09-30)
|
|
||||||
|
|
||||||
Added a new [Internationalization (i18n)](guide/i18n) guide that shows how
|
|
||||||
to use Angular "i18n" facilities to translate template text into multiple languages.
|
|
||||||
|
|
||||||
## "angular-in-memory-web-api" package rename (2016-09-27)
|
|
||||||
|
|
||||||
Many samples use the `angular-in-memory-web-api` to simulate a remote server.
|
|
||||||
This library is also useful to you during early development before you have a server to talk to.
|
|
||||||
|
|
||||||
The package name was changed from "angular2-in-memory-web-api" which is still frozen-in-time on npm.
|
|
||||||
The new "angular-in-memory-web-api" has new features.
|
|
||||||
<a href="https://github.com/angular/in-memory-web-api/blob/master/README.md">Read about them on github</a>.
|
|
||||||
|
|
||||||
## "Style Guide" with _NgModules_ (2016-09-27)
|
|
||||||
|
|
||||||
[StyleGuide](guide/styleguide) explains recommended conventions for NgModules.
|
|
||||||
Barrels now are far less useful and have been removed from the style guide;
|
|
||||||
they remain valuable but are not a matter of Angular style.
|
|
||||||
Also relaxed the rule that discouraged use of the `@Component.host` property.
|
|
||||||
|
|
||||||
## _moduleId: module.id_ everywhere (2016-09-25)
|
|
||||||
|
|
||||||
Sample components that get their templates or styles with `templateUrl` or `styleUrls`
|
|
||||||
have been converted to _module-relative_ URLs.
|
|
||||||
Added the `moduleId: module.id` property-and-value to their `@Component` metadata.
|
|
||||||
|
|
||||||
This change is a requirement for compilation with AOT compiler when the app loads
|
|
||||||
modules with SystemJS as the samples currently do.
|
|
||||||
|
|
||||||
## "Lifecycle Hooks" guide simplified (2016-09-24)
|
|
||||||
|
|
||||||
The [Lifecycle Hooks](guide/lifecycle-hooks) guide is shorter, simpler, and
|
|
||||||
draws more attention to the order in which Angular calls the hooks.
|
|
|
@ -708,12 +708,6 @@
|
||||||
"title": "API",
|
"title": "API",
|
||||||
"tooltip": "Details of the Angular packages, classes, interfaces, and other types.",
|
"tooltip": "Details of the Angular packages, classes, interfaces, and other types.",
|
||||||
"url": "api"
|
"url": "api"
|
||||||
},
|
|
||||||
{
|
|
||||||
"url": "guide/change-log",
|
|
||||||
"title": "Change Log",
|
|
||||||
"tooltip": "Angular Documentation Change Log",
|
|
||||||
"hidden": true
|
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
"Footer": [
|
"Footer": [
|
||||||
|
|
|
@ -27,6 +27,7 @@
|
||||||
{"type": 301, "source": "/guide/service-worker-configref", "destination": "/guide/service-worker-config"},
|
{"type": 301, "source": "/guide/service-worker-configref", "destination": "/guide/service-worker-config"},
|
||||||
{"type": 301, "source": "/guide/webpack", "destination": "https://v5.angular.io/guide/webpack"},
|
{"type": 301, "source": "/guide/webpack", "destination": "https://v5.angular.io/guide/webpack"},
|
||||||
{"type": 301, "source": "/guide/setup-systemjs-anatomy", "destination": "/guide/file-structure"},
|
{"type": 301, "source": "/guide/setup-systemjs-anatomy", "destination": "/guide/file-structure"},
|
||||||
|
{"type": 301, "source": "/guide/change-log", "destination": "https://github.com/angular/angular/blob/master/CHANGELOG.md"},
|
||||||
|
|
||||||
// some top level guide pages on old site were moved below the guide folder
|
// some top level guide pages on old site were moved below the guide folder
|
||||||
{"type": 301, "source": "/styleguide", "destination": "/guide/styleguide"},
|
{"type": 301, "source": "/styleguide", "destination": "/guide/styleguide"},
|
||||||
|
@ -39,7 +40,7 @@
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook", "destination": "/docs"},
|
{"type": 301, "source": "/docs/*/latest/cookbook", "destination": "/docs"},
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook/", "destination": "/docs"},
|
{"type": 301, "source": "/docs/*/latest/cookbook/", "destination": "/docs"},
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook/index.html", "destination": "/docs"},
|
{"type": 301, "source": "/docs/*/latest/cookbook/index.html", "destination": "/docs"},
|
||||||
{"type": 301, "source": "/**/cookbook/ts-to-js*", "destination": "https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14"},
|
{"type": 301, "source": "/**/cookbook/ts-to-js*", "destination": "https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html"},
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook/a1-a2-quick-reference.html", "destination": "/guide/ajs-quick-reference"},
|
{"type": 301, "source": "/docs/*/latest/cookbook/a1-a2-quick-reference.html", "destination": "/guide/ajs-quick-reference"},
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook/component-communication.html", "destination": "/guide/component-interaction"},
|
{"type": 301, "source": "/docs/*/latest/cookbook/component-communication.html", "destination": "/guide/component-interaction"},
|
||||||
{"type": 301, "source": "/docs/*/latest/cookbook/dependency-injection.html", "destination": "/guide/dependency-injection-in-action"},
|
{"type": 301, "source": "/docs/*/latest/cookbook/dependency-injection.html", "destination": "/guide/dependency-injection-in-action"},
|
||||||
|
|
|
@ -91,6 +91,7 @@
|
||||||
"!/api/testing/**",
|
"!/api/testing/**",
|
||||||
"!/docs/?*",
|
"!/docs/?*",
|
||||||
"!/docs/*/**",
|
"!/docs/*/**",
|
||||||
|
"!/guide/change-log",
|
||||||
"!/guide/cli-quickstart",
|
"!/guide/cli-quickstart",
|
||||||
"!/guide/cli-quickstart.html",
|
"!/guide/cli-quickstart.html",
|
||||||
"!/guide/cli-quickstart/",
|
"!/guide/cli-quickstart/",
|
||||||
|
|
|
@ -145,7 +145,7 @@
|
||||||
/docs/js/latest/api/upgrade/index/UpgradeAdapter-class.html /api/upgrade/UpgradeAdapter
|
/docs/js/latest/api/upgrade/index/UpgradeAdapter-class.html /api/upgrade/UpgradeAdapter
|
||||||
/docs/js/latest/api/upgrade/static/UpgradeModule-class /api/upgrade/static/UpgradeModule
|
/docs/js/latest/api/upgrade/static/UpgradeModule-class /api/upgrade/static/UpgradeModule
|
||||||
/docs/js/latest/api/upgrade/static/UpgradeModule-class.html /api/upgrade/static/UpgradeModule
|
/docs/js/latest/api/upgrade/static/UpgradeModule-class.html /api/upgrade/static/UpgradeModule
|
||||||
/docs/js/latest/cookbook/ts-to-js.html https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14
|
/docs/js/latest/cookbook/ts-to-js.html https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html
|
||||||
/docs/js/latest/glossary /guide/glossary
|
/docs/js/latest/glossary /guide/glossary
|
||||||
/docs/js/latest/guide/ /docs
|
/docs/js/latest/guide/ /docs
|
||||||
/docs/js/latest/guide/lifecycle-hooks /guide/lifecycle-hooks
|
/docs/js/latest/guide/lifecycle-hooks /guide/lifecycle-hooks
|
||||||
|
@ -170,7 +170,7 @@
|
||||||
/docs/ts/latest/api/http/testing/index/MockConnection-class.html /api/http/testing/MockConnection
|
/docs/ts/latest/api/http/testing/index/MockConnection-class.html /api/http/testing/MockConnection
|
||||||
/docs/ts/latest/api/platform-browser-dynamic/index/workerAppDynamicPlatform-let.html /api/platform-browser-dynamic/workerAppDynamicPlatform
|
/docs/ts/latest/api/platform-browser-dynamic/index/workerAppDynamicPlatform-let.html /api/platform-browser-dynamic/workerAppDynamicPlatform
|
||||||
/docs/ts/latest/api/testing/fakeAsync-function.html /api/core/testing/fakeAsync
|
/docs/ts/latest/api/testing/fakeAsync-function.html /api/core/testing/fakeAsync
|
||||||
/docs/ts/latest/cookbook/ts-to-js.html https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14
|
/docs/ts/latest/cookbook/ts-to-js.html https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html
|
||||||
/guide/cli-quickstart /guide/quickstart
|
/guide/cli-quickstart /guide/quickstart
|
||||||
/guide/learning-angular /guide/quickstart
|
/guide/learning-angular /guide/quickstart
|
||||||
/guide/learning-angular.html /guide/quickstart
|
/guide/learning-angular.html /guide/quickstart
|
||||||
|
|
Loading…
Reference in New Issue