<?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>Window controls — header bars allow windows to be moved by dragging, include window control buttons (typically a single close button), and provide access to a window controls menu.</p></item>
<item><p>Headings — a key role of a header bar is to provide context for the content of the window, either through a heading or view switcher.</p></item>
<item><p>Controls — header bars provide a place for key controls, typically in the form of buttons.</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>Ensure that your header bar only contains a small number of key controls — this will help users to understand the primary functionality provided by the window, and will ensure that the window can be resized to narrow widths.</p>

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

</section>

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

<p>A header bar can — and should — update along with view or mode changes. This ensures that header bar controls are always relevant to the current context.</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>Arrange controls within the header bar according to the three alignment points described in the <link xref="visual-layout">visual layout guidelines</link> — left, center and right.</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>
