Android Navigation xml属性研究

xml文件中控制navigation动作。
文件位置:res/navigation/filename.xml
语法:

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    app:startDestination="@[+]id/name">
 <fragment
        android:id="@+id/name"
        android:name="[package:].name"
        android:label="String"
        tools:layout="@layout/layout_name" >
        <action
            android:id="@+id/name"
            app:destination="@id/name" 
            app:launchSingleTop="[true|false]"
            app:launchDocument="[true|false]"
            app:clearTask="[true|false]"
            app:popUpTo="@id/name"
            app:popUpToInclusive="[true|false]"
            app:enterAnim="@anim/slide_in_right"
            app:exitAnim="@anim/slide_out_left"
            app:popEnterAnim="@anim/slide_in_left"
            app:popExitAnim="@anim/slide_out_right"/>
 </fragment>

 <fragment
        android:id="@+id/name"
        android:name="[package:].name"
        android:label="String"
        tools:layout="@layout/layout_name" />
</navigation>

在使用过程中,使用最多的就是action标签,所以主要就分析它。

1、<navigation>

属性:
app:startDestination="@[+]id/name"
这就是代表一启动显示哪个元素,我这里使用的是fragment,所以后面的id填写的就是下面某个fragment的id,这样默认就会先显示这个fragment

2、<fragment>

属性:
android:id
id就是给这fragment取的唯一标识

android:name
这里填写的内容是你这个fragment的路径,这样系统才能通过这路径找到fragment类的实现(包名+具体fragment的类名)

android:label
给这fragment一标签,在有actionBar的情况下actionBar上的title会显示标签内容

3、<action>

属性:
android:id
给这action设置唯一标识

app:destination
这是这个action要跳转的目的地,需要填写上目的地的id。每一次跳转,会产生一个新的实例(Fragment1@01>Fragment1@02),这时Fragment1@01实例不会被销毁,只执行到onFragmentViewDestroyed

app:launchSingleTop
这是在跳转本身时保存单实例,就是说F1跳转F1,虽然会产生一个新的实例(Fragment1@01>Fragment1@02),但Fragment1@01实例会被销毁。Fragment1@01>Fragment2@02>Fragment1@03,这样的跳转不会起作用,Fragment1@01实例依旧存在。

app:launchDocument
具体效果不是很清楚,推荐过时

As per the {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} documentation, it is recommended to use {@link android.R.attr#documentLaunchMode} on an Activity you wish to launch as a new document.

这属性使用的官方翻译:

Launch a navigation target as a document if you want it to appear as its own entry in the system Overview screen. If the same document is launched multiple times it will not create a new task, it will bring the existing document task to the front.
<p>If the user presses the system Back key from a new document task they will land on their previous task. If the user reached the document task from the system Overview screen they will be taken to their home screen.</p>
如果您想让导航目标作为自己的条目出现在系统概述屏幕上,那么就将其作为文档启动。如果同一文档被多次启动,它将不会创建新的任务,它将把现有的文档任务放在前面。
<P>如果用户从一个新的文档任务中按下系统返回键,他们将在之前的任务中着陆。如果用户从系统概述屏幕到达文档任务,则会将其带到主屏幕</p>

app:clearTask
为true会清空栈中的元素。Fragment1@01>Fragment2@02>Fragment3@03,
这时Fragment3启动Fragment4的action设置这标记为true(Fragment3@03>Fragment4@04),此时Fragment1、Fragment2、Fragment3实例统统销毁,栈中只存Fragment4@04。官方不推荐,推荐使用app:popUpTo="@id/name" app:popUpToInclusive="[true|false]"这两属性组合。

app:popUpTo
这是出栈直到某个元素。Fragment1@01>Fragment2@02>Fragment3@03,在Fragment3启动Fragment4时设置出栈到Fragment1,那栈中的Fragment2,Fragment3会出栈销毁,只存Fragment1和Fragment4。

app:popUpToInclusive
这属性配合app:popUpTo使用,用来判断到达指定元素时是否把指定元素也出栈。同样上面的例子,true的话Fragment1也会出栈销毁,栈中只存留Fragment4。

app:enterAnim="@anim/slide_in_right"
app:exitAnim="@anim/slide_out_left"
app:popEnterAnim="@anim/slide_in_left"
app:popExitAnim="@anim/slide_out_right"
前两个是移动到目的地的动画,后两个是离开目的地的动画。
举个例子:Fragment1跳转Fragment2
app:enterAnim是这个action目的地进入的动画,是Fragment2入场的动画。
app:exitAnim是这个action所在元素离开的动画,是Fargment1离场的动画。
app:popEnterAnim是这个按下返回动作,目的地出栈时,action所在元素入场的动画,是Fargment1入场的动画。
app:popExitAnim是这个按下返回动作,目的地出栈时离开的动画,是Fragment2离场的动画。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,367评论 6 512
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,959评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,750评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,226评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,252评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,975评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,592评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,497评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,027评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,147评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,274评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,953评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,623评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,143评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,260评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,607评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,271评论 2 358

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,225评论 25 707
  • 面试必背 会舍弃、总结概括——根据我这些年面试和看面试题搜集过来的知识点汇总而来 建议根据我的写的面试应对思路中的...
    luoyangzk阅读 6,760评论 6 173
  • 持续一个学期的书法课结束了,可偏偏在这最末了的时候,遇到了一个人,he is so smart in my eye...
    tttop迪阅读 259评论 0 0
  • 更详细的讲解和代码调试演示过程,请参看视频Linux kernel Hacker, 从零构建自己的内核 前几节,我...
    望月从良阅读 667评论 0 2
  • 这本来就是喜剧片,看得我竟然变成泪人,还是说我的泪点太低了吗?出门都忘记带纸巾了,纸巾没有,那些泪水像是开着水龙头...
    月凡尘阅读 639评论 3 8