Skip to content

Commit fceeda1

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

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
@@ -600,7 +600,7 @@ To ensure elements behave as expected and perform well, try to follow these best
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

603-
* In general user property settings should not be changed, but if you want to do so, define a property setter. Setting `useDefault` will only reset the property value to the default when the corresponding attribute is removed.
603+
* The property decorator does not alter any values assigned to the reactive property, which is considered a best practice for custom accessors. Sometimes native elements restrict properties to certain valid values, for instance, and if an invalid value is assigned to a property, the property will be set to a default instead. `useDefault: true` does not do this - it only restores the default when the attribute is removed. If you'd like to alter the property value on property assignments, define and decorate a custom property setter.
604604

605605
## Custom property accessors {#accessors}
606606

0 commit comments

Comments
 (0)