Przejdź do treści głównej
Wersja: Następna

ActionSheetIOS

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 →

Wyświetla natywny dla iOS komponent Action Sheet.

Przykład

Dokumentacja

Metody

showActionSheetWithOptions()

tsx
static showActionSheetWithOptions: (
options: ActionSheetIOSOptions,
callback: (buttonIndex: number) => void,
);

Wyświetla okno akcji iOS. Obiekt options musi zawierać jedną lub więcej z następujących właściwości:

  • options (tablica stringów) - lista tytułów przycisków (wymagane)

  • cancelButtonIndex (int) - indeks przycisku anulowania w options

  • cancelButtonTintColor (string) - kolor zmieniający kolor tekstu przycisku anulowania

  • destructiveButtonIndex (int lub tablica intów) - indeks(y) przycisków destrukcyjnych w options

  • title (string) - tytuł wyświetlany nad oknem akcji

  • message (string) - wiadomość wyświetlana pod tytułem

  • anchor (number) - węzeł, do którego powinno być przypięte okno akcji (używane na iPadzie)

  • tintColor (string) - kolor używany dla tytułów przycisków niedestrukcyjnych

  • disabledButtonIndices (tablica liczb) - lista indeksów przycisków, które mają być wyłączone

  • userInterfaceStyle (string) - styl interfejsu używany dla okna akcji (możliwe wartości: light lub dark); domyślnie używany jest styl systemowy

Funkcja 'callback' przyjmuje jeden parametr: indeks wybranego elementu (liczony od zera).

Minimalny przykład:

tsx
ActionSheetIOS.showActionSheetWithOptions(
{
options: ['Cancel', 'Remove'],
destructiveButtonIndex: 1,
cancelButtonIndex: 0,
},
buttonIndex => {
if (buttonIndex === 1) {
/* destructive action */
}
},
);

dismissActionSheet()

tsx
static dismissActionSheet();

Zamyka najwyższe obecnie wyświetlane okno akcji iOS. Jeśli nie ma aktywnego okna, wyświetlane jest ostrzeżenie.


showShareActionSheetWithOptions()

tsx
static showShareActionSheetWithOptions: (
options: ShareActionSheetIOSOptions,
failureCallback: (error: Error) => void,
successCallback: (success: boolean, method: string) => void,
);

Wyświetla arkusz udostępniania iOS. Obiekt options powinien zawierać jedną lub obie właściwości: message i url, a dodatkowo może zawierać subject lub excludedActivityTypes:

  • url (string) - adres URL do udostępnienia

  • message (string) - wiadomość do udostępnienia

  • subject (string) - temat wiadomości

  • excludedActivityTypes (tablica) - aktywności wykluczone z arkusza akcji

uwaga

Jeśli url wskazuje plik lokalny lub jest URI zakodowanym w base64, wskazywany plik zostanie bezpośrednio załadowany i udostępniony. W ten sposób możesz udostępniać obrazy, filmy, pliki PDF itp. Jeśli url wskazuje plik zdalny lub adres, musi być zgodny z formatem URL opisanym w RFC 2396. Na przykład adres URL bez właściwego protokołu (HTTP/HTTPS) nie zostanie udostępniony.

Funkcja 'failureCallback' przyjmuje jeden parametr - obiekt błędu. Jedyną zdefiniowaną właściwością tego obiektu jest opcjonalna właściwość stack typu string.

Funkcja 'successCallback' przyjmuje dwa parametry:

  • wartość logiczną oznaczającą sukces lub porażkę

  • string wskazujący metodę udostępniania (w przypadku sukcesu)