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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Vyhledávání a filtrování obsahu psaním</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"/>
  </info>

<title>Vyhledávání</title>

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

<p>Vyhledání umožňuje najít položky obsahu pomocí filtrování obsahu, který je zobrazen na obrazovce. Liší se od běžného hledání, které místo filtrování provádí posun nebo zvýrazňování obsahu, ve kterém hledáte.</p>

<section id="when-to-use">
<title>Kdy použít</title>

<p>Vyhledávání poskytněte vždy, když je předkládána rozsáhlá sada obsahu a položky tohoto obsahu mají textovou část. Může jít o sadu aktuálních položek obsahu, jako jsou dokumenty, kontakty nebo videa, nebo o seznam voleb.</p>

<p>Vyhledávání je skvělý způsob, jak uživateli usnadnit nalezení toho, co hledá a je také konzistentní se zbytkem GNOME, což znamená, že uživatel se na něj může spoléhat a očekává, že jej bude mít k dispozici.</p>

<p>Přestože je vyhledávání velmi účinný postup a řada uživatelů jej používá, najdou se i tací, kteří jej nepoužívají. Proto zkuste vedle vyhledávání podporovat i jiné způsoby, jak najít požadovaný obsah, a nespoléhejte jen výhradně na něj.</p>

</section>

<section id="search-bar">
<title>Vyhledávací lišta</title>

<p>Standardní návrhový vzor pro vyhledáván v GNOME 3 používá speciální vyhledávací lištu, která vyjíždí zpoza hlavičkové lišty. V hlavním okně bývá vyhledávací lišta obvykle skrytá, dokud ji uživatel neaktivuje. V této souvislosti existují tři běžné způsoby, jak hledání aktivovat:</p>

<list>
<item><p>Když není zaměřeno žádné textové pole, mělo by psaní aktivovat funkci hledání a zadávaný text by se měl přidat do vyhledávacího pole. Nazývá se to „hledání psaním“.</p></item>
<item><p>Klávesovou zkratkou pro hledání (<keyseq><key>Ctrl</key><key>F</key></keyseq>).</p></item>
<item><p>Vyhledávací tlačítko v hlavičkové liště by mělo umožnit zobrazení vyhledávací lišty (a mělo by fungovat jako přepínací).</p></item>
</list>

<p>V případě, že je hledání hlavním cestou pro nalezení obsahu ve vaší aplikaci, můžete vyhledávací lištu ponechat trvale viditelnou nebo ji aspoň zobrazit při prvním spuštění aplikace.</p>

</section>

<section id="search-results">
<title>Výsledky hledání</title>

<list>
<item><p>Kdykoliv je to možné, mělo by být vyhledávání „živé“ – zobrazení obsahu by se mělo aktualizovat, aby odráželo výsledky hledání tak, jak je průběžně měněno zadání.</p></item>
<item><p>Aby to bylo účinné, je důležité získávat výsledky hledání rychle.</p></item>
<item><p>V případě, že hledaný výraz nevrátí žádné výsledky, zajistěte zpětnou vazbu v zobrazení obsahu. Často dostačuje prostý popisek „No results“ („Žádné výsledky“).</p></item>
</list>

</section>

<section id="additional-guidance">
<title>Doplňující pokyny</title>

<list>
<item><p>Buďte tolerantní k chybám ve vyhledávaných výrazech. Vyrovnat se s překlepy nebo nesprávnou terminologií je jedna možnost. Druhou je nabízet návrhy na věci podobné tomu co uživatel hledá nebo obsah, který s k tomu nějak vtahuje.</p></item>
<item><p>Povolte volnější shodu při porovnávání s vyhledávaným výrazem. Pomůže to lidem, kteří si nejsou úplně jistý přesným výrazem, který potřebují, ale znají vlastnosti spojené s položkou, kterou chtějí najít. Například seznam měst by mohl vracet vyhovující země nebo regiony.</p></item>
<item><p>Výsledky by měly být řazeny takovým způsobem, který zajistí že nejrelevantnější položky budou zobrazeny jako první.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referenční příručka API</title>
<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSearchEntry.html">GtkSearchEntry</link></p></item>
</list>
</section>

</page>
