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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Inhalte bei der Eingabe suchen und filtern</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>Christian Kirbach</mal:name>
      <mal:email>christian.kirbach@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>Mario Blättermann</mal:name>
      <mal:email>mario.blaettermann@gmail.com</mal:email>
      <mal:years>2016</mal:years>
    </mal:credit>
  </info>

<title>Suchen</title>

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

<p>Search allows content items to be located by filtering content that is displayed on screen. It is distinct from find, which involves moving or highlighting the content that is being searched for, rather than filtering.</p>

<section id="when-to-use">
<title>Anwendungsfälle</title>

<p>Provide search whenever a large collection of content is presented, and those content items have a textual component. This could be a collection of actual content items, such as documents, contacts or videos, or a list of options.</p>

<p>Search is a great way to make it easy for users to find what it is they are looking for, and its consistent availability means that users can rely on and expect it to be present.</p>

<p>However, while search can be highly effective, and some users will use it, others will not. Therefore, try to supplement other means for finding content items with search, rather than relying on it exclusively.</p>

</section>

<section id="search-bar">
<title>Die Suchleiste</title>

<p>The standard pattern for search in GNOME 3 utilizes a special search bar which slides down from beneath the header bar.

In primary windows, the search bar is typically hidden until it is activated by the user. There are three common ways to activate search in this context:</p>

<list>
<item><p>Typing when a text entry field is not focused should activate search, and the entered text should be added to the search field. This is called “type to search”.</p></item>
<item><p>Ein Tastenkürzel für die Suche (<keyseq><key>Ctrl</key><key>F</key></keyseq>).</p></item>
<item><p>A search button in the header bar should allow the search bar to be displayed (the search button should toggle).</p></item>
</list>

<p>Falls die Suche zu den primären Methoden zum Auffinden von Inhalten in Ihrer Anwendung gehört, sollten Sie die Suchleiste dauerhaft anzeigen, oder zumindest beim ersten Start der Anwendung.</p>

</section>

<section id="search-results">
<title>Suchergebnisse</title>

<list>
<item><p>Search should be “live” wherever possible — the content view should update to display search results as they are entered.</p></item>
<item><p>In order to be effective, it is important that search results are quickly returned.</p></item>
<item><p>Falls ein Suchbegriff keine Ergebnisse liefert, stellen Sie sicher, dass dennoch eine Rückmeldung in der Inhaltsansicht erfolgt. Oft genügt ein simples »No Results«.</p></item>
</list>

</section>

<section id="additional-guidance">
<title>Zusätzliche Richtlinien</title>

<list>
<item><p>Seien Sie nachsichtig gegenüber Fehlern in Suchbegriffen. Falsch geschriebene Eingaben oder inkorrekte Begriffe zu akzeptieren gehört dazu. Eine weitere Möglichkeit ist, Vorschläge für ähnliche Treffer oder verwandte Inhalte anzuzeigen.</p></item>
<item><p>Permit a broad range of matching search terms. This helps people who are unsure of the exact term they require but who do know characteristics associated with the item they want to find. A list of cities could return matches for country or region, for example.</p></item>
<item><p>Die Ergebnisse sollten so geordnet werden, dass das relevanteste Ergebnis zuerst angezeigt wird.</p></item>
</list>

</section>

<section id="api-reference">
<title>API-Referenz</title>
<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSearchEntry.html">GtkSearchEntry</link></p></item>
</list>
</section>

</page>
