In this lesson, you'll use the Android Studio Layout Editor to create a layout that includes a text box and a button. In the next lesson, you'll make the app respond to the button tap by sending the content of the text box to another activity.
The user interface for an Android app is built using a hierarchy of layouts
and widgets (
Layouts are invisible containers that control how its child views are positioned on the screen.
Widgets are UI components such as buttons and text boxes.
Illustration of how
ViewGroup objects form branches in the layout and contain
Android provides an XML vocabulary for
View classes, so
most of your UI is defined in XML files. However, instead of teaching you to write
some XML, this lesson shows you how to create a layout using Android Studio's Layout Editor, which
makes it easy to build a layout by drag-and-dropping views.
Open the Layout Editor
Note: This lesson expects you are using Android Studio 2.3 or higher and you've followed the previous lesson to create your Android project.
To get started, set up your workspace as follows:
- In Android Studio's Project window, open app > res > layout > activity_main.xml.
- To make more room for the Layout Editor, hide the Project window by selecting View > Tool Windows > Project (or click Project on the left side of Android Studio).
- If your editor shows the XML source, click the Design tab at the bottom of the window.
- Click Show Blueprint so only the blueprint layout is visible.
- Make sure Show Constraints is on. The tooltip in the toolbar should read Hide Constraints (because they're now showing).
- Make sure Autoconnect is off. The tooltip in the toolbar should read Turn On Autoconnect (because it's now off).
- Click Default Margins in the toolbar and select 16 (you can still adjust the margin for each view later).
- Click Device in Editor in the toolbar and select Pixel XL.
Your editor should now look as shown in figure 3.
The Component Tree window on the bottom-left side shows the layout's hierarchy of views.
In this case, the root view is a
ConstraintLayout, containing just one
ConstraintLayout is a layout that defines the position for each view based on
constraints to sibling views and the parent layout. In this way, you can create both simple and
complex layouts with a flat view hieararchy. That is, it avoids the need for nested layouts (a
layout inside a layout, as shown in figure 2), which can increase the time required to draw the UI.
For example, you can declare the following layout (in figure 4):
- View A appears 16dp from the top of the parent layout.
- View A appears 16dp from the left of the parent layout.
- View B appears 16dp to the right of view A.
- View B is aligned to the top of view A.
In the following sections, you'll build a layout similar to this.
Add a text box
- First, you need to remove what's already in the layout. So click TextView in the Component Tree window, and then press Delete.
- From the Palette window on the left, click Text in the left pane,
and then drag Plain Text into the
design editor and drop it near the top of the layout. This is an
EditTextwidget that accepts plain text input.
- Click the view in the design editor. You can now see the resizing handles on
each corner (squares), and the constraint anchors on each side (circles).
For better control, you might want to zoom in on the editor to 75% or higher using the buttons in the toolbar.
- Click-and-hold the anchor on the top side, and then drag it up until it snaps to the top of the layout and release. That's a constraint—it specifies the view should be 16dp from the top of the layout (because you set the default margins to 16dp).
- Similarly, create a constraint from the left side of the view to the left side of the layout.
The result should look like the screenshot in figure 5.
Add a button
- From the Palette window, click Widgets in the left pane, and then drag Button into the design editor and drop it near the right side.
- Create a constraint from the left side of the button to the right side of the text box.
- To constrain the views in a horizontal alignment, you need to create a constraint between the text baselines. So click the button, and then click Baseline Constraint , which appears in the design editor directly below the selected view. The baseline anchor appears inside the button. Click-and-hold on this anchor and then drag it to the baseline anchor that appears in the text box.
The result should look like the screenshot in figure 6.
Note: You can also create a horizontal alignment using the top or bottom edges, but the button includes padding around its image, so the visual alignment is wrong if you align these views that way.
Change the UI strings
Click Show Design in the toolbar to preview the UI. Notice that the text input is pre-filled with "Name" and the button is labeled "Button." So now you'll change these strings.
- Open the Project window and then open app > res > values > strings.xml.
This is a string resources file where you should specify all your UI strings. Doing so allows you to manage all UI strings in a single location, which makes it easier to find, update, and localize (compared to hard-coding strings in your layout or app code).
- Click Open editor at the top of the editor window. This opens the Translations Editor, which provides a simple interface for adding and editing your default strings, and helps keep all your translated strings organized.
- Enter "edit_message" for the key name.
- Enter "Enter a message" for the value.
- Click OK.
- Add another key named "button_send" with a value of "Send."
Now you can set these strings for each view. So return to the layout file by clicking activity_main.xml in the tab bar, and add the strings as follows:
- Click the text box in the layout and, if the Properties window isn't already visible on the right, click Properties on the right sidebar.
- Locate the hint property and then click Pick a Resource to the right of the text box. In the dialog that appears, double-click on edit_message from the list.
- Still viewing the text box properties, also delete the value for the text property (currently set to "Name").
- Now click the button in the layout, locate the text property, click Pick a Resource , and then select button_send.
Make the text box size flexible
To create a layout that's responsive to different screen sizes, you'll now make the text box stretch to fill all remaining horizontal space (after accounting for the button and margins).
Before you continue, click Show Blueprint in the Layout Editor toolbar.
- Select both views (click one and then hold Shift and click the other), and then right-click
either view and select Center Horizontally.
Although your goal is not to center the views, this is a quick way to create a chain between the two views. A chain is a bidirectional constraint between two or more views that allows you to lay out the chained views in unison. However, this also removes the horizontal margins, so you'll change those back.
- Select the button and open the Properties window. Set both the left and right margin to 16.
- Select the text box and set just the left margin to 16.
- Still viewing the text box properties, click the width indicator until set
to Match Constraints, as indicated by callout 1 in figure 9.
"Match constraints" means that the width is now determined by the horizontal constraints and margins. Therefore, the text box stretches to fill the horizontal space (after accounting for the button and all margins).
Now the layout is done and should appear as shown in figure 10.
If it seems your layout did not turn out as expected, click below to see what your the XML should look like and compare it to what you see in the Text tab. (If your attributes appear in a different order, that's okay.)
See the final layout XML
<?xml version="1.0" encoding="utf-8"?> <android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="com.example.myfirstapp.MainActivity"> <EditText android:id="@+id/editText" android:layout_width="0dp" android:layout_height="wrap_content" android:layout_marginTop="16dp" android:ems="10" android:hint="@string/edit_message" android:inputType="textPersonName" app:layout_constraintLeft_toLeftOf="parent" app:layout_constraintTop_toTopOf="parent" app:layout_constraintRight_toLeftOf="@+id/button" android:layout_marginLeft="16dp" /> <Button android:id="@+id/button" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/button_send" app:layout_constraintBaseline_toBaselineOf="@+id/editText" app:layout_constraintLeft_toRightOf="@+id/editText" app:layout_constraintRight_toRightOf="parent" android:layout_marginLeft="16dp" android:layout_marginRight="16dp" /> </android.support.constraint.ConstraintLayout>
For more information about chains
and all the other things you can do with
ConstraintLayout, read Build a
Responsive UI with ConstraintLayout.
Run the app
If your app is already installed on the device from the previous lesson, simply click Apply Changes in the toolbar to update the app with the new layout. Or click Run to install and run the app.
The button still does nothing. To start another activity when the button is tapped, continue to the next lesson.