Crea una tarjeta como contenedor

El elemento componible Card actúa como un contenedor de Material Design para tu IU. Las tarjetas presentan una sola pieza de contenido coherente, como la siguiente:

  • Un producto en una app de compras
  • Una noticia en una app de noticias
  • Un mensaje en una app de comunicación.

El enfoque en representar una sola pieza de contenido distingue a Card de otros contenedores. Por ejemplo, Scaffold proporciona la estructura general a toda una pantalla. La tarjeta es un elemento de IU más pequeño dentro de un diseño más grande, mientras que un componente de diseño, como Column o Row, proporciona una API más simple y genérica.

En este tema, se muestra cómo implementar cuatro tipos de tarjetas:

Compatibilidad de versiones

Esta implementación requiere que el minSDK de tu proyecto se establezca en el nivel de API 21 o superior.

Dependencias

Crea una tarjeta básica

Card se comporta de manera similar a otros contenedores en Compose. Para declarar su contenido, llama a otros elementos componibles dentro de él. Por ejemplo, observa cómo Card contiene una llamada a Text en el siguiente ejemplo mínimo:

Crea una tarjeta completa

La clave aquí es el uso de la propiedad colors para cambiar el color relleno:

Resultados

Una tarjeta se completa con el color de la variante de superficie del tema de Material.
Figura 1: Ejemplo de una tarjeta completa.

Crea una tarjeta elevada

En el siguiente fragmento, se muestra cómo implementar una tarjeta elevada. Usa el elemento componible ElevatedCard dedicado.

Puedes usar la propiedad elevation para controlar la apariencia de la elevación y la sombra resultante.

Resultados

Una tarjeta se eleva sobre el fondo de la app, con una sombra.
Figura 2: Ejemplo de una tarjeta elevada.

Crea una tarjeta con un esquema

El siguiente es un ejemplo de una tarjeta con contorno. Usa el elemento componible OutlinedCard dedicado.

Resultados

Una tarjeta está delineada con un borde negro delgado.
Figura 3: Ejemplo de una tarjeta con contorno.

Puntos clave

Consulta la referencia para obtener la definición de la API de Card. Define varios parámetros que puedes usar para personalizar la apariencia y el comportamiento del componente.

Entre algunos de los parámetros clave, se incluyen los siguientes:

  • elevation: Agrega una sombra al componente que lo hace verse elevado sobre el fondo.
  • colors: Usa el tipo CardColors para establecer el color predeterminado del contenedor y de sus elementos secundarios.
  • enabled: Si pasas false para este parámetro, la tarjeta aparecerá inhabilitada y no responderá a las entradas del usuario.
  • onClick: Por lo general, un Card no acepta eventos de clic. Por lo tanto, la sobrecarga principal que debes tener en cuenta es la que define un parámetro onClick. Usa esta sobrecarga cuando quieras que tu implementación de Card responda a los clics del usuario.

Las tarjetas no incluyen acciones de desplazamiento o descarte inherentes, pero se pueden integrar en elementos componibles que ofrecen estas funciones. Por ejemplo, para implementar el deslizamiento para descartar en una tarjeta, intégralo con el elemento componible SwipeToDismiss. Para integrarlo con el desplazamiento, usa modificadores de desplazamiento, como verticalScroll. Consulta la documentación de Scroll para obtener más información.

Colecciones que contienen esta guía

Esta guía forma parte de estas colecciones de guías rápidas seleccionadas que abarcan objetivos más amplios de desarrollo de Android:

Descubre cómo las funciones de componibilidad pueden ayudarte a crear fácilmente componentes de IU atractivos basados en el sistema de diseño de Material Design.

Tienes preguntas o comentarios

Ve a nuestra página de preguntas frecuentes para obtener información sobre las guías rápidas o comunícate con nosotros para contarnos tu opinión.