Панель состояния
Компонент для управления панелью состояния приложения. Панель состояния — это область, обычно расположенная в верхней части экрана, которая отображает текущее время, информацию о Wi-Fi и сотовой сети, уровень заряда батареи и/или другие значки состояния.
Использование с Navigator
Возможна одновременная установка нескольких компонентов StatusBar. Свойства будут объединены в порядке установки компонентов StatusBar.
API императивного типа
В случаях, когда использование компонента нежелательно, имеется также API императивного типа, представленный как статические функции компонента. Однако не рекомендуется использовать статический API и компонент для одного и того же свойства, так как любое значение, установленное статическим API, будет перезаписано значением, установленным компонентом в следующем рендере.
Справочник
Константы
currentHeight Android
Высота панели состояния, которая включает высоту выреза, если он присутствует.
Свойства
animated
Если переход между изменениями свойств панели состояния должен быть анимирован. Поддерживается для свойств backgroundColor, barStyle и hidden.
| Тип | Обязательно | Значение по умолчанию |
|---|---|---|
| boolean | Нет | false |
backgroundColor Android
Цвет фона панели состояния.
| Тип | Обязательно | Значение по умолчанию |
|---|---|---|
| цвет | Нет | цвет фона панели состояния по умолчанию для системы, или 'black' если не определен |
barStyle
Устанавливает цвет текста панели состояния.
В Android это повлияет только на версии API 23 и выше.
| Тип | Обязательно | Значение по умолчанию |
|---|---|---|
| СтильПанелиСостояния | Нет | 'default' |
hidden
Если панель состояния скрыта.
| Тип | Обязательно | Значение по умолчанию |
|---|---|---|
| boolean | Нет | false |
networkActivityIndicatorVisible iOS
Если индикатор активности сети должен быть видимым.
| Тип | Значение по умолчанию |
|---|---|
| boolean | false |
showHideTransition iOS
Эффект перехода при показе и скрытии панели состояния с использованием свойства hidden.
| Тип | Значение по умолчанию |
|---|---|
| АнимацияПанелиСостояния | 'fade' |
translucent Android
Если панель состояния полупрозрачна. Когда полупрозрачность установлена в true, приложение будет отображаться под панелью состояния. Это полезно при использовании полупрозрачного цвета панели состояния.
| Тип | Значение по умолчанию |
|---|---|
| boolean | false |
Методы
popStackEntry()
static popStackEntry(entry: any)
Получение и удаление последней записи панели состояния из стека.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| entry Обязательно
|
любой | Запись, возвращенная из pushStackEntry. |
pushStackEntry()
static pushStackEntry(props: any)
Добавление записи панели состояния в стек. Возвращаемое значение должно быть передано в popStackEntry после завершения.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| props Обязательно
|
любой | Объект, содержащий свойства панели состояния для использования в записи стека. |
replaceStackEntry()
static replaceStackEntry(entry: any, props: any)
Замена существующей записи стека панели состояния новыми свойствами.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| entry Обязательно
|
любой | Запись, возвращенная из pushStackEntry для замены. |
| props Обязательно
|
любой | Объект, содержащий свойства панели состояния для использования в заменяемой записи стека. |
setBackgroundColor() Android
static setBackgroundColor(color: string, [animated]: boolean)
Установка цвета фона панели состояния.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| color Обязательно
|
строка | Цвет фона. |
| animated | boolean | Анимировать изменение стиля. |
setBarStyle()
static setBarStyle(style: StatusBarStyle, [animated]: boolean)
Устанавливает стиль панели состояния.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| style Обязательно
|
СтильПанелиСостояния | Стиль панели состояния для установки. |
| animated | boolean | Анимировать изменение стиля. |
setHidden()
static setHidden(hidden: boolean, [animation]: StatusBarAnimation)
Показать или скрыть панель состояния.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| hidden Обязательно
|
boolean | Скрыть панель состояния. |
| animation iOS
|
АнимацияПанелиСостояния | Анимация при изменении свойства скрытия панели состояния. |
setNetworkActivityIndicatorVisible() iOS
static setNetworkActivityIndicatorVisible(visible: boolean)
Управление видимостью индикатора активности сети.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| visible Обязательно
|
boolean | Показать индикатор. |
setTranslucent() Android
static setTranslucent(translucent: boolean)
Управление полупрозрачностью панели состояния.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
| translucent Обязательно
|
boolean | Установить как полупрозрачный. |
Определения типов
АнимацияПанелиСостояния
Тип анимации панели состояния для переходов на iOS.
| Тип |
|---|
| перечисление |
Константы:
| Значение | Тип | Описание |
|---|---|---|
'fade' |
строка | Анимация плавного перехода |
'slide' |
строка | Анимация сдвига |
'none' |
строка | Без анимации |
СтильПанелиСостояния
Тип стиля панели состояния.
| Тип |
|---|
| перечисление |
Константы:
| Значение | Тип | Описание |
|---|---|---|
'default' |
строка | Стиль панели состояния по умолчанию (темный для iOS, светлый для Android) |
'light-content' |
строка | Темный фон, белый текст и значки |
'dark-content' |
строка | Светлый фон, темный текст и значки (требуется API>=23 в Android) |
© 2022 Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://reactnative.dev/docs/statusbar