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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Element that runs along the top of windows</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/header-bar.svg"/>

<p>Заголовочная панель это горизонтальный элемент, который помещается в верхнюю часть окна. Заголовочные панели выполняют следующие задачи:</p>

<list>
<item><p>Управление окнами. Заголовочная панель предоставляет доступ к окну: с помощью неё можно перетаскивать окно, панель также содержит кнопки управления окном (которые обычно представлены одной единственной кнопкой для закрытия окна).</p></item>
<item><p>Заголовок. Главная задача заголовочной панели предоставить контекст для содержимого окна, это можно реализовать с помощью заголовка или переключателя вида.</p></item>
<item><p>Управляющие элементы. Заголовочные панели включают в себя ключевые элементы управления, которые чаще всего реализуются в виде кнопок.</p></item>
</list>

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

<p>Рекомендуется использовать заголовочные панели для всех окон приложения. Заголовочные панели обладают рядом преимуществ перед традиционной связкой, состоящей из заголовка, меню и панели инструментов: панель заголовка экономит место по вертикали, а также предоставляет функции динамической навигации и изменения режимов (например с помощью <link xref="selection-mode">режима выделения</link>).</p>

<p>Заголовочные панели несовместимы с панелями меню. Если в вашем приложении уже есть панель меню, рассмотрите возможность применения альтернативного решения, предложенного в этом руководстве. Подробнее см. рекомендации по использовании <link xref="menu-bars">панели меню</link>.</p>

</section>

<section id="controls">
<title>Управляющие элементы</title>

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

<p>Заголовочная панель должна включать в себя минимально необходимое количество ключевых управляющих элементов. Во-первых, пользователям будет проще использовать главную функциональность, предоставляемую главным окном, а во-вторых, при изменении размеров окна, его можно сделать узким.</p>

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

</section>

<section id="dynamic">
<title>Заголовочные панели должны быть динамичными</title>

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

<p>Если в окне используется несколько режимов просмотра (например с помощью <link xref="view-switchers">переключателя вида</link>), заголовочная панель может содержать различные управляющие элементы для каждого режима просмотра.</p>

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

</section>

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

<list>
<item><p>Контекст заголовочной панели должен всегда соответствовать окну панели. Это позволяет идентифицировать окно и пояснить, что именно изображено в самом окне. Это можно сделать, поместив заголовок по центру заголовочной панели или добавив <link xref="view-switchers">переключатель вида</link>.</p></item>
<item><p>Располагайте управляющие элементы в заголовочной панели по трём соответствующим точкам выравнивания, описанным в разделе <link xref="visual-layout">визуальное расположение</link> -- слева, по центру и справа.</p></item>
<item><p>Кнопки <gui>Создать</gui> и <gui>Назад</gui> размещайте в левой части заголовочной панели.</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/GtkHeaderBar.html">GtkHeaderBar</link></p></item>
</list>

</section>

</page>
