Android include和merge标签、ViewStub控件的使用总结

<inlcude>标签

在开发Android布局时，常将一些通用的视图提取到一个单独的layout文件中，然后使用<include>标签在需要使用的其他layout布局文件中加载进来，比如App导航栏等。这样，便于对相同视图内容进行统一的控制管理，提高布局重用性。然而，使用<include>标签总有一些值得我们注意的地方。

根容器id与include id必须相同

如果我们给include所加载的layout布局的根容器设置了id属性，也在include标签中设置了id属性，同时需要在代码中获取根容器的控件对象时，一定要将这两个id设置相同的名称！否则，将获取不到根容器对象，即为null。举个例子：

我们将应用中的Toolbar提取到一个include_toolbar.xml文件中，并设置了Toolbar设置了id属性：

1
2
3
4
5
6
7
8
9
10
11
<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.Toolbar
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/tb_toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    app:titleTextColor="@android:color/white"
    app:title=""
    app:theme="@style/AppTheme"
    android:background="@color/blue"/>

然后在其他布局文件activity_main.xml中使用include标签加载上述Toolbar视图，同时由于相对布局的需要而将include标签设置了相同值的id属性：

1
2
3
4
5
6
7
8
9
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
	<!-- 这里的id属性一定要与layout属性所加载的include_toolbar.xml布局的根容器设置相同的值！ -->
    <include
        android:id="@+id/tb_toolbar"
        layout="@layout/include_toolbar"/>

最后在代码文件MainActivity.java中获取Toolbar对象：

1
2
3
4
5
6
7
8
9
 @Override
 protected void onCreate(@Nullable Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
//如果include布局根容器和include标签中的id设置的是不同的值，这里获取的mToolbar值将为null
     Toolbar mToolbar = (Toolbar) findViewById(R.id.tb_toolbar);
     setSupportActionBar(mToolbar);
 }

宽高属性与其他属性的联合使用

在使用include标签时，除了使用layout属性加载布局文件时，一般不需要设置其他属性了，比如：

1
2
3
4
5
6
7
8
9
10
11
12
<?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">
    <include
        layout="@layout/include_toolbar"/>
    ......
</LinearLayout>

但有时为了布局的需要，仍要使用诸如layout_margin等除id之外的其他属性，这时就要注意，为了使这些其他属性起作用，必须同时设置include标签的宽高属性，如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<?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">
    <include
        layout="@layout/include_toolbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="8dp"/>
    ......
</LinearLayout>

onClick 事件穿透问题

比如有这么一个布局：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<RelativeLayout
    android:layout_width="wrap_content"
    android:layout_height="48dp">
    <include
        layout="@layout/include_test"/>
    <View
        android:id="@+id/view_test"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clickable="true"
        android:background="@color/colorPrimary"
        android:visibility="visible"/>
</RelativeLayout>

假设 include 内容包含有一个点击事件。上述视图实际显示时，view_test 视图覆盖 include 内容。如果不设置外层视图 android:clickable=”true” 属性，会发生 include 内容的点击事件穿透问题。也就是，当点击 view_test 这一层视图时，会触发 include 内容的点击事件。

<merge>标签

<merge>标签存在的意义是帮助<include>标签排除多余的一层ViewGroup容器，减少view hierarchy的结构，提升UI performance。Developers官网举了一个很好的例子，大家可以自行查看一下，总结其意思就是，在主界面中，<include>标签的parent ViewGroup与包含的layout根容器ViewGroup是相同的类型，那么则可以将包含的layout根容器ViewGroup使用<merge>标签代替，从而减少一层ViewGroup的嵌套，从而提升UI性能渲染。举个例子就是：

1
2
3
4
5
6
<merge xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- re-used views -->
    ......
</merge>

然后再在其他界面中使用<include>标签加载重用布局文件即可。

ViewStub控件

android.view.ViewStub也可以用来加载布局文件，但与include标签完全不同。ViewStub是一个不可见的View类，用于在运行时按需懒加载资源，只有在代码中调用了viewStub.inflate()或者viewStub.setVisible(View.visible)方法时才内容才变得可见。这里需要注意的一点是，当ViewStub被inflate到parent时，ViewStub就被remove掉了，即当前view hierarchy中不再存在ViewStub，而是使用对应的layout视图代替。ViewStub有几个属性和方法值得说明一下：

  • android:layout属性
    加载包含的layout布局文件；

  • android:inflatedId属性
    重写包含的layout布局文件的根容器id；

  • inflate()方法
    与setVisible(int)方法作用类似，都可以使内容得以显示，只是inflate()会返回一个View对象，避免了额外使用findViewById()方法获取layout视图对象。

举个例子说明一下，按需加载的viewstub_content.xml内容如下（这里只是个例子，只有一个TextView，实际使用中一定是一个复杂的布局才用得上ViewStub）：

1
2
3
4
5
6
7
8
9
10
11
12
13
<?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:gravity="center"
    android:orientation="vertical">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Content"/>
</LinearLayout>

Activity界面布局文件activity_main.xml内容如下，只有一个Button按钮和ViewStub控件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?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">
    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:text="Show"
        android:onClick="onClick"/>
    <ViewStub
        android:id="@+id/vs_viewStub"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout="@layout/viewstub_content"/>
</LinearLayout>

对应的java代码如下，点击按钮显示ViewStub的内容：

1
2
3
public void onClick(View v) {
    View view = ((ViewStub) findViewById(R.id.vs_viewStub)).inflate();
}

点击按钮，即可显示ViewStub的内容。我们用Hierarchy View观察一下视图层次的情况，当Activity初始化时，视图结构如下：

ViewStub-Samles-01

可以看到，当前view hierarchy中存在的是ViewStub而不是包含的layout布局。点击一下按钮，显示内容，再看一下：

ViewStub-Samles-01

ViewStub已经remove掉了，而包含的layout布局加入到当前view hierarchy中，即无法使用findViewById()方法获取ViewStub的引用。

所以，<include>标签与ViewStub完全不是同一个概念，ViewStub自带懒加载特性，可以理解为一个轻量级的View，自身占用资源较小，在UI初始化时所对应的layout布局视图不占用系统资源，从而可以加快当前界面的渲染过程，相比使用普通的view.setVisible(int)方法，性能体验提高不少，而<include>标签则只是用于提高布局的重用性，使用场景大有不同。

本文由 亦枫 创作并首发于 亦枫的个人博客 ，同步推送微信公众号：安卓笔记侠（androidnotebyyifeng）。

欢迎各种形式地交流与转载，注明作者、出处和微信公众号即可。

本文标题为: Android include和merge标签、ViewStub控件的使用总结

本文链接为：https://woyifeng.com/2016/10/08/android-include-merge-viewstub/

赏

请我喝咖啡，资瓷资瓷~

支付宝
微信
  • 热度 ℃

扫一扫，分享到微信

微信分享二维码

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

亦枫，<br/>一名魔都安卓程序员<br/><br/>喜欢深夜执笔，<br/>微信公众号：安卓笔记侠<br/><br/>My Motto,<br/>If you can't fly then run, <br/>can't run then walk, <br/>can't walk then crawl, <br/>keep moving forward.