From 2dbb0bc885b9559e1e8c1e200e34c810af3d1bfb Mon Sep 17 00:00:00 2001 From: Noitidart Date: Wed, 22 Jul 2026 12:37:33 -0700 Subject: [PATCH] docs: note that TextInput textAlign does not flip in RTL unlike Text The shared textAlign docs (text-style-props.md) did not mention that its behavior diverges between and in RTL mode. On , textAlign: 'left' behaves as logical start (aligns right in RTL), but on it is physical and stays left on both iOS and Android. This adds a note documenting the divergence and the direction-aware workaround, linking to facebook/react-native#45255. PRs #57007 and #57201 attempted to add start/end support but were closed without merge, so documenting the existing behavior is the pragmatic outcome. --- docs/text-style-props.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/text-style-props.md b/docs/text-style-props.md index 4842a950147..4125a6ec022 100644 --- a/docs/text-style-props.md +++ b/docs/text-style-props.md @@ -84,6 +84,8 @@ Specifies font weight. The values 'normal' and 'bold' are supported for most fon Specifies text alignment. The value 'justify' is only supported on iOS and fallbacks to `left` on Android. +> **_Note:_** Unlike [``](text.md), `TextInput` treats `left` and `right` as physical values that do not flip in RTL mode. On ``, `textAlign: 'left'` behaves as logical `start` (aligns right in RTL), but on `TextInput` it always aligns left. For direction-aware alignment on `TextInput`, use `I18nManager.isRTL ? 'right' : 'left'`. See [#45255](https://github.com/facebook/react-native/issues/45255) for background. + | Type | Required | | -------------------------------------------------- | -------- | | enum('auto', 'left', 'right', 'center', 'justify') | No |