android中xmlns:tools屬性詳解

今天讀到一篇總結的很是棒的文章，寫的邏輯很清晰也很實用，不多見到如此棒的文章了。就原文轉發過來，我把格式給整理了一下，分享給園子裏的各位朋友！很久沒寫博客了，就爲2015年的11月留份記念吧。但願對你有幫助！

    感謝原文做者的無私分享，原文地址：http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0309/2567.html

 

第一部分

安卓開發中，在寫佈局代碼的時候，ide能夠看到佈局的預覽效果。

可是有些效果則必須在運行以後才能看見，好比這種狀況：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標準屬性）。

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的完整包名

<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的位置）。

其實預覽窗口很是智能，若是佈局和一個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" />

 

tools:showIn 該屬性設置於一個被其餘佈局<include>的佈局的根元素上。這讓您能夠指向包含此佈局的其中一個佈局，在設計時這個被包含的佈局會帶着周圍的外部佈局被渲染。這將容許您「在上下文中」查看和編輯這個佈局。須要 Studio 0.5.8 或更高版本。