<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 - 2017</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>Benjamí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"/>

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.

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.

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>.

<section id="when-to-use">

<title>Cuándo usarlas</title>

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.

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

<list>

<item>
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.
</item>

<item>
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.
</item>

<item>
Cuando es posible filtrar una colección por contenido, y hay un gran número de filtros.
</item>

</list>

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

</section>

<section id="guidelines">

<title>Guías</title>

<list>

<item>
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.
</item>

<item>
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.
</item>

<item>
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.
</item>

</list>

</section>

<section id="api-reference">

<title>Referencia de la API</title>

<list>

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

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

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

</list>

</section>

</page>