Docs for new DOM APIs #4783
Open
Docs for new DOM APIs #4783
+317
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
✅ Deploy Preview for react-native ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for react-native ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
rubennorte
force-pushed
the
dom-apis
branch
3 times, most recently
from
9528808 to
55fe11c
Compare
rubennorte
requested review from
lunaleaps,
rickhanlonii,
cortinico and
cipolleschi
cortinico
approved these changes
Sep 10, 2025
docs/element-nodes.md
Outdated
| export default ViewWithRefs; | ||
| ``` | ||
|
|
||
| Note that some built-in components are only a container for other components (including native components). For example, `ScrollView` internally renders a native scroll view and a native view, which are accessible through the ref is provides using methods like `getNativeScrollRef()` and `getInnerViewRef()`. |
There was a problem hiding this comment.
which are accessible through the
refis provides using methods likegetNativeScrollRef()andgetInnerViewRef().
There is something wrong in this sentence
There was a problem hiding this comment.
through the
refit provides...
Will fix :)
|
|
||
| export default ViewWithRefs; | ||
| ``` | ||
|
|
There was a problem hiding this comment.
Can you put the box below inside an :::info box?
docs/element-nodes.md
Outdated
| - [`offsetWidth`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/offsetWidth) | ||
| - Methods | ||
| - [`blur()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur). | ||
| - ℹ️ This method was also [available](/docs/next/legacy/direct-manipulation#blur) in the legacy architecture. |
There was a problem hiding this comment.
Not sure this is worth mentioning anymore
docs/nodes.md
Outdated
| - [Text](/docs/next/text-nodes): text nodes represent raw text content on the tree (similar to [`Text`](https://developer.mozilla.org/en-US/docs/Web/API/Text) nodes on Web). They are not directly accessible via `refs`, but can be accessed using methods like [`childNodes`](https://developer.mozilla.org/en-US/docs/Web/API/Node/childNodes) on element refs. | ||
| - [Documents](/docs/next/document-nodes): document nodes represent a complete native view tree (similar to [`Document`](https://developer.mozilla.org/en-US/docs/Web/API/Document) nodes on Web). Like text nodes, they can only be accessed through other nodes, using properties like [`ownerDocument`](https://developer.mozilla.org/en-US/docs/Web/API/Node/ownerDocument). | ||
|
|
||
| As on Web, these nodes can be used to traverse the rendered UI tree, access layout information or execute imperative operations like `focus`. **Unlike on Web, they do not allow mutation** (e.g.: [`node.appendChild`](https://developer.mozilla.org/en-US/docs/Web/API/Node/appendChild)), as the tree contents are fully managed by the React renderer. |
There was a problem hiding this comment.
Unlike on Web, they do not allow mutation
Can you put this in a separate line + add it in a admonition box (like a :::warning one or so)?
There was a problem hiding this comment.
Yeah, but will use info instead of warning. We're already explaining the methods we support, and none of the mutating ones are even defined.
rubennorte
force-pushed
the
dom-apis
branch
from
8eb45e8 to
2db9536
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This adds the initial documentation for the new Web DOM APIs in React Native, that will be shipped as stable in React Native v0.82.