Elgato_dark/angular
1
0
Fork 0
mirror of https://github.com/angular/angular synced 2026-05-24 09:28:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

docs: clarify that @for doesn't support break/continue (#59533)

Browse source 
We recently saw some confusion around this, so it's worth adding a
sentence to clarify

PR Close #59533
This commit is contained in:
Jeremy Elbourn 2025-01-15 08:23:12 -08:00 committed by kirjs
parent 3e31438d59
commit c38ea0767e
2 changed files with 4 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
adev/src/content/guide/templates/control-flow.md
View file

@ -50,6 +50,8 @@ A typical `@for` loop looks like:
}
```
Angular's `@for` block does not support flow-modifying statements like JavaScript's `continue` or `break`.
### Why is `track` in `@for` blocks important?
The `track` expression allows Angular to maintain a relationship between your data and the DOM nodes on the page. This allows Angular to optimize performance by executing the minimum necessary DOM operations when the data changes.

2
tools/manual_api_docs/blocks/for.md
View file

@ -19,6 +19,8 @@ but there are performance advantages of using a regular `Array`.
You can optionally include an `@empty` section immediately after the `@for` block content. The
content of the `@empty` block displays when there are no items.
Angular's `@for` block does not support flow-modifying statements like JavaScript's `continue` or `break`.
### `track` and objects identity
The value of the `track` expression determines a key used to associate array items with the views in