summaryrefslogtreecommitdiffstats
path: root/docs/html/design/building-blocks/switches.jd
blob: d9cfd07fd3794b4b5ea8f769d420506408dae773 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
page.title=Switches
@jd:body

<p>Switches allow the user to select options. There are three kinds of switches: checkboxes, radio
buttons, and on/off switches.</p>
<h2 id="checkboxes">Checkboxes</h2>

<p>Checkboxes allow the user to select multiple options from a set. Avoid using a single checkbox to
turn an option off or on. Instead, use an on/off switch.</p>

  <img src="{@docRoot}design/media/switches_checkboxes.png">

<h2 id="radio-buttons">Radio Buttons</h2>

<p>Radio buttons allow the user to select one option from a set. Use radio buttons for exclusive
selection if you think that the user needs to see all available options side-by-side. Otherwise,
consider a spinner, which uses less space.</p>

  <img src="{@docRoot}design/media/switches_radios.png">

<h2 id="switches">On/off Switches</h2>

<p>On/off switches toggle the state of a single settings option.</p>

  <img src="{@docRoot}design/media/switches_switches.png">

<div class="note develop">
<p><strong>Developer Guide</strong></p>
  <p>For information about how to create these different switches,
  see the <a href="{@docRoot}guide/topics/ui/controls/checkbox.html">Checkboxes</a>,
  <a href="{@docRoot}guide/topics/ui/controls/radiobutton.html">Radio Buttons</a>, or
  <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">Toggle Buttons</a> API guides.</p>
</div>