<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"/>

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.

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

<title>Kdy použít</title>

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.

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

</section>

<section id="search-bar">

<title>Vyhledávací lišta</title>

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:

<list>

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

<item>
Klávesovou zkratkou pro hledání (<keyseq><key>Ctrl</key><key>F</key></keyseq>).
</item>

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

</list>

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.

</section>

<section id="search-results">

<title>Výsledky hledání</title>

<list>

<item>
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ě zadáváno.
</item>

<item>
Aby to bylo účinné, je důležité získávat výsledky hledání rychle.
</item>

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

</list>

</section>

<section id="additional-guidance">

<title>Doplňující pokyny</title>

<list>

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

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

<item>
Výsledky by měly být řazeny takovým způsobem, který zajistí že nejrelevantnější položky budou zobrazeny jako první.
</item>

</list>

</section>

<section id="api-reference">

<title>Referenční příručka API</title>

<list>

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

</list>

</section>

</page>