欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

深入理解Android中的xmlns:tools属性

程序员文章站 2024-02-27 22:33:27
前言 安卓开发中,在写布局代码的时候,ide可以看到布局的预览效果。 但是有些效果则必须在运行之后才能看见,比如这种情况:textview在xml中没有设置任何...

前言

安卓开发中,在写布局代码的时候,ide可以看到布局的预览效果。

深入理解Android中的xmlns:tools属性

但是有些效果则必须在运行之后才能看见,比如这种情况:textview在xml中没有设置任何字符,而是在activity中设置了text。因此为了在ide中预览效果,你必须在xml中为textview控件设置android:text属性

<textview

android:id="@+id/text_main"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:textappearance="@style/textappearance.title"

android:layout_margin="@dimen/main_margin"

android:text="i am a title" />

一般我们在这样做的时候都告诉自己,没关系,等写完代码我就把这些东西一并删了。但是你可能会忘,以至于在你的最终产品中也会有这样的代码。

用tools吧,别做傻事

以上的情况是可以避免的,我们使用tools命名空间以及其属性来解决这个问题。

xmlns:tools=http://schemas.android.com/tools

tools可以告诉android studio,哪些属性在运行的时候是被忽略的,只在设计布局的时候有效。比如我们要让android:text属性只在布局预览中有效可以这样

<textview

android:id="@+id/text_main"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:textappearance="@style/textappearance.title"

android:layout_margin="@dimen/main_margin"

tools:text="i am a title" />

tools可以覆盖android的所有标准属性,将android:换成tools:即可。同时在运行的时候就连tools:本身都是被忽略的,不会被带进apk中。

tools属性的种类

tools属性可以分为两种:一种是影响lint提示的,一种是关于xml布局设计的。以上介绍的是tools的最基本用法:在ui设计的时候覆盖标准的android属性,属于第二种。下面介绍lint相关的属性。

lint相关的属性

tools:ignore

tools:targetapi

tools:locale

tools:ignore

ignore属性是告诉lint忽略xml中的某些警告。

假设我们有这样的一个imageview

<imageview

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_marginstart="@dimen/margin_main"

android:layout_margintop="@dimen/margin_main"

android:scaletype="center"

android:src="@drawable/divider" />

lint会提示该imageview缺少android:contentdescription属性。我们可以使用tools:ignore来忽略这个警告:

<imageview

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_marginstart="@dimen/margin_main"

android:layout_margintop="@dimen/margin_main"

android:scaletype="center"

android:src="@drawable/divider"

tools:ignore="contentdescription" />

tools:targetapi

假设minsdklevel 15,而你使用了api21中的控件比如rippledrawable

<ripple xmlns:android="http://schemas.android.com/apk/res/android"

android:color="@color/accent_color" />

则lint会提示警告。

为了不显示这个警告,可以:

<ripple xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:color="@color/accent_color"

tools:targetapi="lollipop" />

tools:locale(本地语言)属性

默认情况下res/values/strings.xml中的字符串会执行拼写检查,如果不是英语,会提示拼写错误,通过以下代码来告诉studio本地语言不是英语,就不会有提示了。

<resources

xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

tools:locale="it">


<!-- your strings go here -->


</resources>

上面首先介绍了tools的最基本用法-覆盖android的属性,然后介绍了忽略lint提示的属性。下面我们将继续介绍关于ui预览的其他属性(非android标准属性)。

注意:关于忽略lint的属性,如果不想了解的话也没关系,因为并不影响编译,一般我都不会管这些警告。

这部分我们将继续介绍关于ui预览的其他属性(非android标准属性)。

  1. tools:context
  2. tools:menu
  3. tools:actionbarnavmode
  4. tools:listitem/listheader/listfooter
  5. tools:showin
  6. tools:layout

tools:context

context属性其实正是的称呼是activity属性,有了这个属性,ide就知道在预览布局的时候该采用什么样的主题。同时他还可以在android studio的java代码中帮助找到相关的文件(go to related files)

深入理解Android中的xmlns:tools属性

该属性的值是activity的完整包名

<linearlayout

xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:id="@+id/container"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

tools:context="com.android.example.mainactivity"> <!-- ... -->

</linearlayout>

tools:menu

告诉ide 在预览窗口中使用哪个菜单,这个菜单将显示在layout的根节点上(actionbar的位置)。

深入理解Android中的xmlns:tools属性

其实预览窗口非常智能,如果布局和一个activity关联(指上面所讲的用tools:context关联)它将会自动查询相关activity的oncreateoptionsmenu方法中的代码,以显示菜单。而menu属性则可以覆盖这种默认的行为。

你还可以为menu属性定义多个菜单资源,不同的菜单资源之间用逗号隔开。

tools:menu="menu_main,menu_edit"

如果你不希望在预览图中显示菜单则:

tools:menu=""

最后需要注意,当主题为theme.appcompat时,这个属性不起作用。

tools:actionbarnavmode

这个属性告诉ide  app bar(material中对actionbar的称呼)的显示模式,其值可以是

standard

tabs

list
<linearlayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:orientation="vertical"

android:layout_width="match_parent"

android:layout_height="match_parent"

tools:actionbarnavmode="tabs" />

同样的,当主题是theme.appcompat (r21+, at least) 或者theme.material,或者使用了布局包含toolbar的方式。  该属性也不起作用,只有holo主题才有效。

listitem, listheader 和listfooter 属性

顾名思义就是在listview expandablelistview等的预览效果中添加头部 尾部 以及子item的预览布局。

<gridview

android:id="@+id/list"

android:layout_width="match_parent"

android:layout_height="wrap_content"

tools:listheader="@layout/list_header"

tools:listitem="@layout/list_item"

tools:listfooter="@layout/list_footer" />

layout属性

tools:layout告诉ide,fragment在程序预览的时候该显示成什么样

<fragment xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:id="@+id/item_list"

android:name="com.example.fragmenttwopanel.itemlistfragment"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:layout_marginleft="16dp"

android:layout_marginright="16dp"

tools:layout="@android:layout/list_content" />

深入理解Android中的xmlns:tools属性

tools:showin

该属性设置于一个被其他布局<include>的布局的根元素上。这让您可以指向包含此布局的其中一个布局,在设计时这个被包含的布局会带着周围的外部布局被渲染。这将允许您“在上下文中”查看和编辑这个布局。需要 studio 0.5.8 或更高版本。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流。