Skip to content

Document Android 14+ non-linear font scaling on getFontScale and allowFontScaling #5205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sbaiahmed1 wants to merge 1 commit into
base: main
Choose a base branch
from
+792 −780
Open

Document Android 14+ non-linear font scaling on getFontScale and allowFontScaling #5205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/pixelratio.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,10 @@ Returns the scaling factor for font sizes. This is the ratio that is used to cal

If a font scale is not set, this returns the device pixel ratio.

:::note
On Android 14 and newer, the system scales fonts [non-linearly](https://developer.android.com/about/versions/14/features#non-linear-font-scaling) once the user's font scale is 1.05 or higher: small fonts grow by roughly the full factor, while larger fonts grow progressively less (for example, a 30sp font does not grow at all until the setting exceeds 1.5). `getFontScale()` still returns the linear preference value (such as `1.3`), so multiplying a font size by it will overestimate the rendered size of large text on these devices.
:::

---

### `getPixelSizeForLayoutSize()`
Expand Down
2 changes: 2 additions & 0 deletions docs/text.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -312,6 +312,8 @@ Specifies whether fonts should be scaled down automatically to fit given style c

Specifies whether fonts should scale to respect Text Size accessibility settings.

On Android 14 and newer, scaling is [non-linear](https://developer.android.com/about/versions/14/features#non-linear-font-scaling): as the user's font scale setting grows, large fonts are scaled up less than small ones.

| Type | Default |
| ------- | ------- |
| boolean | `true` |
Expand Down
4 changes: 4 additions & 0 deletions website/versioned_docs/version-0.86/pixelratio.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,10 @@ Returns the scaling factor for font sizes. This is the ratio that is used to cal

If a font scale is not set, this returns the device pixel ratio.

:::note
On Android 14 and newer, the system scales fonts [non-linearly](https://developer.android.com/about/versions/14/features#non-linear-font-scaling) once the user's font scale is 1.05 or higher: small fonts grow by roughly the full factor, while larger fonts grow progressively less (for example, a 30sp font does not grow at all until the setting exceeds 1.5). `getFontScale()` still returns the linear preference value (such as `1.3`), so multiplying a font size by it will overestimate the rendered size of large text on these devices.
:::

---

### `getPixelSizeForLayoutSize()`
Expand Down
Loading