Botón

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Componente básico de botón que debe renderizarse correctamente en cualquier plataforma. Admite un nivel mínimo de personalización.

Si este botón no se ajusta al diseño de tu aplicación, puedes crear tu propio botón usando Pressable. Para inspiración, revisa el código fuente del componente Button.

tsx

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

Ejemplo

---

Referencia

Propiedades

Required

onPress

Manejador que se llamará cuando el usuario presione el botón.

Type
({nativeEvent: PressEvent})

---

Required

title

Texto a mostrar dentro del botón. En Android, el título se convertirá a mayúsculas.

Type
string

---

accessibilityLabel

Texto para características de accesibilidad de lectores de pantalla.

Type
string

---

accessibilityLanguage

iOS

Valor que indica qué idioma debe usar el lector de pantalla cuando el usuario interactúa con el elemento. Debe seguir la especificación BCP 47.

Consulta la documentación de iOS para accessibilityLanguage para más información.

Type
string

---

accessibilityActions

Las acciones de accesibilidad permiten que una tecnología asistencial invoque programáticamente las acciones de un componente. La propiedad accessibilityActions debe contener una lista de objetos de acción. Cada objeto debe incluir los campos name y label.

Consulta la guía de Accesibilidad para más información.

Type	Required
array	No

---

onAccessibilityAction

Se invoca cuando el usuario realiza acciones de accesibilidad. El único argumento es un evento que contiene el nombre de la acción a realizar.

Consulta la guía de Accesibilidad para más información.

Type	Required
function	No

---

color

Color del texto (iOS) o color de fondo del botón (Android).

Type	Default
color	'#2196F3' Android '#007AFF' iOS

---

disabled

Si es true, desactiva todas las interacciones con este componente.

Type	Default
bool	false

---

hasTVPreferredFocus

TV

Enfoque preferido para TV.

Type	Default
bool	false

---

nextFocusDown

Android

TV

Designa la siguiente vista que recibirá el enfoque al navegar hacia abajo. Ver documentación de Android.

Type
number

---

nextFocusForward

Android

TV

Designa la siguiente vista que recibirá el enfoque al navegar hacia adelante. Ver documentación de Android.

Type
number

---

nextFocusLeft

Android

TV

Designa la siguiente vista que recibirá el enfoque al navegar hacia la izquierda. Ver documentación de Android.

Type
number

---

nextFocusRight

Android

TV

Designa la siguiente vista que recibirá el enfoque al navegar hacia la derecha. Ver documentación de Android.

Type
number

---

nextFocusUp

Android

TV

Designa la siguiente vista que recibirá el enfoque al navegar hacia arriba. Ver documentación de Android.

Type
number

---

testID

Usado para localizar esta vista en pruebas end-to-end.

Type
string

---

touchSoundDisabled

Android

Si es true, no reproduce el sonido del sistema al tocar.

Type	Default
boolean	false