StatusBar

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

Komponent do kontroli paska stanu aplikacji. Pasek stanu to obszar, zwykle u góry ekranu, który wyświetla aktualny czas, informacje o sieci Wi-Fi i komórkowej, poziom baterii i/lub inne ikony stanu.

Użycie z komponentem Navigator

Możliwe jest zamontowanie wielu komponentów StatusBar jednocześnie. Właściwości zostaną scalone w kolejności montowania komponentów StatusBar.

TypeScript

JavaScript

Imperatywne API

W przypadkach, gdzie użycie komponentu nie jest idealne, dostępne jest imperatywne API udostępniane jako statyczne funkcje komponentu. Nie zaleca się jednak używania jednocześnie statycznego API i komponentu dla tej samej właściwości, ponieważ wartości ustawione przez statyczne API zostaną nadpisane przez komponent przy kolejnym renderowaniu.

---

Dokumentacja

Stałe

currentHeight

Android

Wysokość paska stanu, uwzględniająca wycięcie (notch), jeśli występuje.

---

Właściwości

animated

Określa, czy zmiany właściwości paska stanu powinny być animowane. Obsługiwane dla właściwości backgroundColor, barStyle i hidden.

Type	Required	Default
boolean	No	false

---

backgroundColor

Android

Kolor tła paska stanu.

ostrzeżenie

Z powodu wymogu edge-to-edge wprowadzonego w Androidzie 15, ustawianie koloru tła paska stanu jest przestarzałe w API poziomu 35 i nie ma żadnego efektu. Więcej informacji znajdziesz w naszych zaleceniach edge-to-edge.

Type	Required	Default
color	No	default system StatusBar background color, or 'black' if not defined

---

barStyle

Ustawia kolor tekstu paska stanu.

Na Androidzie efekt widoczny jest tylko w wersjach API 23 i nowszych.

Type	Required	Default
StatusBarStyle	No	'default'

---

hidden

Określa, czy pasek stanu jest ukryty.

Type	Required	Default
boolean	No	false

---

networkActivityIndicatorVisible

iOS

Określa, czy wskaźnik aktywności sieciowej powinien być widoczny.

Type	Default
boolean	false

---

showHideTransition

iOS

Efekt przejścia przy pokazywaniu/ukrywaniu paska stanu za pomocą właściwości hidden.

Type	Default
StatusBarAnimation	'fade'

---

translucent

Android

Określa, czy pasek stanu jest półprzezroczysty. Gdy ustawione na true, aplikacja rysuje się pod paskiem stanu. Przydatne przy półprzezroczystych kolorach paska stanu.

ostrzeżenie

Ze względu na wymuszenie trybu edge-to-edge wprowadzone w Androidzie 15, ustawianie statusu paska jako półprzezroczysty jest przestarzałe w API poziomu 35 i jego ustawienie nie będzie miało efektu. Więcej informacji można znaleźć w naszych zaleceniach dotyczących edge-to-edge tutaj.

Type	Default
boolean	false

Metody

popStackEntry()

tsx

static popStackEntry(entry: StatusBarProps);

Pobiera i usuwa ostatni wpis StatusBar ze stosu.

Parametry:

Name	Type	Description
entry Required	any	Entry returned from pushStackEntry.

---

pushStackEntry()

tsx

static pushStackEntry(props: StatusBarProps): StatusBarProps;

Dodaje wpis StatusBar na stos. Zwracana wartość powinna zostać przekazana do popStackEntry po zakończeniu.

Parametry:

Name	Type	Description
props Required	any	Object containing the StatusBar props to use in the stack entry.

---

replaceStackEntry()

tsx

static replaceStackEntry(
  entry: StatusBarProps,
  props: StatusBarProps
): StatusBarProps;

Zastępuje istniejący wpis StatusBar na stosie nowymi właściwościami.

Parametry:

Name	Type	Description
entry Required	any	Entry returned from pushStackEntry to replace.
props Required	any	Object containing the StatusBar props to use in the replacement stack entry.

---

setBackgroundColor()

Android

tsx

static setBackgroundColor(color: ColorValue, animated?: boolean);

Ustawia kolor tła paska stanu.

ostrzeżenie

Z powodu wymogu edge-to-edge wprowadzonego w Androidzie 15, ustawianie koloru tła paska stanu jest przestarzałe w API poziomu 35 i nie ma żadnego efektu. Więcej informacji znajdziesz w naszych zaleceniach edge-to-edge.

Parametry:

Name	Type	Description
color Required	string	Background color.
animated	boolean	Animate the style change.

---

setBarStyle()

tsx

static setBarStyle(style: StatusBarStyle, animated?: boolean);

Ustawia styl paska stanu.

Parametry:

Name	Type	Description
style Required	StatusBarStyle	Status bar style to set.
animated	boolean	Animate the style change.

---

setHidden()

tsx

static setHidden(hidden: boolean, animation?: StatusBarAnimation);

Pokazuje lub ukrywa pasek stanu.

Parametry:

Name	Type	Description
hidden Required	boolean	Hide the status bar.
animation iOS	StatusBarAnimation	Animation when changing the status bar hidden property.

---

🗑️ setNetworkActivityIndicatorVisible()

iOS

Przestarzałe

Wskaźnik aktywności sieciowej w pasku stanu nie jest obsługiwany w iOS 13 i nowszych. Zostanie usunięty w przyszłej wersji.

tsx

static setNetworkActivityIndicatorVisible(visible: boolean);

Kontroluje widoczność wskaźnika aktywności sieciowej.

Parametry:

Name	Type	Description
visible Required	boolean	Show the indicator.

---

setTranslucent()

Android

tsx

static setTranslucent(translucent: boolean);

Kontroluje półprzezroczystość paska stanu.

ostrzeżenie

Ze względu na wymuszenie trybu edge-to-edge wprowadzone w Androidzie 15, ustawianie statusu paska jako półprzezroczysty jest przestarzałe w API poziomu 35 i jego ustawienie nie będzie miało efektu. Więcej informacji można znaleźć w naszych zaleceniach dotyczących edge-to-edge tutaj.

Parametry:

Name	Type	Description
translucent Required	boolean	Set as translucent.

Definicje Typów

StatusBarAnimation

Typ animacji paska statusu dla przejść w systemie iOS.

Type
enum

Stałe:

Value	Type	Description
'fade'	string	Fade animation
'slide'	string	Slide animation
'none'	string	No animation

---

StatusBarStyle

Typ stylu paska statusu.

Type
enum

Stałe:

Value	Type	Description
'default'	string	Default status bar style (dark for iOS, light for Android)
'light-content'	string	White texts and icons
'dark-content'	string	Dark texts and icons (requires API>=23 on Android)