diff options
author | Katie McCormick <kmccormick@google.com> | 2013-11-18 11:02:42 -0800 |
---|---|---|
committer | Katie McCormick <kmccormick@google.com> | 2013-11-18 15:27:41 -0800 |
commit | 9dd04e720a58887a1c8d729e74fe8fb9295d4492 (patch) | |
tree | 8a1cd5c1d7e54e6fbf102d810e3e6b0c896215a4 /docs/html/training | |
parent | 63cd3802008010008aebc3a7a5d9fdf432cf0b5a (diff) | |
download | frameworks_base-9dd04e720a58887a1c8d729e74fe8fb9295d4492.zip frameworks_base-9dd04e720a58887a1c8d729e74fe8fb9295d4492.tar.gz frameworks_base-9dd04e720a58887a1c8d729e74fe8fb9295d4492.tar.bz2 |
Doc update: minor changes to immersive lesson
Change-Id: I4b830b1de6f92c7f5f0f1106f2f797bb891d73e2
Diffstat (limited to 'docs/html/training')
-rw-r--r-- | docs/html/training/system-ui/immersive.jd | 24 |
1 files changed, 6 insertions, 18 deletions
diff --git a/docs/html/training/system-ui/immersive.jd b/docs/html/training/system-ui/immersive.jd index 21672c8..0a1516c 100644 --- a/docs/html/training/system-ui/immersive.jd +++ b/docs/html/training/system-ui/immersive.jd @@ -11,8 +11,8 @@ trainingnavtop=true <h2>This lesson teaches you to</h2> <ol> <li><a href="#compare">Choose an Approach</a></li> - <li><a href="#nonsticky">Use IMMERSIVE</a></li> - <li><a href="#sticky">Use IMMERSIVE_STICKY</a></li> + <li><a href="#nonsticky">Use Non-Sticky Immersion</a></li> + <li><a href="#sticky">Use Sticky Immersion</a></li> </ol> @@ -72,14 +72,6 @@ again after a few moments, you can instead use the shown in this mode are in a transient state. </p> - <p>When you use {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE IMMERSIVE} or - {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY IMMERSIVE_STICKY}, - the system UI stays hidden, even while users are interacting with your -app or game. You can capture touch events from anywhere across the screen, even areas that -would otherwise be occupied by the system bars. This gives you a great way to create a -larger, richer, more <a href="{@docRoot}design/patterns/fullscreen.html"> -immersive</a> UI in your app or game and reduce visual distraction at the same time.</p> - <p>Figure 1 illustrates the different "immersive mode" states:</p> <img src="{@docRoot}images/training/imm-states.png" @@ -137,12 +129,8 @@ if you use them in conjunction with {@link android.view.View#SYSTEM_UI_FLAG_HIDE <p>The flags {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE} and {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY} both provide an immersive - experience. But whereas the - {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY IMMERSIVE_STICKY} - flag causes semi-transparent system bars to briefly show and then hide again in response to - a swipe gesture, the same swipe gesture causes the system bars to reappear and remain - visible if you instead use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE IMMERSIVE} - flag. Here are examples of when you would use one vs. the other:</p> + experience, but with the differences in behavior described above. Here are + examples of when you would use one flag vs. the other:</p> <ul> <li>If you're building a book reader, news reader, or a magazine, use @@ -171,7 +159,7 @@ Android 4.0 (API Level 14). For this type of app, simply using sufficient. Don't use the "immersive" flags in this case.</li> </ul> -<h2 id="nonsticky">Use IMMERSIVE</h2> +<h2 id="nonsticky">Use Non-Sticky Immersion</h2> <p>When you use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE} flag, it hides the system bars based on what other UI flags you have set @@ -242,7 +230,7 @@ For more discussion of these topics, watch the video <a class ="external-link" href="http://www.youtube.com/embed/cBi8fjv90E4">DevBytes: Android 4.4 Immersive Mode</a>.</p> -<h2 id="sticky">Use IMMERSIVE_STICKY</h2> +<h2 id="sticky">Use Sticky Immersion</h2> <p>When you use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY} flag, an inward swipe in the system bars areas causes the bars to temporarily appear in a |