<page xmlns="http://projectmallard.org/1.0/" type="topic" id="search" xml:lang="es">

  <info>

    <link type="guide" xref="patterns#primary"/>

    <desc>Buscar y filtrar contenido al escribir</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>Búsqueda</title>

<media type="image" mime="image/svg" src="figures/patterns/search.svg"/>

La búsqueda permite encontrar elementos de contenido filtrando el contenido que se muestra en la pantalla. Es diferente de otras búsquedas que implican mover o resaltar el contenido que se está buscando, en lugar de filtrarlo.

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

<title>Cuándo usarlas</title>

Proporcione una búsqueda siempre que se muestre una gran cantidad de contenido, y cuando los elementos de contenido tenga un componente de texto. Esto puede ser una colección de elementos de contenido actuales, tales como documentos, contactos o vídeos, o una lista de opciones.

La búsqueda es una gran manera para que los usuarios encuentren qué es lo que están buscando, y su disponibilidad es constante, lo que significa que los usuarios pueden confiar y esperar que esté presente.

Sin embargo, aunque que la búsqueda puede ser muy eficaz, y algunos usuarios la usarán, otros no. Por lo tanto, trate de proporcionar otros medios para encontrar los elementos con la búsqueda, en lugar de confiar exclusivamente en esta.

</section>

<section id="search-bar">

<title>La barra de búsqueda</title>

El estándar para buscar en GNOME 3 utiliza una barra de búsqueda especial que se desliza en la parte inferior de la barra de encabezado. En la ventana primaria, la barra de búsqueda esta típicamente oculta y la activa el usuario. Existen tres maneras de activar la búsqueda en este contexto:

<list>

<item>
Escribir cuando un campo de texto no tiene el foco debe activar la búsqueda, y el texto introducido se debe añadir al campo de búsqueda. Esto se llama «escribir para buscar».
</item>

<item>
El atajo de teclado para buscar (<keyseq><key>Ctrl</key><key>F</key></keyseq>).
</item>

<item>
Un botón de búsqueda en la barra de cabecera debe permitir que es muestre la barra de búsqueda (el botón de búsqueda debe conmutar).
</item>

</list>

Si búsqueda es el método principal para la búsqueda de contenido en su aplicación, puede hacer que la barra de búsqueda sea visible permanentemente, o visible cuando se inicia la aplicación por primera vez.

</section>

<section id="search-results">

<title>Resultado de la búsqueda</title>

<list>

<item>
La búsqueda debe ser inmediata siempre que sea posible; la vista del contenido se debe actualizar para mostrar los resultados de la búsqueda según se introducen.
</item>

<item>
Con el fin de ser eficaz, es importante que los resultados de la búsqueda se devuelvan rápidamente.
</item>

<item>
Si un término de búsqueda no devuelve ningún resultado, asegúrese de que la retroalimentación se dé en la vista de contenido. A menudo, una simple etiqueta «No hay resultados» es suficiente.
</item>

</list>

</section>

<section id="additional-guidance">

<title>Directrices adicionales</title>

<list>

<item>
Sea tolerante con los errores en los términos de búsqueda. Encontrar palabras mal escritas o terminología incorrecta es una manera de hacerlo. Mostrar sugerencias para coincidencias similares o contenido relacionado es otra manera.
</item>

<item>
Permita un amplio rango de términos de búsqueda coincidentes. Esto ayuda a la gente que no está segura del término exacto que necesitan, pero que conocen características asociadas con el elemento que quieren buscar. Una lista de ciudades puede devolver coincidencias por ciudad o región, por ejemplo.
</item>

<item>
Los resultados se deben ordenar de tal manera que se asegure que los resultados más relevantes se muestren primero.
</item>

</list>

</section>

<section id="api-reference">

<title>Referencia de la API</title>

<list>

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

</list>

</section>

</page>