Android

ConstraintLayout

Introduction#

ConstraintLayout is a ViewGroup which allows you to position and size widgets in a flexible way. It is compatible with Android 2.3 (API level 9) and higher.

It allows you to create large and complex layouts with a flat view hierarchy. It is similar to RelativeLayout in that all views are laid out according to relationships between sibling views and the parent layout, but it’s more flexible than RelativeLayout and easier to use with Android Studio’s Layout Editor.

Syntax#

  • ConstraintLayout

    • public void addView(View child, int index, ViewGroup.LayoutParams params)

    • public ConstraintLayout.LayoutParams generateLayoutParams(AttributeSet attrs)

    • public void onViewAdded(View view)

    • public void onViewRemoved(View view)

    • public void removeView(View view)

    • public void requestLayout()

    • protected boolean checkLayoutParams(ViewGroup.LayoutParams params)

    • protected ConstraintLayout.LayoutParams generateDefaultLayoutParams()

    • protected ViewGroup.LayoutParams generateLayoutParams(ViewGroup.LayoutParams params)

    • protected void onLayout(boolean changed, int left, int top, int right, int bottom)

    • protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)

  • ConstraintLayout.LayoutParams

    • public void resolveLayoutDirection(int layoutDirection)

    • public void validate()

    • protected void setBaseAttributes(TypedArray a, int widthAttr, int heightAttr)

Parameters#

Parameter Details
child The View to be added to the layout
index The index of the View in the layout hierarchy
params The LayoutParams of the View
attrs The AttributeSet that defines the LayoutParams
view The View that has been added or removed
changed Indicates if this View has changed size or position
left The left position, relative to the parent View
top The top position, relative to the parent View
right The right position, relative to the parent View
bottom The bottom position, relative to the parent View
widthMeasureSpec The horizontal space requirements imposed by the parent View
heightMeasureSpec The vertical space requirements imposed by the parent View
layoutDirection -
a -
widthAttr -
heightAttr -
## Remarks#
At Google IO 2016 Google announced a new Android layout named ConstraintLayout.
Pay attention because currently, this layout is a Beta release.

Fore More About Constraint Layout:

https://codelabs.developers.google.com/codelabs/constraint-layout/index.html

Adding ConstraintLayout to your project

To work with ConstraintLayout, you need Android Studio Version 2.2 or newer and have at least version 32 (or higher) of Android Support Repository.

  1. Add the Constraint Layout library as a dependency in your build.gradle file:

    dependencies { compile ‘com.android.support.constraint:constraint-layout:1.0.2’ }

  2. Sync project

To add a new constraint layout to your project:

  1. Right-click on your module’s layout directory, then click New > XML > Layout XML.
  2. Enter a name for the layout and enter "android.support.constraint.ConstraintLayout" for the Root Tag.
  3. Click Finish.

Otherwise just add in a layout file:

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

</android.support.constraint.ConstraintLayout>

Chains

Since ConstraintLayout alpha 9, Chains are available. A Chain is a set of views inside a ConstraintLayout that are connected in a bi-directional way between them, i.e A connected to B with a constraint, and B connected to A with another constraint.

Example:

<android.support.constraint.ConstraintLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- this view is linked to the bottomTextView --> 
    <TextView
        android:id="@+id/topTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintBottom_toTopOf="@+id/bottomTextView"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_chainPacked="true"/>

    <!-- this view is linked to the topTextView at the same time --> 
    <TextView
        android:id="@+id/bottomTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Bottom\nMkay"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/topTextView"/>

</android.support.constraint.ConstraintLayout>

In this example, the two views are positioned one under another and both of them are centered vertically. You may change the vertical position of these views by adjusting the chain’s bias. Add the following code to the first element of a chain:

app:layout_constraintVertical_bias="0.2"

In a vertical chain, the first element is a top-most view, and in a horizontal chain it is the left-most view. The first element defines the whole chain’s behavior.

Chains are a new feature and are updated frequently. Here is an official Android Documentation on Chains.


This modified text is an extract of the original Stack Overflow Documentation created by the contributors and released under CC BY-SA 3.0 This website is not affiliated with Stack Overflow