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

前言

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

使用方法

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

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

??比如，includevoicectrlbarlayout.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:layoutwidth和android:layoutheight属性才能使用其它属性（比如:android:layoutgrivity、android:layoutalign...、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"
    />

参考资料

• Does Android XML Layout‘s ‘include‘ Tag Really Work?
• Re-using Layouts with