Skip to content

Commit 86dd12f

Browse files
Update packages/lit-dev-content/site/docs/v3/components/properties.md
Co-authored-by: Justin Fagnani <[email protected]>
1 parent 5b79229 commit 86dd12f

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

packages/lit-dev-content/site/docs/v3/components/properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -596,7 +596,7 @@ To ensure elements behave as expected and perform well, try to follow these best
596596

597597
* Attributes should generally be considered input to the element from its owner, rather than under control of the element itself, so reflecting properties to attributes should be done sparingly. Consider instead using the [`:state` pseudo selector](https://wicg.github.io/custom-state-pseudo-class/) and the [Accessibility Object Model](https://wicg.github.io/aom/spec/) where possible.
598598

599-
* Reflecting properties should typically also set `useDefault` since this helps match expected platform behavior.
599+
* Reflecting properties should typically also set `useDefault: true` since this keeps the element from spontaneously spawning attributes that the user didn't set, and helps match expected platform behavior.
600600

601601
* Reflecting properties of type object or array is not recommended. This can cause large objects to serialize to the DOM which can result in poor performance and consume excess memory when `useDefault` is used.
602602

0 commit comments

Comments
 (0)