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

Przycisk

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 →

Podstawowy komponent przycisku, który powinien poprawnie renderować się na każdej platformie. Obsługuje podstawowy poziom dostosowywania.

Jeśli ten przycisk nie spełnia twoich oczekiwań, możesz stworzyć własny przycisk używając komponentu Pressable. W celu inspiracji zapoznaj się z kodem źródłowym komponentu Przycisk.

tsx
<Button
onPress={onPressLearnMore}
title="Learn More"
color="#841584"
accessibilityLabel="Learn more about this purple button"
/>

Przykład


Dokumentacja

Właściwości

Required
onPress

Funkcja wywoływana po dotknięciu przycisku przez użytkownika.

Type
({nativeEvent: PressEvent})

Required
title

Tekst wyświetlany wewnątrz przycisku. Na Androidzie podany tytuł zostanie zamieniony na wielkie litery.

Type
string

accessibilityLabel

Tekst wyświetlany w funkcjach ułatwień dostępu dla osób niewidomych.

Type
string

accessibilityLanguage
iOS

Wartość określająca język używany przez czytnik ekranu podczas interakcji użytkownika z elementem. Powinna być zgodna ze specyfikacją BCP 47.

Więcej informacji znajdziesz w dokumentacji accessibilityLanguage dla iOS.

Type
string

accessibilityActions

Akcje ułatwień dostępu pozwalają technologiom asystującym na programowe wywoływanie akcji komponentu. Właściwość accessibilityActions powinna zawierać listę obiektów akcji. Każdy obiekt akcji powinien zawierać pola name i label.

Więcej informacji znajdziesz w przewodniku o ułatwieniach dostępu.

TypeRequired
arrayNo

onAccessibilityAction

Wywoływana, gdy użytkownik wykonuje akcje ułatwień dostępu. Jedynym argumentem tej funkcji jest zdarzenie zawierające nazwę akcji do wykonania.

Więcej informacji znajdziesz w przewodniku o ułatwieniach dostępu.

TypeRequired
functionNo

color

Kolor tekstu (iOS) lub kolor tła przycisku (Android).

TypeDefault
color '#2196F3'
Android

'#007AFF'
iOS

disabled

Jeśli true, wyłącza wszystkie interakcje z tym komponentem.

TypeDefault
boolfalse

hasTVPreferredFocus
TV

Preferowane ustawienie fokusu dla telewizorów.

TypeDefault
boolfalse

nextFocusDown
Android
TV

Określa następny widok, który otrzyma fokus przy nawigacji w dół. Zobacz dokumentację Androida.

Type
number

nextFocusForward
Android
TV

Określa następny widok, który otrzyma fokus przy nawigacji do przodu. Zobacz dokumentację Androida.

Type
number

nextFocusLeft
Android
TV

Określa następny widok, który otrzyma fokus przy nawigacji w lewo. Zobacz dokumentację Androida.

Type
number

nextFocusRight
Android
TV

Określa następny widok, który otrzyma fokus przy nawigacji w prawo. Zobacz dokumentację Androida.

Type
number

nextFocusUp
Android
TV

Określa następny widok, który otrzyma fokus przy nawigacji w górę. Zobacz dokumentację Androida.

Type
number

testID

Używany do lokalizowania tego widoku w testach end-to-end.

Type
string

touchSoundDisabled
Android

Jeśli true, wyłącza systemowy dźwięk dotknięcia.

TypeDefault
booleanfalse