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, plik docelowy zostanie bezpośrednio załadowany i udostępniony. W ten sposób można udostępniać obrazy, filmy, pliki PDF itp. Gdy url wskazuje plik zdalny lub adres, musi mieć format URL zgodny ze specyfikacją RFC 2396. Na przykład adres URL bez poprawnego 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)