Skip to content

Commit 4869432

Browse files
authored
Clearify StatusBar deprecations for Android 15+ (facebook#4652)
1 parent 4d2f2f8 commit 4869432

File tree

5 files changed

+50
-10
lines changed

5 files changed

+50
-10
lines changed

docs/statusbar.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ If the transition between status bar property changes should be animated. Suppor
266266
The background color of the status bar.
267267

268268
:::warning
269-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
269+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
270270
:::
271271

272272
| Type | Required | Default |
@@ -321,6 +321,10 @@ The transition effect when showing and hiding the status bar using the `hidden`
321321

322322
If the status bar is translucent. When translucent is set to `true`, the app will draw under the status bar. This is useful when using a semi transparent status bar color.
323323

324+
:::warning
325+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
326+
:::
327+
324328
| Type | Default |
325329
| ------- | ------- |
326330
| boolean | `false` |
@@ -388,7 +392,7 @@ static setBackgroundColor(color: ColorValue, animated?: boolean);
388392
Set the background color for the status bar.
389393

390394
:::warning
391-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
395+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
392396
:::
393397

394398
**Parameters:**
@@ -458,6 +462,10 @@ static setTranslucent(translucent: boolean);
458462

459463
Control the translucency of the status bar.
460464

465+
:::warning
466+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
467+
:::
468+
461469
**Parameters:**
462470

463471
| Name | Type | Description |

website/versioned_docs/version-0.76/statusbar.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ If the transition between status bar property changes should be animated. Suppor
266266
The background color of the status bar.
267267

268268
:::warning
269-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
269+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
270270
:::
271271

272272
| Type | Required | Default |
@@ -321,6 +321,10 @@ The transition effect when showing and hiding the status bar using the `hidden`
321321

322322
If the status bar is translucent. When translucent is set to `true`, the app will draw under the status bar. This is useful when using a semi transparent status bar color.
323323

324+
:::warning
325+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
326+
:::
327+
324328
| Type | Default |
325329
| ------- | ------- |
326330
| boolean | `false` |
@@ -388,7 +392,7 @@ static setBackgroundColor(color: ColorValue, animated?: boolean);
388392
Set the background color for the status bar.
389393

390394
:::warning
391-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
395+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
392396
:::
393397

394398
**Parameters:**
@@ -458,6 +462,10 @@ static setTranslucent(translucent: boolean);
458462

459463
Control the translucency of the status bar.
460464

465+
:::warning
466+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
467+
:::
468+
461469
**Parameters:**
462470

463471
| Name | Type | Description |

website/versioned_docs/version-0.77/statusbar.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ If the transition between status bar property changes should be animated. Suppor
266266
The background color of the status bar.
267267

268268
:::warning
269-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
269+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
270270
:::
271271

272272
| Type | Required | Default |
@@ -321,6 +321,10 @@ The transition effect when showing and hiding the status bar using the `hidden`
321321

322322
If the status bar is translucent. When translucent is set to `true`, the app will draw under the status bar. This is useful when using a semi transparent status bar color.
323323

324+
:::warning
325+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
326+
:::
327+
324328
| Type | Default |
325329
| ------- | ------- |
326330
| boolean | `false` |
@@ -388,7 +392,7 @@ static setBackgroundColor(color: ColorValue, animated?: boolean);
388392
Set the background color for the status bar.
389393

390394
:::warning
391-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
395+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
392396
:::
393397

394398
**Parameters:**
@@ -458,6 +462,10 @@ static setTranslucent(translucent: boolean);
458462

459463
Control the translucency of the status bar.
460464

465+
:::warning
466+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
467+
:::
468+
461469
**Parameters:**
462470

463471
| Name | Type | Description |

website/versioned_docs/version-0.78/statusbar.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ If the transition between status bar property changes should be animated. Suppor
266266
The background color of the status bar.
267267

268268
:::warning
269-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
269+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
270270
:::
271271

272272
| Type | Required | Default |
@@ -321,6 +321,10 @@ The transition effect when showing and hiding the status bar using the `hidden`
321321

322322
If the status bar is translucent. When translucent is set to `true`, the app will draw under the status bar. This is useful when using a semi transparent status bar color.
323323

324+
:::warning
325+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
326+
:::
327+
324328
| Type | Default |
325329
| ------- | ------- |
326330
| boolean | `false` |
@@ -388,7 +392,7 @@ static setBackgroundColor(color: ColorValue, animated?: boolean);
388392
Set the background color for the status bar.
389393

390394
:::warning
391-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
395+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
392396
:::
393397

394398
**Parameters:**
@@ -458,6 +462,10 @@ static setTranslucent(translucent: boolean);
458462

459463
Control the translucency of the status bar.
460464

465+
:::warning
466+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
467+
:::
468+
461469
**Parameters:**
462470

463471
| Name | Type | Description |

website/versioned_docs/version-0.79/statusbar.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ If the transition between status bar property changes should be animated. Suppor
266266
The background color of the status bar.
267267

268268
:::warning
269-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
269+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
270270
:::
271271

272272
| Type | Required | Default |
@@ -321,6 +321,10 @@ The transition effect when showing and hiding the status bar using the `hidden`
321321

322322
If the status bar is translucent. When translucent is set to `true`, the app will draw under the status bar. This is useful when using a semi transparent status bar color.
323323

324+
:::warning
325+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
326+
:::
327+
324328
| Type | Default |
325329
| ------- | ------- |
326330
| boolean | `false` |
@@ -388,7 +392,7 @@ static setBackgroundColor(color: ColorValue, animated?: boolean);
388392
Set the background color for the status bar.
389393

390394
:::warning
391-
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35.
395+
Due to edge-to-edge enforcement introduced in Android 15, setting background color of the status bar is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
392396
:::
393397

394398
**Parameters:**
@@ -458,6 +462,10 @@ static setTranslucent(translucent: boolean);
458462

459463
Control the translucency of the status bar.
460464

465+
:::warning
466+
Due to edge-to-edge enforcement introduced in Android 15, setting the status bar as translucent is deprecated in API level 35 and setting it will have no effect. You can read more about our [edge-to-edge recommendations here](https://github.com/react-native-community/discussions-and-proposals/discussions/827).
467+
:::
468+
461469
**Parameters:**
462470

463471
| Name | Type | Description |

0 commit comments

Comments
 (0)