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

  <info>
    <link type="guide" xref="patterns#secondary"/>
    <desc>Barra lateral de navegación que contiene una 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>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2011 - 2021</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alex Puchades</mal:name>
      <mal:email>alex94puchades@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Nicolás Satragno</mal:name>
      <mal:email>nsatragno@gnome.org</mal:email>
      <mal:years>2013</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Benjamín Valero Espinosa</mal:name>
      <mal:email>benjavalero@gmail.com</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jorge González</mal:name>
      <mal:email>jorgegonz@svn.gnome.org</mal:email>
      <mal:years>2009</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rosa Elena Pérez</mal:name>
      <mal:email>rozydicemiau@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>Oscar Rafael Arachi</mal:name>
      <mal:email>arachi910@gmail.com</mal:email>
      <mal:years>2014 - 2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Miguel Ajuech</mal:name>
      <mal:email>miguel.ann.28@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>Adrián Pérez Domínguez</mal:name>
      <mal:email>adrian@aztli.org</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Celina Osorio Ochoa</mal:name>
      <mal:email>chelinoska@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Dario Amigon Espinoza</mal:name>
      <mal:email>daramigon@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Yenisei Ramírez Pérez</mal:name>
      <mal:email>yeniseirape@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>José Roberto Ramíres Mendoza</mal:name>
      <mal:email>aczella@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bernardo Sánchez Romero</mal:name>
      <mal:email>b.sanchez.rom@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Emmanuel Márquez Juárez</mal:name>
      <mal:email>resident3333@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>David Romero Serrano</mal:name>
      <mal:email>lemi136@hotmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Omar Garcia Guzman</mal:name>
      <mal:email>garciag.omar91@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Edilberto Huerta Niño</mal:name>
      <mal:email>edilberto.huerta0290@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  </info>

<title>Listas en barras laterales</title>

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

<p>Una lista en barra lateral permite cambiar entre diferentes vistas. Estas vistas pueden contener grupos de elementos de contenido, elementos de contenido único o conjuntos de controles. La barra lateral divide la ventana en dos, con contenido que se empieza a mostrar en el panel opuesto a la barra lateral.</p>

<p>Las listas en barras laterales se pueden usar en ventanas primarias, como un elemento fijo o como un elemento que se muestra bajo demanda. También se pueden usar en ventanas de diálogo.</p>

<p>Las listas de barra lateral se puede usar junto con los patrones de diseño de <link xref="search">buscar</link> y de <link xref="selection-mode">modo de selección</link>.</p>

<section id="when-to-use">
<title>Cuándo usarlas</title>

<p>Use una lista de barra lateral cuando sea necesario mostrar un gran número de vistas que se pueden colocar con un <link xref="view-switchers">intercambiador de vistas</link> estándar.</p>

<p>Las listas de barra lateral también proporcionan una alternativa posible a la navegación de tipo explorador. Aquí tienen varias ventajas:</p>

<list>
<item><p>Cuando los elementos de contenido son estrechos y no necesitan una experiencia inmersiva. Una barra lateral puede no ser apropiada para explorar vídeos por esta razón, pero sí es adecuada para contactos.</p></item>
<item><p>Cuando los elementos de contenido son dinámicos. Para aplicaciones de mensajería, cuando el nuevo elemento de contenido aparece o se actualizan los antiguos, una lista de barra lateral proporciona la posibilidad de ver un elemento mientras se está pendiente de las actualizaciones de toda la lista de mensajes.</p></item>
<item><p>Cuando es posible filtrar una colección por contenido, y hay un gran número de filtros.</p></item>
</list>

<p>También se pueden mostrar listas de barra lateral temporales, para determinadas vistas en su aplicación.</p>

</section>

<section id="guidelines">
<title>Guías</title>

<list>
<item><p>Ordene la lista de acuerdo a qué es más importante para los usuarios de su aplicación. A menudo, lo mejor es colocar lo actualizado más recientemente en la parte superior de la lista.</p></item>
<item><p>Los controles de la barra de cabecera que afectan a la lista de barra lateral se deben colocar en la sección del panel de la lista de la barra de cabecera. Los controles para buscar y seleccionar deben estar encima de la lista.</p></item>
<item><p>Cada fila de la lista puede incluir varias líneas de texto, así como imágenes. Sin embargo, asegúrese de que la información más importante no se pierde, y trabaje para asegurar un aspecto limpio y claro.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referencia de la 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>
