布局资源

布局资源定义了Activity或UI组件的UI架构。

文件位置

res/layout/filename.xml
文件名用作资源 ID。

编译后的资源数据类型

指向View（或子类）资源的资源指针

资源引用

在 Java 中：R.layout.filename
在 XML 中：@[package:]layout/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<ViewGroup
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@[+][package:]id/resource_name"
    android:layout_height=["dimension" | "match_parent" | "wrap_content"]
    android:layout_width=["dimension" | "match_parent" | "wrap_content"]
    [ViewGroup-specific attributes] >
    <View
        android:id="@[+][package:]id/resource_name"
        android:layout_height=["dimension" | "match_parent" | "wrap_content"]
        android:layout_width=["dimension" | "match_parent" | "wrap_content"]
        [View-specific attributes] >
        <requestFocus/>
    </View>
    <ViewGroup >
        <View />
    </ViewGroup>
    <include layout="@layout/layout_resource"/>
</ViewGroup>

注意：根元素可以是ViewGroup、View或<merge>元素，但只能有一个根元素，并且它必须包含带有android命名空间的xmlns:android属性，如前面的语法示例所示。

元素

<ViewGroup>

其他View元素的容器。有许多不同类型的ViewGroup对象，每个对象都允许您以不同的方式指定子元素的布局。不同类型的ViewGroup对象包括LinearLayout、RelativeLayout和FrameLayout。

不要假设任何ViewGroup的派生都接受嵌套视图。某些视图组是AdapterView类的实现，它只从Adapter确定其子元素。

属性

android:id: 资源 ID。元素的唯一资源名称，您可以使用它从您的应用程序获取对ViewGroup的引用。有关更多信息，请参见android:id 的值部分。
android:layout_height: 尺寸或关键字。必需。组的高度，作为尺寸值（或尺寸资源）或关键字（"match_parent"或"wrap_content"）。有关更多信息，请参见android:layout_height 和 android:layout_width 的值部分。
android:layout_width: 尺寸或关键字。必需。组的宽度，作为尺寸值（或尺寸资源）或关键字（"match_parent"或"wrap_content"）。有关更多信息，请参见android:layout_height 和 android:layout_width 的值部分。

ViewGroup基类支持更多属性，并且每个ViewGroup的实现都支持更多属性。有关所有可用属性的参考，请参见ViewGroup类的相应参考文档，例如LinearLayout XML 属性。

<View>

单个 UI 组件，通常称为小部件。不同类型的View对象包括TextView、Button和CheckBox。

属性

android:id: 资源 ID。元素的唯一资源名称，您可以使用它从您的应用程序获取对View的引用。有关更多信息，请参见android:id 的值部分。
android:layout_height: 尺寸或关键字。必需。元素的高度，作为尺寸值（或尺寸资源）或关键字（"match_parent"或"wrap_content"）。有关更多信息，请参见android:layout_height 和 android:layout_width 的值部分。
android:layout_width: 尺寸或关键字。必需。元素的宽度，作为尺寸值（或尺寸资源）或关键字（"match_parent"或"wrap_content"）。有关更多信息，请参见android:layout_height 和 android:layout_width 的值部分。

View基类支持更多属性，并且每个View的实现都支持更多属性。有关更多信息，请阅读布局。有关所有可用属性的参考，请参见相应的参考文档，例如TextView XML 属性。

<requestFocus>

任何代表View对象的元素都可以包含此空元素，这使得其父元素在屏幕上获得初始焦点。每个文件中只能有一个此类元素。

<include>

将布局文件包含到此布局中。

属性

布局: 布局资源。必需。布局资源的引用。
android:id: 资源 ID。覆盖包含的布局中赋予根视图的 ID。
android:layout_height: 尺寸或关键字。覆盖包含布局中赋予根视图的高度。仅当也声明了android:layout_width时才有效。
android:layout_width: 尺寸或关键字。覆盖包含布局中赋予根视图的宽度。仅当也声明了android:layout_height时才有效。

您可以在<include>中包含包含布局中根元素支持的任何其他布局属性，它们会覆盖根元素中定义的那些属性。

注意：如果您想使用<include>标签覆盖布局属性，则必须同时覆盖android:layout_height和android:layout_width，才能使其他布局属性生效。

另一种包含布局的方法是使用ViewStub：一种轻量级视图，在您明确加载它之前不占用任何布局空间。当您这样做时，它包含其android:layout属性定义的布局文件。有关使用ViewStub的更多信息，请阅读按需加载视图。

<merge>

一个不会在布局层次结构中绘制的替代根元素。当您知道此布局被放置到已经包含适合容纳<merge>元素子元素的父View的布局中时，将其用作根元素非常有用。

当您计划使用<include>将此布局包含在另一个布局文件中，并且此布局不需要不同的ViewGroup容器时，这尤其有用。有关合并布局的更多信息，请阅读使用<include>重用布局。

android:id 的值

对于ID值，您通常使用这种语法形式："@+id/name"，如下例所示。加号+表示这是一个新的资源ID，如果aapt工具不存在，则它会在R.java类中创建一个新的资源整数。

<TextView android:id="@+id/nameTextbox"/>

nameTextbox名称现在是附加到此元素的资源ID。然后，您可以在Java中引用与ID关联的TextView。

Kotlin

val textView: TextView? = findViewById(R.id.nameTextbox)

Java

TextView textView = findViewById(R.id.nameTextbox);

此代码返回TextView对象。

但是，如果您已经定义了ID 资源，并且它尚未使用，则可以通过在android:id值中排除加号来将该ID应用于View元素。

android:layout_height 和 android:layout_width 的值

高度和宽度值可以使用Android支持的任何尺寸单位(px、dp、sp、pt、in、mm)或以下关键字来表示。

值	描述
`match_parent`	将尺寸设置为与父元素的尺寸匹配。在API级别8中添加，以弃用`fill_parent`。
`wrap_content`	仅将尺寸设置为适合此元素内容所需的大小。

自定义视图元素

您可以创建自定义View和ViewGroup元素，并将它们应用于您的布局，就像标准布局元素一样。您还可以指定XML元素中支持的属性。有关更多信息，请参阅创建自定义视图组件。

示例

保存在res/layout/main_activity.xml中的XML文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:orientation="vertical" >
    <TextView android:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="Hello, I am a TextView" />
    <Button android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello, I am a Button" />
</LinearLayout>

此应用程序代码在onCreate()方法中加载Activity的布局。

Kotlin

public override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main_activity)
}

Java

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main_activity);
}

另请参阅

可绘制对象

菜单