文档章节

android中xml tools属性详解

hejunbinlan
 hejunbinlan
发布于 2015/06/01 17:53
字数 1642
阅读 11
收藏 0

第一部分

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

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

1
2
3
4
5
6
7
<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命名空间以及其属性来解决这个问题。

1

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

1
2
3
4
5
6
7
<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相关的属性

1
2
3
tools:ignore
tools:targetApi
tools:locale

tools:ignore

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

假设我们有这样的一个ImageView

1
2
3
4
5
6
7
<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来忽略这个警告:

1
2
3
4
5
6
7
8
<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

1
2
<ripple xmlns:android= "http://schemas.android.com/apk/res/android"
   android:color= "@color/accent_color"  />

则Lint会提示警告。

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

1
2
3
4
<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本地语言不是英语,就不会有提示了。

1
2
3
4
5
6
7
8
<resources
   xmlns:tools= "http://schemas.android.com/tools"
   tools:locale= "it" >
  
   <!-- Your strings go here -->
  
</resources>


这篇文章首先介绍了tools的最基本用法-覆盖android的属性,然后介绍了忽略Lint提示的属性。下篇文章中,我们将继续介绍关于UI预览的其他属性(非android标准属性)。

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


第二部分

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

  • tools:context

  • tools:menu

  • tools:actionBarNavMode

  • tools:listitem/listheader/listfooter

  • tools:showIn

  • tools:layout


tools:context

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

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

1
2
3
4
5
6
7
8
9
<LinearLayout
   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的位置)。

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

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

1
tools:menu= "menu_main,menu_edit"

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

1
tools:menu= ""

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


tools:actionBarNavMode

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

1
2
3
standard
tabs
list
1
2
3
4
5
6
<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的预览布局。

1
2
3
4
5
6
7
<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在程序预览的时候该显示成什么样

1
2
3
4
5
6
7
8
9
<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"  />


tools:showIn

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


关于tools 就介绍完了。

注:原文是两篇文章  

Tools of the trade — Part 1  

Tools of the trade — Part 2 。


觉得完全可以在一篇文章中讲完,就翻译在了一起,原文有很多和内容无关的gif图,描述也比较啰嗦,都被我去掉了,这篇文章属于意译。


本文转载自:http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0309/2567.html

hejunbinlan
粉丝 42
博文 596
码字总数 21569
作品 0
浦东
高级程序员
私信 提问
创建自定义控件属性及三个构造方法详解

今天在创建自定义控件时想看看三个构造方法的区别于是乎引起了下文: 首先做个普及自定义控件和属性的具体流程直接上代码: 首先创建一个自己的类(控件名称) public class myView extends F...

找到组织
2013/11/20
3.5K
1
DataBinding使用指南及todoapp-databinding详解

版权声明:本文为博主原创文章,欢迎大家转载! 转载请标明出处: http://blog.csdn.net/guiying712/article/details/80206037,本文出自:【张华洋的博客】 数据绑定库 数据绑定库是一个支持...

guiying712
2018/05/05
0
0
preferenceActivity详解

首先从需求说起 即:现有某Activity专门用于手机属性设置 那么应该如何做呢? 根据已学知识 很快一个念头闪过 即:Activity + Preference 组合 前者用于界面构建 后者用于设置数据存放 其实 ...

月在青天
2013/12/29
0
0
[Android] XML Bitmap

XML Bitmap 是一个用XML定义的文件放在资源目录,定义的对象是图片,为bitmap定义别名,这个文件可以给bitmap定义一些额外的属性。例如:抖动。 文件存放位置: res/drawable/filename.xml 语...

枫兮兮
2014/02/11
0
0
Android Animations动画使用详解

一、动画类型 Android的animation由四种类型组成:alpha、scale、translate、rotate XML配置文件中 alpha 渐变透明度动画效果 scale 渐变尺寸伸缩动画效果 translate 画面转换位置移动动画效...

长平狐
2013/01/06
71
0

没有更多内容

加载失败,请刷新页面

加载更多

android6.0源码分析之Camera API2.0下的Preview(预览)流程分析

本文将基于android6.0的源码,对Camera API2.0下Camera的preview的流程进行分析。在文章android6.0源码分析之Camera API2.0下的初始化流程分析中,已经对Camera2内置应用的Open即初始化流程进...

天王盖地虎626
7分钟前
0
0
java 序列化和反序列化

1. 概述 序列恢复为Java对象的过程。 对象的序列化主要有两 首先我们介绍下序列化和反序列化的概念: 序列化:把Java对象转换为字节序列的过程。 反序列化:把字节序列恢复为Java对象的过程。...

edison_kwok
19分钟前
0
0
分布式数据一致性

狼王黄师傅
今天
1
0
经验

相信每位开发者在自己开发的过程中,都会反思一些问题,比如怎样提高编程能力、如何保持心态不砍产品经理、996 之后怎样恢复精力……最近开发者 Tomasz Łakomy 将他 7 年的开发生涯中学习到...

WinkJie
今天
4
0
从源码的角度来看SpringMVC

SpringMVC核心流程图 简单总结 首先请求进入DispatcherServlet 由DispatcherServlet 从HandlerMappings中提取对应的Handler 此时只是获取到了对应的Handle,然后得去寻找对应的适配器,即:H...

骚年锦时
今天
1
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部