<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="sidebar-lists" 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>
    <license xmlns="http://projectmallard.org/1.0/" href="http://creativecommons.org/licenses/by-sa/4.0/">

  <p>This work is licensed under a
  <link href="http://creativecommons.org/licenses/by-sa/4.0/">Creative
  Commons Attribution-Share Alike 4.0 International License</link>.</p>

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