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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Filas de información o elementos de contenido.</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>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>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2011 - 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</title>

<p>Las listas son un elemento básico de la interfaz de usuario que se pueden utilizar para presentar información, elementos de contenido, o controles. Hay dos tipos principales de lista en GNOME 3: listas estándar y tablas.</p>

<p><link xref="sidebar-lists">Sidebar lists</link> are a separate design pattern which also make use of a list.</p>

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

<p>A list is an appropriate way to present content items that have a distinct name as their primary identifier. If the content is visual in nature, such as with photos or videos, you might want to consider using a <link xref="grids">grid</link> instead.</p>

<p>In some cases, it is advantageous to show both a list and a grid view for the same content items. Used in this way, a list view allows additional information to be displayed about the content through columns of information.</p>

</section>

<section id="standard-lists">
<title>Listas estándar</title>

<p>Standard lists are most common list type, and should generally be used in favor of tables.</p>

<p>In standard lists, each row is divided by separators, and changing the sort order is achieved by using a control outside the list itself.</p>

<section id="styles">
<title>Estilos</title>

<p>Standard lists have two styles: full-width and embedded. Full-width lists fill their container, while embedded lists are surrounded by padding.</p>

<p>Full-width lists are visually simpler, and therefore more elegant. They should be used where possible. At the same time, it is not always possible to use a full-width list, and there are some situations where embedded lists are a better choice:</p>

<list>
<item><p>When the list contains columns of information that need to be kept close together for readability purposes, and there is a need to have the list inside a wide container.</p></item>
<item><p>Cuando una ventana contiene varias listas.</p></item>
<item><p>Cuando la lista necesita estar alineada con otros controles dentro de la ventana.</p></item>
</list>

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

</section>

<section id="editable-lists">
<title>Listas editables</title>

<p>Editable lists allow a user to add or remove items from the list (for this reason, they are sometimes known as add/remove lists). Both full-width and embedded lists can be editable.</p>

<p>Each row contains a remove button. If the number of items is short, the final list row should be used as an add button. Alternatively, if the list is long, the add button can be placed in a <link xref="header-bars">header bar</link> or or <link xref="action-bars">action bar</link>.</p>

<media type="image" mime="image/svg" src="figures/patterns/editable-lists.svg"/>

</section>
</section>

<section id="tables">
<title>Tablas</title>

<p>Tables can be used for more complex multi-column lists, where sorting the table by a variety of columns is common. Column headers allow people to identify the type of information in each column and to reorder the list according to the content of each column.</p>

<p>Al usar encabezados de columnas, indicar el orden usando las flechas en el encabezado.</p>

<table>
<thead>
<tr>
<td><p>Orden</p></td>
<td><p>Dirección de la flecha</p></td>
<td><p>Ejemplo</p></td>
</tr>
</thead>
<tbody>
<tr>
<td><p>Natural</p></td>
<td><p>Abajo</p></td>
<td><p>Alfabético, número más pequeño primero, fecha más antigua primero, elementos marcados primero</p></td>
</tr>
<tr>
<td><p>Invertido</p></td>
<td><p>Arriba</p></td>
<td><p>Alfabético invertido, número más grande primero, fecha más reciente primero, elementos sin marcar primero</p></td>
</tr>
</tbody>

</table>

</section>

<section id="row-behavior">
<title>Comportamiento de la fila</title>

<p>Dependiendo del tipo de lista, las filas tienen diferente comportamiento cuando se pulsa o selecciona alguna con el botón del ratón. En este sentido, hay tres tipos de listas:</p>

<table>
<thead>
<tr>
<td><p>Tipo de lista</p></td>
<td><p>Comportamiento de la fila</p></td>
</tr>
</thead>
<tbody>
<tr>
<td><p>Navegación</p></td>
<td><p>Seleccionar una fila abre el elemento correspondiente, si se esta navegando a una nueva vista o si se está abriendo un cuadro de dialogo. Este patrón es común para listas de elementos de contenido, o para presentar grupos de configuraciones.</p></td>
</tr>
<tr>
<td><p>Seleccionar</p></td>
<td><p>El elemento de la lista se selecciona al pulsar en él. Este enfoque se usa comúnmente para seleccionar una de una serie de opciones de configuración. En el caso del <link xref="drop-down-lists">menú desplegable</link>, una opción se selecciona siempre. La fila seleccionada se indica con una marca.</p></td>
</tr>
<tr>
<td><p>Editar</p></td>
<td><p>Seleccionar la fila convierte a la fila en un campo de texto que permite que el elemento se edite.</p></td>
</tr>
</tbody>
</table>

<p>Los estilos de las listas de navegación pueden combinarse con la <link xref="selection-mode">función de selección</link> para permitir a abrir y manipular las filas a la vez. Debería evitarse usar una doble pulsación para abrir elementos de lista, pues es incompatible e irreconocible por la entrada táctil.</p>

</section>

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

<list>
<item><p>Distinga los diferentes tipos de información usando ajustes diferentes, <link xref="typography">colores de texto y grosor</link>. Resalte la información más importante y relevante dando a otra información un color y/o grosor más suaves.</p></item>
<item><p>Tenga cuidado de no saturar listas con elementos y columnas diferentes, y asegúrese de usarlas sólo para presentar información esencial.</p></item>
<item><p>Como regla general, evite usar muchas listas en la misma ventana, particularmente en ventanas primarias.</p></item>
<item><p>No use listas con menos de cinco elementos, a menos que el número de elementos pueda incrementar con el tiempo. Para listas de opciones, casillas de selección o botones de selección excluyentes se pueden utilizar como una alternativa en este caso.</p></item>
<item><p>Garantice que las listas están ordenadas de forma que sean útiles para aquellos que las están usando. Por ejemplo, documentos recientes podrían ser más útiles que documentos ordenados alfabéticamente, o contactos que podrían estar en línea ser más interesantes que aquellos que están desconectados.</p></item>
<item><p>Si no usa los iconos en su lista, <link xref="icons-and-artwork">use iconos simbólicos</link>. La menor impacto visual de estos iconos significará que ellos no dominan ni sobrecargan visualmente su lista.</p></item>
<item><p>Si la lista es larga, haga posible su búsqueda usando el <link xref="search">patrón de diseño de búsqueda</link> estándar.</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/GtkTreeView.html">GtkTreeView</link></p></item>
</list>
</section>

</page>
