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

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

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

<title>Когда использовать</title>

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

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

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

</section>

<section id="search-bar">

<title>Панель поиска</title>

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

<list>

<item>
Ввод текста активирует поиск, если фокус ввода не находится ни в одном из полей ввода. При этом введённый текст попадает в поле поиска.
</item>

<item>
Быстрая клавиша для поиска (<keyseq><key>Ctrl</key><key>F</key></keyseq>).
</item>

<item>
Кнопка поиска в заголовочной панели должна показывать или скрывать панель поиска (кнопка поиска работает как переключатель).
</item>

</list>

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

</section>

<section id="search-results">

<title>Результаты поиска</title>

<list>

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

<item>
Для эффективного использования приложения важно, чтобы результаты выводились максимально быстро.
</item>

<item>
Если искомое выражение не возвращает каких-либо результатов, в содержимом необходимо зафиксировать этот факт, например поместить простую текстовую метку «Ничего не найдено».
</item>

</list>

</section>

<section id="additional-guidance">

<title>Дополнительные рекомендации</title>

<list>

<item>
Будьте готовы к тому, что пользователь может совершить ошибку в искомом выражении. Вы можете проверять правописание и корректность терминологии. Вы также можете предложить схожий или связанный запрос.
</item>

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

<item>
Результаты должны выводиться в порядке убывания релевантности.
</item>

</list>

</section>

<section id="api-reference">

<title>API reference</title>

<list>

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

</list>

</section>

</page>