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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Find and filter content by typing</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>Поиск</title>

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

<p>Поиск позволяет определять местоположение элементов содержимого, фильтруя видимое содержимое на экране. Этот шаблон отличается от обычного поиска, который подсвечивает искомое содержимое и позволяет перемещаться от одного найденного элемента к другому, тем, что при обычном поиске содержимое не фильтруется.</p>

<section id="when-to-use">
<title>Когда использовать</title>

<p>Предоставляйте поиск в тех случаях, когда на экран выводится большой набор элементов, причём элементы должны иметь текстовые составляющие. Это может быть набор документов, контактов, видео или параметров.</p>

<p>Поиск — это великолепное средство, с помощью которого пользователи могут находить интересующую их информацию. Принцип постоянной доступности поиска в приложениях GNOME подразумевает, что пользователи могут положиться на поиск и ожидают, что он реализован в приложении.</p>

<p>Несмотря на то, что поиск является эффективным инструментом, есть пользователи, которые его не применяют. Поэтому подумайте над альтернативными средствами отыскания содержимого.</p>

</section>

<section id="search-bar">
<title>Панель поиска</title>

<p>Стандартный шаблон для поиска в GNOME 3 использует специальную панель, которая появляется из-под заголовочной панели. В главных окнах рпнель поиска обычно скрыта до тех пор, пока пользователь её не активирует. В этом контексте есть три способа активации поиска:</p>

<list>
<item><p>Ввод текста активирует поиск, если фокус ввода не находится ни в одном из полей ввода. При этом введённый текст попадает в поле поиска.</p></item>
<item><p>Быстрая клавиша для поиска (<keyseq><key>Ctrl</key><key>F</key></keyseq>).</p></item>
<item><p>Кнопка поиска в заголовочной панели должна показывать или скрывать панель поиска (кнопка поиска работает как переключатель).</p></item>
</list>

<p>Если поиск является основным средством для определения местоположения содержимого в вашем приложения, панель поиска можно не скрывать или показывать её по умолчанию при первом запуске.</p>

</section>

<section id="search-results">
<title>Результаты поиска</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>Для эффективного использования приложения важно, чтобы результаты выводились максимально быстро.</p></item>
<item><p>If a search term does not return any results, ensure that feedback is given in the content view. Often a simple “No results” label is sufficient.</p></item>
</list>

</section>

<section id="additional-guidance">
<title>Дополнительные рекомендации</title>

<list>
<item><p>Будьте готовы к тому, что пользователь может совершить ошибку в искомом выражении. Вы можете проверять правописание и корректность терминологии. Вы также можете предложить схожий или связанный запрос.</p></item>
<item><p>Используйте широкий диапазон совпадения. Это поможет людям, которые не уверены в точности искомого выражения, но знают характеристики искомого объекта. Например, список городов может возвращать совпадения для стран или областей.</p></item>
<item><p>Результаты должны выводиться в порядке убывания релевантности.</p></item>
</list>

</section>

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

</page>
