Cómo compilar una IU responsiva con ConstraintLayout Parte de Android Jetpack.
ConstraintLayout
te permite crear diseños grandes y complejos con una jerarquía de vistas plana, sin grupos de vistas anidados. Es similar a RelativeLayout
, ya que todas las vistas se presentan de acuerdo con las relaciones entre las vistas del mismo nivel y el diseño superior, pero es más flexible que RelativeLayout
y más fácil de usar con el editor de diseño de Android Studio.
Toda la potencia de ConstraintLayout
está disponible directamente desde las herramientas visuales del editor de diseño, ya que la API de diseño y el editor de diseño están diseñados especialmente para ellos. Para compilar tu diseño con ConstraintLayout
por completo, arrastra en lugar de editar el XML.
En esta página, se muestra cómo compilar un diseño con ConstraintLayout
en Android Studio 3.0 o versiones posteriores. Para obtener más información sobre el editor de diseño, consulta Cómo compilar una IU con el editor de diseño.
Para ver una variedad de diseños que puedes crear con ConstraintLayout
, consulta el proyecto de ejemplos de diseño de restricciones en GitHub.
Descripción general de las restricciones
Para definir la posición de una vista en ConstraintLayout
, agrega al menos una restricción horizontal y una vertical para la vista. Cada restricción representa una conexión o alineación con otra vista, el diseño de nivel superior o una guía invisible. Cada restricción define la posición de la vista a lo largo del eje vertical u horizontal. Cada vista debe tener un mínimo de una restricción para cada eje, pero a menudo se necesitan más.
Cuando sueltas una vista en el editor de diseño, esta permanece donde la dejas, incluso si no tiene restricciones. Esto es solo para facilitar la edición. Si una vista no tiene restricciones cuando ejecutas tu diseño en un dispositivo, se dibuja en la posición [0,0] (la esquina superior izquierda).
En la figura 1, el diseño se ve bien en el editor, pero no hay una restricción vertical en la vista C. Cuando este diseño se dibuja en un dispositivo, la vista C se alinea horizontalmente con los bordes izquierdo y derecho de la vista A, pero aparece en la parte superior de la pantalla porque no tiene restricción vertical.
![](https://developer.android.google.cn/static/training/constraint-layout/images/constraint-fail_2x.png?authuser=5&hl=es)
Figura 1: El editor muestra la vista C debajo de la A, pero no tiene restricción vertical.
![](https://developer.android.google.cn/static/training/constraint-layout/images/constraint-fail-fixed_2x.png?authuser=5&hl=es)
Figura 2: La vista C ahora tiene una restricción vertical por debajo de la vista A.
Aunque una restricción faltante no causa un error de compilación, el editor de diseño indica que faltan restricciones como un error en la barra de herramientas. Para ver los errores y otras advertencias, haz clic en Show Warnings and Errors
.
Para ayudarte a evitar que falten restricciones, el editor de diseño agrega restricciones automáticamente con las funciones Autoconnect and infer constraints.
Cómo agregar ConstraintLayout a tu proyecto
Para usar ConstraintLayout
en tu proyecto, sigue estos pasos:
- Asegúrate de tener el repositorio
maven.google.com
declarado en tu archivosettings.gradle
:Groovy
dependencyResolutionManagement { ... repositories { google() } )
Kotlin
dependencyResolutionManagement { ... repositories { google() } }
- Agrega la biblioteca como una dependencia en el archivo
build.gradle
de nivel de módulo, como se muestra en el siguiente ejemplo. La versión más reciente puede ser diferente de la que se muestra en el ejemplo.Groovy
dependencies { implementation "androidx.constraintlayout:constraintlayout:2.2.0-alpha14" // To use constraintlayout in compose implementation "androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14" }
Kotlin
dependencies { implementation("androidx.constraintlayout:constraintlayout:2.2.0-alpha14") // To use constraintlayout in compose implementation("androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14") }
- En la barra de herramientas o en la notificación de sincronización, haz clic en Sync Project with Gradle Files.
Ya está todo listo para crear el diseño con ConstraintLayout
.
Cómo convertir un diseño
![](https://developer.android.google.cn/static/training/constraint-layout/images/layout-editor-convert-to-constraint_2x.png?authuser=5&hl=es)
Figura 3: Menú para convertir un diseño en ConstraintLayout
Para convertir un diseño existente en uno de ConstraintLayout, sigue estos pasos:
- Abre tu diseño en Android Studio y haz clic en la pestaña Design, en la parte inferior de la ventana del editor.
- En la ventana Component Tree, haz clic con el botón derecho en el diseño y selecciona Convert LinearLayout to ConstraintLayout.
Cómo crear un nuevo diseño
Para iniciar un archivo de diseño con restricciones nuevo, sigue estos pasos:
- En la ventana Project, haz clic en la carpeta del módulo y selecciona File > New > XML > Layout XML.
- Ingresa un nombre para el archivo de diseño y, luego, "androidx.constraintlayout.widget.ConstraintLayout" en Root Tag.
- Haz clic en Finish.
Cómo agregar o quitar una restricción
Para agregar una restricción, haz lo siguiente:
Video 1: El lado izquierdo de una vista está restringido al lado izquierdo del elemento superior.
Arrastra una vista desde la ventana Palette hasta el editor.
Cuando agregas una vista en un objeto
ConstraintLayout
, se muestra en un cuadro delimitador con controladores de cambio de tamaño cuadrados en cada esquina y controladores de restricciones circulares en cada lado.- Haz clic en la vista para seleccionarla.
- Realiza una de las siguientes acciones:
- Haz clic en un controlador de restricción y arrástralo hasta un punto de anclaje disponible. Este punto puede ser el borde de otra vista, el borde del diseño o una guía. Ten en cuenta que, a medida que arrastras el controlador de restricciones, el editor de diseño muestra posibles anclas de conexión y superposiciones azules.
Haz clic en uno de los botones
de Create a connection en la sección Layout de la ventana Attributes, como se muestra en la figura 4.
Figura 4: La sección Layout de la ventana Attributes te permite crear conexiones.
Cuando se crea la restricción, el editor le otorga un margen predeterminado para separar las dos vistas.
Cuando crees restricciones, recuerda las siguientes reglas:
- Cada vista debe tener al menos dos restricciones: una horizontal y otra vertical.
- Solo puedes crear restricciones entre un controlador de restricciones y un punto de anclaje que compartan el mismo plano. Un plano vertical (los lados izquierdo y derecho) de una vista solo se puede restringir a otro plano vertical, y los modelos de referencia solo se pueden restringir a otras líneas de base.
- Cada controlador de restricciones se puede usar para una sola restricción, pero puedes crear varias restricciones desde diferentes vistas al mismo punto de anclaje.
Para borrar una restricción, puedes optar por alguna de las siguientes alternativas:
- Haz clic en una restricción para seleccionarla y, luego, en Borrar.
Control y haz clic (Comando y clic en macOS) en un anclaje de restricción. La restricción se vuelve de color rojo para indicar que puedes hacer clic para borrarla, como se muestra en la figura 5.
Figura 5: La restricción de color rojo indica que puedes hacer clic para borrarla.
En la sección Layout de la ventana Attributes, haz clic en un anclaje de restricción, como se muestra en la figura 6.
Figura 6: Haz clic en un anclaje de restricción para borrarlo.
Video 2: Agrega una restricción opuesta a una existente.
Si agregas restricciones opuestas en una vista, estas se enrollan como un resorte para indicar las fuerzas opuestas, como se muestra en el video 2. El efecto es más visible cuando el tamaño de la vista se establece como "fixed" o "wrap content", en cuyo caso la vista se centra entre las restricciones. En cambio, si deseas que la vista se estire para cumplir con las restricciones, cambia el tamaño a "ajustar restricciones". Si deseas mantener el tamaño actual, pero mover la vista para que no esté centrada, ajusta el sesgo de restricciones.
Puedes usar restricciones para lograr diferentes tipos de comportamiento de diseño, como se describe en las siguientes secciones.
Posición superior
Restringe el lado de una vista al borde correspondiente del diseño.
En la figura 7, el lado izquierdo de la vista está conectado al borde izquierdo del diseño de nivel superior. Puedes definir la distancia desde el borde con margen.
![](https://developer.android.google.cn/static/training/constraint-layout/images/parent-constraint_2x.png?authuser=5&hl=es)
Figura 7: Es una restricción horizontal del elemento superior.
Posición de orden
Define el orden de aparición de dos vistas, ya sea de forma horizontal o vertical.
En la figura 8, B está restringida para estar siempre a la derecha de A, y C está restringida por debajo de A. Sin embargo, estas restricciones no implican alineación, por lo que B puede moverse hacia arriba y hacia abajo.
![](https://developer.android.google.cn/static/training/constraint-layout/images/position-constraint_2x.png?authuser=5&hl=es)
Figura 8: Restricción horizontal y vertical
Alineación
Alinea el borde de una vista con el mismo borde de otra vista.
En la figura 9, el lado izquierdo de B está alineado con el lado izquierdo de A. Si deseas alinear los centros de las vistas, crea una restricción en ambos lados.
Puedes compensar la alineación arrastrando la vista desde la restricción hacia adentro. Por ejemplo, en la figura 10, se muestra B con una alineación de desplazamiento de 24 dp. El desplazamiento se define por el margen de la vista restringida.
También puedes seleccionar todas las vistas que deseas alinear y, luego, hacer clic en Align
en la barra de herramientas para seleccionar el tipo de alineación.
![](https://developer.android.google.cn/static/training/constraint-layout/images/alignment-constraint_2x.png?authuser=5&hl=es)
Figura 9: Restricción de alineación horizontal
![](https://developer.android.google.cn/static/training/constraint-layout/images/alignment-constraint-offset_2x.png?authuser=5&hl=es)
Figura 10: Restricción de alineación horizontal de desplazamiento.
Alineación de línea de base
Alinea la línea de base de texto de una vista con la línea de base de texto de otra.
En la figura 11, la primera línea de B está alineada con el texto de A.
Para crear una restricción de modelo de referencia, haz clic con el botón derecho en la vista de texto que desees restringir y, luego, haz clic en Mostrar modelo de referencia. Luego, haz clic en la línea de base del texto y arrastra la línea a otra línea de base.
![](https://developer.android.google.cn/static/training/constraint-layout/images/baseline-constraint_2x.png?authuser=5&hl=es)
Figura 11: Restricción de alineación de línea de base.
Cómo aplicar una restricción a una guía
Puedes agregar una guía vertical u horizontal que te permita restringir las vistas y que sea invisible para los usuarios de tu app. Puedes colocar la guía dentro del diseño en función de unidades dp o un porcentaje relativo al borde del diseño.
Para crear una guía, haz clic en Guidelines
en la barra de herramientas y, luego, en Add Vertical Guideline o Add Horizontal Guideline.
Arrastra la línea punteada para cambiar su posición y haz clic en el círculo en el borde de la guía para activar o desactivar el modo de medición.
![](https://developer.android.google.cn/static/training/constraint-layout/images/guideline-constraint_2x.png?authuser=5&hl=es)
Figura 12: Una vista restringida a una guía.
Cómo aplicar una restricción a una barrera
Al igual que una guía, una barrera es una línea invisible a la que puedes restringir las vistas, excepto que una barrera no define su propia posición. En cambio, la posición de la barrera se mueve en función de la posición de las vistas que contiene. Esto es útil cuando deseas restringir una vista a un conjunto de vistas en lugar de a una vista específica.
Por ejemplo, en la figura 13, la vista C está restringida al lado derecho de una barrera. La barrera se establece en el "extremo" (o en el lado derecho, en un diseño de izquierda a derecha) de las vistas A y B. La barrera se mueve dependiendo de si el lado derecho de la vista A o de la vista B es el lado más derecho.
Para crear una barrera, sigue estos pasos:
- Haz clic en Guidelines
en la barra de herramientas y, luego, en Add Vertical Barrier o Add Horizontal Barrier.
- En la ventana Component Tree, selecciona las vistas que desees dentro de la barrera y arrástralas al componente de la barrera.
- Selecciona la barrera en Component Tree, abre la ventana Attributes
y, luego, configura barrierDirections.
Ahora puedes crear una restricción desde otra vista hasta la barrera.
También puedes restringir a la barrera las vistas que están dentro de la barrera. De esta manera, puedes alinear entre sí todas las vistas de la barrera, incluso si no sabes qué vista es la más larga o la más alta.
También puedes incluir una guía dentro de una barrera a fin de garantizar una posición "mínima" para la barrera.
![](https://developer.android.google.cn/static/training/constraint-layout/images/barrier-constraint_2x.png?authuser=5&hl=es)
Figura 13: La vista C está restringida a una barrera, que se mueve según la posición y el tamaño de las vistas A y B.
Cómo ajustar el sesgo de restricciones
Cuando agregas una restricción a ambos lados de una vista y el tamaño de la vista para la misma dimensión es "fijo" o "ajustar contenido", la vista se centra entre las dos restricciones con un sesgo del 50% de forma predeterminada. Para ajustar el sesgo, arrastra el control deslizante en la ventana Attributes o arrastra la vista, como se muestra en el video 3.
En cambio, si deseas que la vista se estire para cumplir con las restricciones, cambia el tamaño a "ajustar restricciones".
Video 3: Ajustar el sesgo de restricciones
Cómo ajustar el tamaño de la vista
![](https://developer.android.google.cn/static/images/training/constraint-layout/constraint-layout-editor-attributes-2x.png?authuser=5&hl=es)
Figura 14: Cuando seleccionas una vista, la ventana Attributes incluye controles para 1 relación de tamaño, 2 eliminación de restricciones, 3 modo de alto o ancho, 4 márgenes y 5 sesgo de restricciones. También puedes destacar restricciones individuales en el editor de diseño haciendo clic en ellas en la 6 lista de restricciones.
Puedes usar los controladores de las esquinas para cambiar el tamaño de una vista, pero esta acción codifica el tamaño (la vista no cambia de tamaño para diferentes contenidos o tamaños de pantalla. Para seleccionar un modo de tamaño diferente, haz clic en una vista y abre la ventana Attributes
en el lado derecho del editor.
Cerca de la parte superior de la ventana Attributes, se encuentra el inspector de vistas, que incluye controles para varios atributos de diseño, como se muestra en la figura 14. Esta opción solo está disponible para vistas en un diseño de restricción.
Para cambiar la forma en que se calculan la altura y el ancho, haz clic en los símbolos indicados con texto destacado 3 en la Figura 14. Estos símbolos representan el modo de tamaño de la siguiente manera. Haz clic en el símbolo para alternar entre estas opciones de configuración:
-
Fija: Especifica una dimensión específica en el siguiente cuadro de texto o cambia el tamaño de la vista en el editor.
-
Wrap Content: La vista se expande solo lo necesario para ajustarse a su contenido.
- layout_constraintWidth
-
Match Constraints: la vista se expande tanto como sea posible para cumplir con las restricciones de cada lado, después de considerar los márgenes de la vista. Sin embargo, puedes modificar ese comportamiento con los siguientes atributos y valores. Estos atributos solo tienen efecto cuando estableces el ancho de la vista en “Match constraints”:
- layout_constraintWidth_min
Toma una dimensión en
dp
para el ancho mínimo de la vista. - layout_constraintWidth_max
Toma una dimensión en
dp
para el ancho máximo de la vista.
Sin embargo, si la dimensión determinada tiene solo una restricción, la vista se expande para ajustarse a su contenido. El uso de este modo en la altura o el ancho también te permite establecer una proporción de tamaño.
- layout_constraintWidth_min
Configúralo en true
para permitir que la dimensión horizontal cambie y respete las restricciones. De forma predeterminada, un widget configurado en WRAP_CONTENT
no está limitado por restricciones.
Establecimiento del tamaño como proporción
![](https://developer.android.google.cn/static/images/training/constraint-layout/constraint-layout-ratio-2x.png?authuser=5&hl=es)
Figura 15: La vista tiene un aspecto de 16:9, y el ancho se basa en una relación de la altura.
Puedes establecer el tamaño de la vista en una proporción, como 16:9, si al menos una de las dimensiones de la vista está configurada con el valor "Match constraints" (0dp
). Para habilitar la proporción, haz clic en Toggle Aspect Ratio Constraint (indica 1 en la figura 14) y, luego, ingresa la proporción width:height en la entrada que aparece.
Si tanto el ancho como la altura están configurados para coincidir con las restricciones, puedes hacer clic en Toggle Aspect Ratio Constraint para seleccionar qué dimensión se basa en una proporción de la otra. El inspector de vistas conecta los bordes correspondientes con una línea continua para indicar qué dimensión se establece como proporción.
Por ejemplo, si estableces ambos lados como "Match Constraints", haz clic en Toggle Aspect Ratio Constraint dos veces para establecer el ancho como proporción de la altura. El tamaño completo está determinado por la altura de la vista, que se puede definir de cualquier manera, como se muestra en la figura 15.
Cómo ajustar los márgenes de la vista
Para que las vistas estén espaciadas de manera uniforme, haz clic en Margin
, en la barra de herramientas, a fin de seleccionar el margen predeterminado de cada vista que agregues al diseño. Cualquier cambio que realices en el margen predeterminado se aplicará solo a las vistas que agregues a partir de ese momento.
Para controlar el margen de cada vista en la ventana Attributes, haz clic en el número de la línea que representa cada restricción. En la figura 14, el texto destacado 4 muestra que el margen inferior se estableció en 16 dp.
Figura 16: El botón Margin de la barra de herramientas
Todos los márgenes que ofrece la herramienta son factores de 8 dp para que tus vistas se alineen con las recomendaciones de cuadrícula cuadrada de 8 dp de Material Design.
Cómo controlar grupos lineales con una cadena
![](https://developer.android.google.cn/static/training/constraint-layout/images/constraint-chain_2x.png?authuser=5&hl=es)
Figura 17: Cadena horizontal con dos vistas.
Una cadena es un grupo de vistas que están vinculadas entre sí con restricciones de posición bidireccionales. Dentro de una cadena, se pueden distribuir las vistas de manera horizontal o vertical.
![](https://developer.android.google.cn/static/training/constraint-layout/images/constraint-chain-styles_2x.png?authuser=5&hl=es)
Figura 18: Ejemplos de cada estilo de cadena.
Las cadenas se pueden diseñar de una de las siguientes maneras:
- Spread: Las vistas se distribuyen uniformemente después de que se tienen en cuenta los márgenes. Es el valor predeterminado.
- Distribuir dentro de una cadena: La primera y la última vista se fijan a las restricciones de cada extremo de la cadena y el resto se distribuye de manera uniforme.
- Ponderado: Cuando la cadena se configura como spread o spread internal, puedes llenar el espacio restante si configuras una o más vistas para que "coincidan con las restricciones" (
0dp
). De forma predeterminada, el espacio se distribuye de manera uniforme entre cada vista configurada en "Match constraints"; sin embargo, puedes asignar un peso de importancia a cada vista usando los atributoslayout_constraintHorizontal_weight
ylayout_constraintVertical_weight
. Esto funciona de la misma manera quelayout_weight
en un diseño lineal: la vista con el valor de ponderación más alto obtiene la mayor cantidad de espacio, y las vistas que tienen el mismo peso obtienen la misma cantidad de espacio. - Packed: Las vistas se empaquetan después de que se tienen en cuenta los márgenes. Puedes ajustar el sesgo de toda la cadena (izquierda o derecha, o arriba o abajo) cambiando el sesgo de la vista de la “cabeza” de la cadena.
La vista de "encabezado" de la cadena (la vista del extremo izquierdo en una cadena horizontal (en un diseño de izquierda a derecha) y la vista superior en una cadena vertical) define el estilo de la cadena en XML.
Sin embargo, para alternar entre spread, spread into y pack, selecciona cualquier vista de la cadena y haz clic en el botón de la cadena que aparece debajo de la vista.
Para crear una cadena, haz lo siguiente, como se muestra en el video 4:
- Selecciona todas las vistas que se incluirán en la cadena.
- Haz clic con el botón derecho en una de las vistas.
- Selecciona Cadenas.
- Selecciona Center Horizontally o Center Vertically.
Video 4: Creación de una cadena horizontal
A continuación, se indican algunos aspectos que debes tener en cuenta cuando usas cadenas:
- Una vista puede formar parte de una cadena horizontal y vertical, por lo que puedes crear diseños de cuadrícula flexibles.
- Una cadena funciona correctamente solo si cada extremo está restringido a otro objeto en el mismo eje, como se muestra en la figura 14.
- Aunque la orientación de una cadena sea horizontal o vertical, el uso de una no alinea las vistas en esa dirección. Para lograr la posición adecuada de cada vista en la cadena, incluye otras restricciones, como las restricciones de alineación.
Cómo crear restricciones automáticamente
En lugar de agregar restricciones a cada vista a medida que las colocas en el diseño, puedes mover cada vista a las posiciones que desees en el editor de diseño y, luego, hacer clic en Infer Constraints
para crear restricciones automáticamente.
Infer Constraints analiza el diseño a fin de determinar el conjunto de restricciones más efectivo para todas las vistas. Restringe las vistas a sus posiciones actuales y proporciona flexibilidad. Es posible que debas realizar ajustes para que el diseño responda como lo deseas en función de diferentes tamaños y orientaciones de pantalla.
Autoconnect to Parent es una función independiente que puedes habilitar. Cuando está habilitada y agregas vistas secundarias a una superior, esta función crea automáticamente dos o más restricciones para cada vista a medida que las agregas al diseño, pero solo cuando es apropiado restringir la vista al diseño superior. La conexión automática no crea restricciones para otras vistas del diseño.
La conexión automática está inhabilitada de manera predeterminada. Para habilitarla, haz clic en Enable Autoconnection to Parent
en la barra de herramientas del editor de diseño.
Animaciones de fotogramas clave
Dentro de una ConstraintLayout
, puedes animar los cambios de tamaño y posición de los elementos con ConstraintSet
y TransitionManager
.
Un ConstraintSet
es un objeto ligero que representa las restricciones, los márgenes y el padding de todos los elementos secundarios dentro de un ConstraintLayout
. Cuando aplicas un ConstraintSet
a un ConstraintLayout
que se muestra, el diseño actualiza las restricciones de todos sus elementos secundarios.
Para compilar una animación con ConstraintSet
, especifica dos archivos de diseño que actúen como fotogramas clave de inicio y fin de la animación. Luego, puedes cargar un ConstraintSet
del segundo archivo de fotogramas clave y aplicarlo al ConstraintLayout
que se muestra.
En el siguiente ejemplo de código, se muestra cómo realizar una animación moviendo un solo botón hacia la parte inferior de la pantalla.
// MainActivity.kt
fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.keyframe_one)
constraintLayout = findViewById(R.id.constraint_layout) // member variable
}
fun animateToKeyframeTwo() {
val constraintSet = ConstraintSet()
constraintSet.load(this, R.layout.keyframe_two)
TransitionManager.beginDelayedTransition()
constraintSet.applyTo(constraintLayout)
}
// layout/keyframe1.xml // Keyframe 1 contains the starting position for all elements in the animation // as well as final colors and text sizes. <?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <Button android:id="@+id/button2" android:layout_width="0dp" android:layout_height="wrap_content" android:text="Button" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout>
// layout/keyframe2.xml // Keyframe 2 contains another ConstraintLayout with the final positions. <?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <Button android:id="@+id/button2" android:layout_width="0dp" android:layout_height="wrap_content" android:text="Button" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintBottom_toBottomOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout>
Recursos adicionales
ConstraintLayout
se usa en la app de demo de Sunflower.