Deliver web apps with confidence 🚀
Find a file
Kristiyan Kostadinov 05a16b973d refactor(compiler): add support for advanced tracking expressions (#51618)
These changes build on top of #51514 to add support for advanced expressions inside the `track` parameter of `for` loop blocks. There are two different outputs that the compiler can generate:

1. If the tracking function only references the item or `$index`, the compiler generates a pure arrow function as a constant references in the `repeaterCreate` instruction.
2. If the tracking function has references to properties outside of the `for` loop block, the compiler will rewrite those references to go through `this` and generate a function declaration. The runtime will `bind` the declaration to the current component instance so that the rewritten `this` references are resolved correctly.

Advanced tracking expression come with the following limitations to ensure the best possible performance:
1. They can only reference the item, `$index` and properties directly on the component instance. This means that there'll be an error when accessing this like local template variables and references. While we could get this to work, we would have to traverse the context tree at runtime which will degrade the performance of the loop, because it's a linear time operation that is performed on each comparison. Furthermore, allowing local references would require us re-evaluate the list when any one of them has changed.
2. Pipes aren't allowed inside the tracking function.
3. Object literals and pipes used inside the tracking expression will be recreated on each invocation.

PR Close #51618
2023-09-05 14:19:18 +00:00
.circleci build: migrate to node 18 (#51609) 2023-09-01 15:12:43 +00:00
.devcontainer build: use pin for devcontainer base image (#51556) 2023-08-29 18:38:55 +00:00
.github build: update actions/checkout digest to f43a0e5 (#51576) 2023-08-31 16:34:23 +00:00
.husky build: remove unnecessary husky gitignore file (#42870) 2021-07-19 17:31:55 -07:00
.ng-dev build: remove the webworker platform. (#50059) 2023-05-04 09:06:55 +02:00
.vscode build: update recommended launch vscode config to use proper bazel dist path (#47831) 2022-10-24 10:42:21 +02:00
.yarn build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
aio docs: add Connie Leung to GDE contributors list (#51476) 2023-09-05 14:16:35 +00:00
devtools feat(devtools): Display getters and setters in devtools property viewer (#49695) 2023-09-01 14:41:04 +00:00
docs docs: add MSYS2 to DEVELOPER.md (#51459) 2023-08-22 10:39:23 -07:00
goldens refactor(router): Add a state manager to manage router URL state (#48481) 2023-09-01 16:12:35 +00:00
integration build: update type TypeScript 5.2 final (#51503) 2023-08-28 17:02:30 +00:00
modules docs: add lang attribute in html files (#51269) 2023-08-21 16:33:43 -07:00
packages refactor(compiler): add support for advanced tracking expressions (#51618) 2023-09-05 14:19:18 +00:00
scripts build: avoid shallow fetch for benchmark comparison (#50851) 2023-06-26 13:37:38 -07:00
third_party build: create NodeJS ESM loader for supporting Bazel setup (#48521) 2022-12-19 19:50:40 +00:00
tools build: enable video recording for saucelabs bazel tests (#51533) 2023-08-30 19:44:45 +00:00
.bazelignore build: include bazel build file in aio playground code (#51485) 2023-08-23 14:44:03 -07:00
.bazelrc ci: migrate windows job to GHA (#51010) 2023-07-17 14:51:36 +00:00
.bazelversion build: update to bazel v5 for new runfiles API used in dev-infra (#45407) 2022-03-21 16:55:36 -07:00
.clang-format feat(tooling): Add a .clang-format for automated JavaScript formatting. 2015-04-02 08:44:34 -07:00
.editorconfig build: use https link to editorconfig.org in .editorconfig (#27664) 2018-12-18 09:30:09 -08:00
.gitattributes build: cleanup .gitattributes file and remove outdated CRLF attribute (#46513) 2022-06-28 13:38:27 -07:00
.gitignore docs: update of landing page and backup pages (#47047) 2022-12-09 16:04:34 -08:00
.gitmessage build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00
.mailmap build: add a Git .mailmap with my new name (#19550) 2017-10-09 14:35:30 -07:00
.npmrc build: rely on engines to prevent using npm for dependency install (#41477) 2021-04-07 12:05:01 -07:00
.nvmrc build: migrate to node 18 (#51609) 2023-09-01 15:12:43 +00:00
.prettierrc ci: use prettier to format yml files (#42136) 2021-05-19 11:20:20 -07:00
.pullapprove.yml docs(core): clarify InjectionToken usage (#51386) 2023-08-30 15:53:23 +00:00
.yarnrc build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
browser-providers.conf.d.ts build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
browser-providers.conf.js ci: enable Android 12 for tests on CI (#45926) 2022-05-09 11:26:10 -07:00
BUILD.bazel build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
CHANGELOG.md release: cut the v17.0.0-next.2 release 2023-08-30 11:27:05 -07:00
CHANGELOG_ARCHIVE.md docs: fix typos 2023-06-22 12:56:49 +02:00
CODE_OF_CONDUCT.md build: update CODE_OF_CONDUCT.md to match the content of angular/.github 2023-03-13 21:07:51 +00:00
CONTRIBUTING.md refactor: remove Angular Compatibility Compiler (ngcc) (#49101) 2023-02-16 16:01:17 -08:00
gulpfile.js build: remove the unused source-map-test (#46518) 2022-06-27 15:42:43 -07:00
karma-js.conf.js build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
LICENSE build: bump license year (#49984) 2023-04-25 09:29:16 -07:00
package.json build: migrate to node 18 (#51609) 2023-09-01 15:12:43 +00:00
packages.bzl docs: Add rxjs-interop and reactivity primitives APIs (#50066) 2023-05-01 07:53:47 -07:00
README.md docs: updated the i tag with the em tag (#50923) 2023-07-10 07:15:49 -07:00
renovate.json ci: update renovate.json (#49909) 2023-04-18 20:54:28 +00:00
SECURITY.md build: update SECURITY.md to match the content of angular/.github 2023-01-06 08:51:29 +00:00
tsconfig-tslint.json refactor(devtools): run ng-dev format on angular devtools files 2022-01-26 16:35:30 -05:00
tslint.json build: update lint path for @angular/build-tooling rules (#49266) 2023-02-28 11:56:28 -08:00
WORKSPACE build: migrate to node 18 (#51609) 2023-09-01 15:12:43 +00:00
yarn.bzl build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
yarn.lock build: lock file maintenance (#51628) 2023-09-01 20:44:06 +00:00
yarn.lock.readme.md build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00

Angular - The modern web developer's platform

angular-logo
Angular is a development platform for building mobile and desktop web applications
using TypeScript/JavaScript and other languages.

www.angular.io

Contributing Guidelines · Submit an Issue · Blog

CI status   Angular on npm   Discord conversation

InsightsSnapshot


Documentation

Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.

Advanced

Development Setup

Prerequisites

Setting Up a Project

Install the Angular CLI globally:

npm install -g @angular/cli

Create workspace:

ng new [PROJECT NAME]

Run the application:

cd [PROJECT NAME]
ng serve

Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.

Quickstart

Get started in 5 minutes.

Ecosystem

angular ecosystem logos

Changelog

Learn about the latest improvements.

Upgrading

Check out our upgrade guide to find out the best way to upgrade your project.

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

Code of Conduct

Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.

Community

Join the conversation and help the community.

Love Angular badge

Love Angular? Give our repo a star ⬆️.