Spec-Zone.ru › React Native

Панель состояния

Компонент для управления панелью состояния приложения. Панель состояния — это область, обычно расположенная в верхней части экрана, которая отображает текущее время, информацию о 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API