docs: reword when to use model inputs (#57648)

PR Close #57648
This commit is contained in:
Andrew Seguin 2024-09-03 14:28:04 -06:00 committed by Paul Gschwendtner
parent dc911c635a
commit 8f6560857c

View file

@ -130,9 +130,7 @@ through the template.
## When to use model inputs
Use model inputs in components that exist to modify a value based on user interaction.
Custom form controls, such as a date picker or combobox, should use model inputs for their
primary value.
Avoid using model inputs as a convenience to avoid introducing an additional class property for
containing local state.
Use model inputs when you want a component to support two-way binding. This is typically
appropriate when a component exists to modify a value based on user interaction. Most commonly,
custom form controls such as a date picker or combobox should use model inputs for their primary
value.