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

  <info>
    <link type="guide" xref="patterns#secondary"/>
    <desc>Uma barra lateral de navegação que contém uma lista</desc>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <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>Listas de barra lateral</title>

<media type="image" mime="image/svg" src="figures/patterns/sidebar-list.svg"/>

<p>Uma lista da barra lateral permite que diferentes vistas sejam alternadas entre elas. Essas visualizações podem conter grupos de itens de conteúdo, itens de conteúdo únicos ou conjuntos de controles. A barra lateral divide a janela em dois, com o conteúdo sendo mostrado no painel oposto à barra lateral.</p>

<p>As listas da barra lateral podem ser usadas em janelas primárias, como um acessório permanente ou um elemento que é mostrado sob demanda. Eles também podem ser usados em janelas de diálogo.</p>

<p>As listas da barra lateral podem ser usadas em conjunto com os padrões de design de <link xref="search">pesquisa</link> e de<link xref="selection-mode">modo de seleção</link>.</p>

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

<p>Use uma lista da barra lateral quando for necessário expor um número maior de visões do que pode ser acomodado por um <link xref="view-switchers">alternador de visão</link> padrão.</p>

<p>As listas da barra lateral também fornecem uma alternativa possível à navegação no estilo do navegador. Elas têm várias vantagens aqui:</p>

<list>
<item><p>Quando os itens de conteúdo têm uma largura estreita e não exigem uma experiência imersiva. Uma barra lateral seria inadequada para a navegação de vídeos por esse motivo, mas é adequada aos contatos.</p></item>
<item><p>Quando os itens de conteúdo são dinâmicos. Para aplicativos de mensagens, onde novos itens de conteúdo aparecem ou os antigos são atualizados, uma lista de barra lateral permite que alguém visualize um item e, ao mesmo tempo, esteja ciente das atualizações da lista geral de mensagens.</p></item>
<item><p>Quando é possível filtrar uma coleção de conteúdo e há um grande número de filtros.</p></item>
</list>

<p>Listas da barra lateral temporária também podem ser exibidas para visualizações específicas em seu aplicativo.</p>

</section>

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

<list>
<item><p>Ordene a lista de acordo com o que é mais útil para os usuários do seu aplicativo. Geralmente, é melhor colocar itens atualizados recentemente no topo da lista.</p></item>
<item><p>Os controles de barra de cabeçalho que afetam a lista da barra lateral devem ser colocados na seção do painel de listas da barra de cabeçalho. Controles para pesquisa e seleção devem ser encontrados acima da lista.</p></item>
<item><p>Cada linha da lista pode incluir várias linhas de texto, bem como imagens. No entanto, tenha cuidado para garantir que as informações mais importantes não sejam perdidas e trabalhe para garantir uma aparência limpa e atraente.</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/GtkListBox.html">GtkListBox</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkScrolledWindow.html">GtkScrolledWindow</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkStackSidebar.html">GtkStackSidebar</link></p></item>
</list>
</section>

</page>
