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"
  />


0 0