<page xmlns="http://projectmallard.org/1.0/" type="topic" id="sidebar-lists" xml:lang="ru">

  <info>

    <link type="guide" xref="patterns#secondary"/>

    <desc>Navigation sidebar that contains a list</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/sidebar-list.svg"/>

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

Списки боковой панели используются в главных окнах, они могут быть открыто постоянно либо временно. Их также можно применять в диалоговых окнах.

Списки боковой панели можно использовать совместно с шаблонами <link xref="search">поиска</link> и <link xref="selection-mode">режима выделения</link>.

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

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

Используйте списки боковой панели, когда количество областей просмотра больше, чем может поместиться в стандартном <link xref="view-switchers">переключателе областей</link>.

Списки боковой панели могут заменить навигацию в браузерном стиле. При этом они обладают следующими преимуществами:

<list>

<item>
Если объекты имеют небольшую ширину и не требуют иммерсивного использования. По этой причине боковая панель не подходит для навигации по видео, но хорошо подходит для контактов.
</item>

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

<item>
Когда можно фильтровать набор объектов и таких фильтров много.
</item>

</list>

Для определённых областей просмотра в вашем приложении можно показывать списки временной боковой панели.

</section>

<section id="guidelines">

<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/GtkListBox.html">GtkListBox</link>
</item>

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

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

</list>

</section>

</page>