Skip to content

Conversation

@andrewdacenko
Copy link
Contributor

Summary:
Adds the core DOM implementation for getClientRects() which returns the
bounding rectangles of all text fragments belonging to a TextShadowNode
within its parent ParagraphShadowNode.

This is useful for:

  • Getting the visual boundaries of nested <Text> components within a paragraph
  • Accessibility tools that need per-line text boundaries
  • Layout inspection for text that spans multiple lines

On Android, the implementation uses the platform's TextLayoutManager to get
accurate fragment rects. On other platforms, a simplified fallback returns
the paragraph's frame for each fragment.

Differential Revision: D91087222

Summary:
When `getBoundingClientRect()` is called on a nested `<Text>` component
(TextShadowNode), return the parent paragraph's bounding rect instead of
empty/invalid metrics.

TextShadowNode is a virtual node that doesn't have its own layout metrics.
This matches web behavior where inline elements return their container's
rect. Use `getClientRects()` (added in a follow-up diff) to get the
individual fragment rects for text that spans multiple lines.

Differential Revision: D91087220
Summary:
Adds Android-specific implementation for measuring bounding rectangles of
text fragments that belong to a specific React tag. This enables getting
the visual boundaries of nested `<Text>` components within a paragraph.

The implementation provides two methods:
1. `getFragmentRectsForReactTag` - Uses PreparedLayout for efficient measurement
   when the enablePreparedTextLayout feature flag is enabled
2. `getFragmentRectsFromAttributedString` - Fallback that creates a layout
   on-demand when PreparedLayout is not available

Key features:
- Handles multi-line text fragments by returning a rect for each line
- Correctly handles RTL text direction
- Converts coordinates between pixels and DIPs

These methods are used by the DOM getClientRects() API to provide accurate
text fragment boundaries for accessibility and layout inspection.

Differential Revision: D91087221
Summary:
Adds the core DOM implementation for `getClientRects()` which returns the
bounding rectangles of all text fragments belonging to a TextShadowNode
within its parent ParagraphShadowNode.

This is useful for:
- Getting the visual boundaries of nested `<Text>` components within a paragraph
- Accessibility tools that need per-line text boundaries
- Layout inspection for text that spans multiple lines

On Android, the implementation uses the platform's TextLayoutManager to get
accurate fragment rects. On other platforms, a simplified fallback returns
the paragraph's frame for each fragment.

Differential Revision: D91087222
@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jan 22, 2026
@meta-codesync
Copy link

meta-codesync bot commented Jan 22, 2026

@andrewdacenko has exported this pull request. If you are a Meta employee, you can view the originating Diff in D91087222.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported meta-exported p: Facebook Partner: Facebook Partner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants