Skip to content

Commit

Permalink
few tweaks to UTSL section
Browse files Browse the repository at this point in the history
  • Loading branch information
natevw committed Feb 14, 2025
1 parent 83a2abe commit 5187be0
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion content/en/guide/v10/vdom-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,8 @@ Preact core includes many other special property fixups including for:
* various idiosyncracies of the [SVG DOM](https://www.w3.org/TR/SVG11/svgdom.html)
* … etc.

The list above is not intended to be comprehensive. There are many nuances both for specific bugfixes and that simply fall out of the how the internals have gotten implemented. (For example of one such edge case, currently if you assign your own property value to a raw DOM node object in an uncontrolled way e.g. `spanRef.current["data-myvar"] = null` it may then interfere w/Preact's fallback attribute setting of `<span ref={spanRef} data-myvar="controlled-value" />`.)
The list above is not intended to be comprehensive.

There are many nuances both for specific bugfixes/workarounds/compatibility concessions, and other nuances that simply fall out of the how the internals have gotten implemented. (For example of one such edge case, currently if you assign your own property value to a raw DOM node object in an uncontrolled way e.g. `spanRef.current["data-myvar"] = null` it may then interfere w/Preact's fallback attribute setting of `<span ref={spanRef} data-myvar="controlled-value" />`.)

Your best guide for advanced details would be to refer to the [`diff/props.js` source code](https://github.com/preactjs/preact/blob/main/src/diff/props.js), as well as the overarching diffing algorithm itself ([e.g.](https://github.com/preactjs/preact/blob/face9247724db0a74b764316c4486f384b89cfed/src/diff/index.js#L554-L576)) corresponding to the specific version of Preact you are using.

0 comments on commit 5187be0

Please sign in to comment.