5b31a0a294
This is part of a re-factor of template syntax and structure. The first phase breaks out template syntax into multiple documents. The second phase will be a rewrite of each doc. Specifically, this PR does the following: - Breaks sections of the current template syntax document each into their own page. - Corrects the links to and from these new pages. - Adds template syntax subsection to the left side NAV which contains all the new pages. - Adds the new files to pullapprove. PR Close #36954
3.0 KiB
Two-way binding [(...)]
Two-way binding gives your app a way to share data between a component class and its template.
See the for a working example containing the code snippets in this guide.
Basics of two-way binding
Two-way binding does two things:
- Sets a specific element property.
- Listens for an element change event.
Angular offers a special two-way data binding syntax for this purpose, [()].
The [()] syntax combines the brackets
of property binding, [], with the parentheses of event binding, ().
Visualize a banana in a box to remember that the parentheses go inside the brackets.
The [()] syntax is easy to demonstrate when the element has a settable
property called x and a corresponding event named xChange.
Here's a SizerComponent that fits this pattern.
It has a size value property and a companion sizeChange event:
The initial size is an input value from a property binding.
Clicking the buttons increases or decreases the size, within
min/max value constraints,
and then raises, or emits, the sizeChange event with the adjusted size.
Here's an example in which the AppComponent.fontSizePx is two-way bound to the SizerComponent:
The AppComponent.fontSizePx establishes the initial SizerComponent.size value.
Clicking the buttons updates the AppComponent.fontSizePx via the two-way binding.
The revised AppComponent.fontSizePx value flows through to the style binding,
making the displayed text bigger or smaller.
The two-way binding syntax is really just syntactic sugar for a property binding and an event binding.
Angular desugars the SizerComponent binding into this:
The $event variable contains the payload of the SizerComponent.sizeChange event.
Angular assigns the $event value to the AppComponent.fontSizePx when the user clicks the buttons.
Two-way binding in forms
The two-way binding syntax is a great convenience compared to
separate property and event bindings. It would be convenient to
use two-way binding with HTML form elements like <input> and
<select>. However, no native HTML element follows the x
value and xChange event pattern.
For more on how to use two-way binding in forms, see Angular NgModel.