Okno modalne

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 Modal to podstawowy sposób prezentowania treści nad otaczającym widokiem.

Przykład

---

Dokumentacja

Właściwości

Właściwości widoku

Dziedziczy właściwości widoku.

---

animated

Przestarzałe. Zamiast tego użyj właściwości animationType.

---

animationType

Właściwość animationType kontroluje sposób animowania modalu.

Dopuszczalne wartości:

• slide - wsuwa się od dołu

• fade - pojawia się stopniowo

• none - pojawia się bez animacji

Type	Default
enum('none', 'slide', 'fade')	none

---

backdropColor

backdropColor modalu (lub kolor tła kontenera modalu). Domyślnie white, jeśli nie podano i transparent ma wartość false. Ignorowane, gdy transparent jest true.

Type	Default
color	white

---

hardwareAccelerated

Android

Właściwość hardwareAccelerated kontroluje, czy wymusić przyspieszanie sprzętowe dla leżącego u podstaw okna.

Type	Default
bool	false

---

navigationBarTranslucent

Android

Właściwość navigationBarTranslucent określa, czy modal powinien być wyświetlany pod systemowym paskiem nawigacyjnym. Jednakże, aby pasek nawigacyjny był półprzezroczysty, właściwość statusBarTranslucent również musi być ustawiona na true.

Type	Default
bool	false

---

onDismiss

iOS

Właściwość onDismiss pozwala przekazać funkcję, która zostanie wywołana po zamknięciu modalu.

Type
function

---

onOrientationChange

iOS

Funkcja zwrotna onOrientationChange jest wywoływana przy zmianie orientacji podczas wyświetlania modalu. Orientacja jest podawana tylko jako 'portrait' lub 'landscape'. Funkcja jest również wywoływana przy początkowym renderowaniu, niezależnie od bieżącej orientacji.

Type
function

---

allowSwipeDismissal

iOS

Kontroluje, czy modal można zamknąć przez przesunięcie w dół na iOS. Wymaga to zaimplementowania właściwości onRequestClose do obsługi zamknięcia.

Type	Default
bool	false

---

onRequestClose

Funkcja zwrotna onRequestClose jest wywoływana po naciśnięciu sprzętowego przycisku wstecz na Androidzie lub przycisku menu w Apple TV. Z powodu tej wymaganej właściwości, zdarzenia BackHandler nie będą emitowane, dopóki modal jest otwarty. Na iOS funkcja jest wywoływana przy zamykaniu modalu gestem przeciągnięcia, gdy presentationStyle ma wartość pageSheet or formSheet. Gdy allowSwipeDismissal jest włączone, funkcja zostanie wywołana po zamknięciu modalu.

Type
function Required Android TV function iOS

---

onShow

Właściwość onShow pozwala przekazać funkcję, która zostanie wywołana po wyświetleniu modalu.

Type
function

---

presentationStyle

iOS

Właściwość presentationStyle kontroluje sposób wyświetlania modalu (głównie na większych urządzeniach jak iPad czy iPhone'y Plus). Szczegóły: https://developer.apple.com/reference/uikit/uimodalpresentationstyle.

Dopuszczalne wartości:

• fullScreen - zajmuje cały ekran

• pageSheet - zajmuje wyśrodkowany widok o szerokości portretu (tylko większe urządzenia)

• formSheet - zajmuje wyśrodkowany widok o wąskiej szerokości (tylko większe urządzenia)

• overFullScreen - zajmuje cały ekran, ale pozwala na przezroczystość

Type	Default
enum('fullScreen', 'pageSheet', 'formSheet', 'overFullScreen')	fullScreen if transparent={false} overFullScreen if transparent={true}

---

statusBarTranslucent

Android

Właściwość statusBarTranslucent określa, czy modal powinien być wyświetlany pod systemowym paskiem stanu.

Type	Default
bool	false

---

supportedOrientations

iOS

Właściwość supportedOrientations pozwala na obracanie modalu do określonych orientacji. Na iOS modal nadal jest ograniczony wartościami z pola UISupportedInterfaceOrientations w pliku Info.plist aplikacji.

Gdy używasz właściwości presentationStyle ustawionej na pageSheet lub formSheet, ta właściwość jest ignorowana przez iOS.

Type	Default
array of enums('portrait', 'portrait-upside-down', 'landscape', 'landscape-left', 'landscape-right')	['portrait']

---

transparent

Właściwość transparent określa, czy modal wypełni cały widok. Ustawienie true wyrenderuje modal na przezroczystym tle.

Type	Default
bool	false

---

visible

Właściwość visible określa widoczność modalu.

Type	Default
bool	true