File: header-bars.page

package info (click to toggle)
gnome-devel-docs 40.3-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 79,188 kB
  • sloc: javascript: 2,514; xml: 2,407; ansic: 2,229; python: 1,854; makefile: 805; sh: 499; cpp: 131
file content (78 lines) | stat: -rw-r--r-- 6,551 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<?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>