<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="popovers" 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/popover.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>Janelas sobrepostas <em style="italic">(popovers)</em></title>

<p>Uma janela sobreposta é um contêiner temporário que aparece sobre sua janela pai em resposta a uma ação do usuário. Janela sobrepostas podem conter uma variedade de elementos da interface do usuário, incluindo botões, listas ou menus. Elas são frequentemente usadas como parte dos menus de botões ou menus de contexto.</p>

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

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

<p>Janelas sobrepostas podem ser usadas para revelar controles adicionais que nem sempre são necessários pelo usuário. Eles podem permitir que o usuário realize ações ou eles podem conter configurações e preferências. Eles são um elemento de interface muito flexível que se presta a soluções criativas de design.</p>

<p>Uma janela sobreposta deve sempre se relacionar a um elemento de interface específico que atua como a origem da janela sobreposta. Normalmente, isso é um botão ou um item de conteúdo. Quando eles são acionados por um botão, uma janela sobreposta pode ser usada como uma versão mais flexível de um menu de botões, permitindo que grupos de controles sejam acessados quando necessário. Exemplos disso incluem:</p>

<list>
<item><p>Revelar uma pequena caixa de ferramentas de controles de formatação de texto.</p></item>
<item><p>Uma interface de localização, com uma caixa de entrada de pesquisa e um espaço para uma lista de resultados.</p></item>
<item><p>Uma coleção de controles de visualização, como zoom, lista/grade e ordenação de conteúdo.</p></item>
</list>

<p>Como um mecanismo para divulgar controles ou informações adicionais, as janelas sobrepostas são semelhantes às <link xref="dialogs">janelas de diálogo</link>. Sua principal vantagem sobre os diálogos é que eles são menos perturbadores e têm um relacionamento próximo com um único elemento para o qual a janela sobreposta aponta. No entanto, você ainda deve considerar o uso de uma caixa de diálogo se desejar exibir grandes quantidades de informações ou combinações mais complexas de controles, ou se a situação exigir uma das convenções comuns para o uso de caixas de diálogo, como uma caixa de diálogo de confirmação.</p>

</section>

<section id="popover-content">
<title>Conteúdo da janela sobreposta</title>

<list>
<item><p>Uma janela sobreposta é um contêiner genérico e pode incluir uma ampla variedade de controles, como botões, controles deslizantes, listas, alternadores e campos de texto. No entanto, não misture muitos tipos diferentes de controle na mesma janela sobreposta e tente agrupar os controles do mesmo tipo.</p></item>
<item><p>As janelas sobrepostas podem funcionar como um contêiner para um menu ou para um menu em combinação com um pequeno número de controles complementares.</p></item>
<item><p>Se o propósito dos controles de uma janela sobreposta for ambíguo, esta pode receber um título.</p></item>
<item><p>Botões <gui>Close</gui> ou <gui>Done</gui> geralmente não são necessários em uma janela sobreposta.</p></item>
</list>

</section>


<section id="general-guidelines">
<title>Diretrizes gerais</title>

<p>As janelas sobrepostas sempre devem ser pequenos em tamanho (como regra geral, elas não devem cobrir mais de um terço de sua janela pai) e de baixa complexidade. Elas devem sempre aparecer como subordinadas a suas janelas pai.</p>
<p>Uma janela sobreposta só deve aparecer em resposta a uma ação do usuário e nunca deve aparecer de maneira surpreendente ou não intencional.</p>

</section>


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

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

</page>
