<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="switches" xml:lang="pt-BR">

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/switches.svg"/>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Georges Neto</mal:name>
      <mal:email>georges.stavracas@gmail.com</mal:email>
      <mal:years>2014,</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2017-2021</mal:years>
    </mal:credit>
  </info>

<title>Alternadores</title>

<p>Um alternador é um elemento de interface simples que possui um estado ativado e desativado.</p>

<media type="image" mime="image/svg" src="figures/ui-elements/switches.svg"/>

<section id="when-to-use">
<title>Quando usar</title>

<p>Os alternadores devem ser usados para controlar serviços ou hardware que tenham uma lógica de ativação/desativação clara. Eles são particularmente apropriados quando esses serviços ou hardware não são ativados imediatamente (p.ex., há um atraso entre a operação do comutador e seu efeito) ou quando afetam a operação do aplicativo de maneira significativa.</p>

<p>Quando o controle não ativa ou desativa uma função, ou quando uma função não tem claramente uma natureza ativada/desativada, uma <link xref="check-boxes">caixa de seleção</link> é uma opção mais apropriada. Por exemplo, um alarme pode ser controlado usando um alternador, pois ele pode ser ativado ou desativado. No entanto, uma caixa de seleção é a melhor opção para uma opção para repetir o alarme diariamente, pois a repetição do alarme é uma opção de configuração, em vez de iniciar ou interromper uma determinada peça de funcionalidade.</p>

<p>Em caso de dúvida, use opções importantes de configuração e marque as subopções secundárias.</p>

</section>

<section id="switch-labels">
<title>Rótulos de alternadores</title>

<p>Os rótulos de alternadores devem ser escritos usando <link xref="writing-style#capitalization">maiusculização de título</link>. O nome da função afetada pelo alternador deve ser usado como o rótulo. <gui>Automatic Location</gui> ou <gui>Notifications</gui> são exemplos de bons rótulos de alternadores.</p>

</section>

<section id="api-reference">
<title>Referência de API</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSwitch.html">GtkSwitch</link></p></item>
</list>

</section>

</page>
