Android中include标签的使用及注意事项

前言

include标签可以实现在一个layout中引用另一个layout的布局，这通常适合于界面布局复杂、不同界面有共用布局的APP中，比如一个APP的顶部布局、侧边栏布局、底部Tab栏布局、ListView和GridView每一项的布局等，将这些同一个APP中有多个界面用到的布局抽取出来再通过include标签引用，既可以降低layout的复杂度，又可以做到布局重用（布局有改动时只需要修改一个地方就可以了）。

使用方法

include标签的使用很简单，只需要在布局文件中需要引用其它布局的地方，使用layout=”@layout/child_layout”就可以了：

<include layout="@layout/titlebar" />

比如，include_voice_ctrl_bar_layout.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="61dp"
    android:orientation="horizontal"
    android:layout_alignParentBottom="true">
    <!-- 播放、暂停 -->
    <Button
        android:id="@+id/voiceBtnId"
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="100"
        android:background="@drawable/voice_btn_selector"
        android:gravity="center"
        android:onClick="onClick"
        android:text="@string/voice_stop"
        android:textColor="@android:color/white"
        android:textSize="24sp" />
    <!-- 分割线 -->
    <View
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:background="@android:color/black" />
    <!-- 听录音 -->
    <Button
        android:id="@+id/listenBtnId"
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="100"
        android:background="@drawable/listen_btn_selector"
        android:gravity="center"
        android:onClick="onClick"
        android:text="@string/voice_listen"
        android:textColor="@android:color/white"
        android:textSize="24sp" />
    <!-- 分割线 -->
    <View
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:background="@android:color/black" />
    <!-- 下一个 -->
    <Button
        android:id="@+id/nextBtnId"
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="100"
        android:background="@drawable/next_btn_selector"
        android:gravity="center"
        android:onClick="onClick"
        android:text="@string/voice_next"
        android:textColor="@android:color/white"
        android:textSize="24sp" />
</LinearLayout>

在需要使用该共用布局的地方作如下调用即可：

<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/background_bottom_layer">
    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_margin="10dp"
        android:background="@drawable/background_top_layer">
        <include layout="@layout/include_voice_text_bar_layout" />
        <include layout="@layout/include_voice_ctrl_bar_layout" />
    </RelativeLayout>
</RelativeLayout>

注意事项

include和其它组件标签（RelativeLayout、LinearLayout、TextView等）一样，都可以使用layout属性来设置布局文件的宽高和位置，但需要注意的是：必须要复写android:layout_width和android:layout_height属性才能使用其它属性（比如:android:layout_grivity、android:layout_align…、android:id等），这样可以避免include引用layout中的子组件属性影响到include的布局效果：

  <RelativeLayout
      xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:background="@drawable/background_bottom_layer">
      <RelativeLayout
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          android:layout_margin="10dp"
          android:background="@drawable/background_top_layer">
          <include layout="@layout/include_voice_text_bar_layout" />
          <include
              android:layout_width="match_parent"
              android:layout_height="61dp"
              android:layout_alignParentBottom="true"
              layout="@layout/include_voice_ctrl_bar_layout"
              />
      </RelativeLayout>
  </RelativeLayout>

建议将给include标签调用布局设置宽高、位置、ID等工作放在调用布局的根标签中，这样可以避免给include标签设置属性不当造成的各种问题（之前遇到过给include标签设置android:id属性后，程序实例化子布局中组件失败的现象）：

应该这样：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:id="@+id/bottomBarLayoutId"
    android:layout_width="match_parent"
    android:layout_height="61dp"
    android:orientation="horizontal"
    android:layout_alignParentBottom="true">
    。。。
</LinearLayout>

<include layout="@layout/include_voice_ctrl_bar_layout" />

而不是这样：

<?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="horizontal">
    。。。
</LinearLayout>

<include
	android:id="@+id/bottomBarLayoutId"
	android:layout_width="match_parent"
    android:layout_height="61dp"
	android:layout_alignParentBottom="true"
	layout="@layout/include_voice_ctrl_bar_layout"
	/>

Android

工具

Others

年度总结

java

Python

Windows

android

others

Java

Eclipse

感悟

标签

Android 65

Java 3

Others 1

年度总结 3

java 1

Python 1

Windows 1

android 2

others 2

Eclipse 1

感悟 1