Nivel inicial5 min de lectura · Publicado el

Eventos click en Android: onClick y setOnClickListener

Eventos click en Android: el Button es el timbre y el listener, quien abre; setOnClickListener le dice quién escucha. Sin listener no pasa nadarubentejera.com Button¡ding!listenerquien abresetOnClickListener { … }
El botón es el timbre y el listener, la persona pendiente de abrir: setOnClickListener le dice quién escucha y qué hace al oírlo. Si nadie escucha, el timbre suena y no pasa nada.

Un evento click es el aviso que recibe tu app cuando alguien toca un botón. Tu trabajo es decidir quién escucha ese aviso y qué hace con él.

Es como el timbre de casa: el botón es el timbre y el listener («escuchador») es la persona que está pendiente de abrir la puerta. Si nadie escucha, el timbre suena y no pasa nada.

Las tres formas

Forma Dónde se conecta el click ¿Recomendable?
1. android:onClick en el XML En la vista No: obsoleto desde la API 31
2. setOnClickListener en línea En el código, por botón Sí, es la forma habitual
3. Un listener con when En el código, para varios botones Sí, si comparten lógica

1. Click en XML

No es aconsejable: la vista no debería conocer nombres de métodos ni lógica de nuestro código. Debería ser totalmente independiente. Si renombras el método, el XML no se entera y la app falla al pulsar el botón.

Además, Android marcó este atributo como obsoleto en la API 31 (Android 12). La documentación explica que Android busca el método recorriendo la jerarquía de contextos, algo frágil y que dificulta que herramientas como R8 optimicen el código, y recomienda usar setOnClickListener en su lugar. Lo dejamos aquí porque lo encontrarás en proyectos antiguos.

class ClickEventsActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_click_events) // en esta vista se asigna xmlClick
    }

    // Reglas para los clicks desde XML:
    // 1. El método tiene que ser público.
    // 2. Su nombre tiene que coincidir con el del atributo android:onClick.
    // 3. Recibe un solo parámetro, de tipo View.
    fun xmlClick(view: View) {
        Toast.makeText(this, "Click by XML", Toast.LENGTH_SHORT).show()
    }
}

Y el botón en la vista:

<!-- android:onClick conecta el botón con el método xmlClick de la Activity -->
<Button
    android:id="@+id/buttonClickXML"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_marginStart="16dp"
    android:layout_marginTop="32dp"
    android:layout_marginEnd="16dp"
    android:text="@string/button_click_xml"
    android:onClick="xmlClick"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />

2. Click en línea con setOnClickListener

Es la forma que usa la documentación oficial de Android. Buscas el botón y le pasas una lambda (un bloque de código entre llaves) que se ejecuta al pulsarlo:

class ClickEventsActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_click_events)

        clickInLine() // se llama aquí para registrar el listener al crear la pantalla
    }

    private fun clickInLine() {
        val btn = findViewById<Button>(R.id.buttonClickInLine)
        btn.setOnClickListener {
            Toast.makeText(this, "Click in Line!", Toast.LENGTH_SHORT).show()
        }
    }
}

3. Varios botones con un listener y when

Si varios botones hacen algo parecido, puedes crear un único listener y decidir qué hacer según el id del botón pulsado:

class ClickEventsActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_click_events)

        val listener = View.OnClickListener { view ->
            val texto = when (view.id) {
                R.id.buttonClickMulti1 -> "Click Multi 1"
                R.id.buttonClickMulti2 -> "Click Multi 2"
                R.id.buttonClickMulti3 -> "Click Multi 3"
                else -> return@OnClickListener
            }
            Toast.makeText(this, texto, Toast.LENGTH_SHORT).show()
        }

        findViewById<Button>(R.id.buttonClickMulti1).setOnClickListener(listener)
        findViewById<Button>(R.id.buttonClickMulti2).setOnClickListener(listener)
        findViewById<Button>(R.id.buttonClickMulti3).setOnClickListener(listener)
    }
}

Pulsación larga

El ejemplo original de este artículo usaba en realidad la pulsación larga (mantener el dedo sobre el botón), que se registra igual pero con setOnLongClickListener. La diferencia es que devuelve un Boolean: true significa «ya me he encargado yo» y el evento no sigue a nadie más.

findViewById<Button>(R.id.buttonClickMulti1).setOnLongClickListener {
    Toast.makeText(this, "Pulsación larga", Toast.LENGTH_SHORT).show()
    true // evento consumido
}
La vista dice qué hay en pantalla; el código decide qué pasa al tocarlo.

En Jetpack Compose

En Compose no hay listeners que registrar: el click es un parámetro más del componente.

@Composable
fun Saludo() {
    val context = LocalContext.current
    Button(onClick = {
        Toast.makeText(context, "Click en Compose", Toast.LENGTH_SHORT).show()
    }) {
        Text("Púlsame")
    }
}

Para hacer clicable cualquier otro elemento, usa Modifier.clickable { … }, y para la pulsación larga, Modifier.combinedClickable(onClick = { … }, onLongClick = { … }).

Si quieres saber más sobre el Toast de los ejemplos y su alternativa moderna, mira Toast y Snackbar en Android.

Fuentes

Comprobado en noviembre de 2026 en la documentación oficial de Android: Button, sección Respond to click events, atributo android:onClick (obsoleto en la API 31), View.OnClickListener, View.OnLongClickListener y Tap and press en Compose. Los ejemplos de Android no se han ejecutado para esta revisión (requieren un proyecto Android y un emulador): se han contrastado con esa documentación.