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

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 f012494e1e
commit 9bd5b4ad9c
2 changed files with 4 additions and 0 deletions
@@ -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
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