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

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <credit>
      <name>Calum Benson</name>
    </credit>
    <credit>
      <name>Adam Elman</name>
    </credit>
    <credit>
      <name>Seth Nickell</name>
    </credit>
    <credit>
      <name>Colin Robertson</name>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/radio-buttons.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>Botões de opção</title>

<p>Os botões de opção são usados em grupos para selecionar um conjunto mutuamente exclusivo de opções. Apenas um botão de opção dentro de um grupo pode ser definido a qualquer momento. Como nas caixas de seleção, não use botões de opção para iniciar ações.</p>

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

<section id="guidelines">
<title>Diretrizes</title>

<list>
<item><p>Use apenas botões de opção em grupos de pelo menos dois, nunca use um único botão de opção sozinho. Para representar uma única configuração, use uma caixa de seleção ou dois botões de opção, um para cada estado.</p></item>
<item><p>Exatamente um botão de opção deve ser definido no grupo em todos os momentos. A única exceção é quando o grupo está mostrando as propriedades de uma seleção múltipla, quando um ou mais dos botões podem estar em estado misto.</p></item>
<item><p>Clicar em um botão de opção não deve afetar os valores de outros controles. Pode sensibilizar, insensibilizar, ocultar ou mostrar outros controles, no entanto.</p></item>
<item><p>Se alternar um botão de opção afeta a sensibilidade de outros controles, coloque o botão de opção imediatamente à esquerda dos controles que ela afeta. Isso ajuda a indicar que os controles dependem do estado do botão de opção.</p></item>
<item><p>Use <link xref="writing-style#capitalization">maiusculização de frase</link> para rótulos de botões de opção, por exemplo <gui>Switched movement</gui>. Forneça uma <link xref="keyboard-input#access-keys">tecla de acesso</link> no rótulo que permita ao usuário definir o botão de opção diretamente do teclado.</p></item>
<item><p>Se o botão de opção representa uma configuração em uma seleção múltipla que é definida para alguns objetos na seleção e desativada para outros, mostre o botão de opção em seu estado misto.</p></item>
<item><p>Não coloque mais de cerca de oito botões de opção sob o mesmo título de grupo. Se você precisar de mais de oito, considere a possibilidade de usar uma lista de seleção única, mas provavelmente também precisa pensar em como simplificar sua interface de usuário.</p></item>
<item><p>Tente alinhar grupos de botões de opção verticalmente em vez de horizontalmente, pois isso facilita a varredura visual. Use alinhamentos horizontais ou retangulares somente se melhorarem grandemente o layout da janela.</p></item>
</list>

</section>

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

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

</section>
</page>
