1page.title=Showing Pop-Up Messages 2page.tags="Snackbar","Toast" 3helpoutsWidget=true 4trainingnavtop=true 5startpage=true 6 7@jd:body 8 9<div id="tb-wrapper"> 10<div id="tb"> 11 12<h2>Dependencies and prerequisites</h2> 13<ul> 14 <li><a href="{@docRoot}tools/support-library/features.html#design">Design 15 Support Library</a></li> 16</ul> 17 18 19<h2>You should also read</h2> 20<ul> 21 <li><a href="{@docRoot}training/implementing-navigation/index.html"> 22 Implementing Effective Navigation</a></li> 23 <li><a href="https://www.google.com/design/spec/components/snackbars-toasts.html"> 24 Material Design: Snackbars & toasts</a></li> 25</ul> 26 27</div> 28</div> 29 30<p> 31 There are many situations where you might want your app to show a quick 32 message to the user, without necessarily waiting for the user to respond. 33 For example, when a user performs an action like sending an email or deleting 34 a file, your app should show a quick confirmation to the user. Often the user 35 doesn't need to respond to the message. The message needs to be prominent 36 enough that the user can see it, but not so prominent that it prevents the 37 user from working with your app. 38</p> 39 40<p> 41 Android provides the {@link android.support.design.widget.Snackbar} widget 42 for this common use case. 43 A {@link android.support.design.widget.Snackbar} provides a quick pop-up 44 message to the user. The current activity remains visible and interactive 45 while the {@link android.support.design.widget.Snackbar} is displayed. After a 46 short time, the Snackbar automatically dismisses itself. 47</p> 48 49<p> 50 This class teaches you how to use {@link 51 android.support.design.widget.Snackbar} to show pop-up messages. 52</p> 53 54<div class="figure" style="width:400px"> 55 <img src="{@docRoot}images/training/snackbar/snackbar_drive_2x.png" 56 srcset="{@docRoot}images/training/snackbar/snackbar_drive.png 1x, 57 {@docRoot}images/training/snackbar/snackbar_drive_2x.png 2x" 58 width="400" alt=""> 59 <p class="img-caption"> 60 <strong>Figure 1.</strong> A {@link android.support.design.widget.Snackbar} 61 shows a message at the bottom of the 62 activity, but the rest of the activity is still usable. 63 </p> 64</div> 65 66<p class="note"> 67 <strong>Note:</strong> The {@link 68 android.support.design.widget.Snackbar} class supersedes {@link 69 android.widget.Toast}. While {@link android.widget.Toast} is currently still 70 supported, {@link android.support.design.widget.Snackbar} is now the 71 preferred way to display brief, transient messages to the user. 72</p> 73 74<h2>Lessons</h2> 75 76<dl> 77 <dt> 78 <b><a href="showing.html">Using a Snackbar to Show a Message</a></b> 79 </dt> 80 81 <dd> 82 Learn how to use a {@link android.support.design.widget.Snackbar} to display 83 a brief message to the user. 84 </dd> 85 86 <dt> 87 <b><a href="action.html">Adding an Action to a Message</a></b> 88 </dt> 89 90 <dd> 91 Learn how to add an action to a message, allowing the user to respond to 92 the message. 93 </dd> 94</dl> 95
