Przejdź do treści głównej
Wersja: 0.82

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