Руководство по параметрам приложений

Параметры приложения — это настраиваемые пользователем части приложения Windows, доступ к ней через выделенную страницу параметров. Например, в приложении для чтения новостей пользователи могут указать источники новостей, которые необходимо отображать, или количество отображаемых на экране столбцов, а в приложении прогноза погоды — выбрать между шкалой Цельсия или Фаренгейта. В этой статье приведены рекомендации и лучшие практики по созданию и отображению параметров приложения в приложениях WinUI.

Когда следует предоставлять страницу параметров

Вот примеры опций, которые находят место на странице настроек приложения.

• Параметры конфигурации, которые влияют на поведение приложения и не требуют частой перенастройки, как, например, выбор между Цельсием или Фаренгейтом в качестве единиц измерения температуры по умолчанию в приложении погоды, изменение параметров учетной записи в почтовом приложении, параметры уведомлений или опции доступности.
• Параметры, зависящие от настроек пользователя, таких как музыка, звуковые эффекты или цветовые темы.
• Сведения о приложении, к которым не обращаются очень часто, например политика конфиденциальности, справка, версия приложения или сведения об авторских правах.

Команды, которые являются частью типичного рабочего процесса приложения (например, изменение размера кисти в приложении искусства) не должны находиться на странице параметров. Дополнительные сведения о размещении команд см. в разделе "Основы проектирования команд".

Общие рекомендации

• Оставьте страницы параметров простыми и используйте двоичные элементы управления (вкл./выкл.). Тумблер обычно является наилучшим средством управления для двоичного параметра.
• Для параметров, которые позволяют пользователям выбирать один элемент из до пяти взаимоисключающих, связанных опций, используйте радио-кнопки.
• Создайте точку входа для всех параметров приложения на странице параметров приложения.
• Оставьте параметры простыми. Определите интеллектуальные значения по умолчанию и оставьте минимальное количество параметров.
• Когда пользователь изменяет параметр, приложение должно немедленно отражать изменения.
• Не включать команды, которые являются частью общего рабочего процесса приложения.

Точка входа

Способ доступа пользователей к странице параметров приложения должен зависеть от макета приложения.

Панель навигации

Для макета NavigationView параметры приложения должны быть последним элементом в списке вариантов навигации и закреплены внизу. NavigationView предоставляет встроенный элемент параметров для этой цели — установите свойство IsSettingsVisible для true автоматического отображения записи "Параметры " в нижней части панели навигации.

Панель команд

Если вы используете панель команд или панель инструментов, поместите точку входа параметров в качестве одного из последних элементов в меню переполнения «Дополнительно». Если для вашего приложения важна высокая обнаруживаемость точки входа в настройки, поместите ее непосредственно на панель команд, а не в список переполнения.

Макет

Страница параметров приложения должна открыть весь экран и заполнить все окно. Используйте прокручиваемый макет с ограниченной максимальной шириной (около 1000–1100 пикселей), чтобы содержимое оставалось доступным для чтения на широких дисплеях. Группировать связанные параметры в заголовках разделов с помощью стиля текста BodyStrong .

Используйте элементы управления SettingsCard и SettingsExpander из набора средств сообщества Windows Community Toolkit для создания страницы параметров. Эти элементы обеспечивают согласованный и доступный макет с заголовком, описанием, значком и элементом для действий, размещённым справа от карточки.

Полные примеры реализации см. на странице параметров коллекции WinUI Gallery и примере элемента управления SettingsControls из Windows Community Toolkit.

КартаНастроек

Используйте SettingsCard для отдельных параметров. Каждая карточка содержит заголовок, необязательное описание, необязательную иконку заголовка и элемент управления действием (например, ToggleSwitch, ComboBox или Button), размещённый в качестве содержимого карточки. Установка свойства IsClickEnabled на true делает всю карточку кликабельной, что полезно для элементов в стиле навигации.

РасширительНастроек

Используйте SettingsExpander, когда параметр имеет поднастройки, которые должны быть показаны по запросу. Расширитель показывает основной элемент управления для действий в строке заголовка и дополнительные SettingsCard элементы внутри Items коллекции. Это позволяет сохранить страницу компактной, при этом отображая дополнительные возможности. Избегайте вложенных расширений более глубоко, чем один уровень.

Параметры темы приложения

Если приложение позволяет пользователям выбирать цветовой режим, представьте эти параметры с помощью поля со списком внутри SettingsCardконтейнера. Опции должны быть представлены следующим образом:

• Свет
• Темный
• Использование системного параметра

Вы также можете добавить гиперссылку на страницу «Цвета» в разделе «Параметры» Windows, где пользователи могут получить доступ к текущему режиму интерфейса по умолчанию и изменить его. Используйте строку "параметры цвета Windows" для текста гиперссылки и ms-settings:colors для URI.

Сведения о разделе

Мы рекомендуем разместить раздел About в нижней части страницы параметров с помощью раздела SettingsExpander. Свернутая строка заголовка должна отображать имя приложения, значок и номер версии. Расширенная область может включать:

• Ссылка на репозиторий или веб-сайт приложения.
• Ссылка на ошибки файлов или функции запроса.
• Список зависимостей и ссылок как элементов управления КнопкаСсылки.
• Юридическая информация, например уведомление об авторских правах, ссылки на условия использования и заявление о конфиденциальности.

Рекомендуемое содержимое страницы

После получения списка элементов, которые вы хотите включить на странице параметров приложения, рассмотрите следующие рекомендации:

• Группировать аналогичные или связанные параметры в одном заголовке раздела.

• Попробуйте сохранить общее количество параметров не более четырех или пяти.

• Отображение одинаковых параметров независимо от контекста приложения. Если некоторые параметры не имеют значения в определенном контексте, отключите SettingsCard, установив IsEnabled на false.

• Используйте описательные однословные названия для заголовков параметров. Например, присвойте параметру "Учетные записи" вместо "Параметры учетной записи" для параметров, связанных с учетной записью.

• Если параметр напрямую ссылается на Интернет, используйте кликабельный элемент SettingsCard с IsClickEnabled="True" и соответствующим значком действия, чтобы указать внешнюю навигацию.

• Объедините менее используемые параметры в SettingsExpander, чтобы общие параметры могли иметь свои собственные SettingsCard. Поместите содержимое или ссылки, содержащие только сведения в разделе "О".

• При необходимости отображается содержимое сверху вниз в одном столбце, можно прокручивать.

• Используйте следующие элементы управления для параметров приложения:

  • Переключатели: Чтобы разрешить пользователям устанавливать значения включено или выключено.
  • Переключатели. Чтобы разрешить пользователям выбирать один элемент из набора до 5 взаимоисключающих, связанных параметров.
  • Комбинированные списки: Позволяют пользователям выбирать из набора параметров в компактном раскрывающемся списке.
  • Текстовые поля: чтобы пользователи вводили текст. Используйте тип текстового поля, соответствующего типу текста, который вы получаете от пользователя, например электронной почты или пароля.
  • Гиперссылки: переход пользователя на другую страницу в приложении или на внешний веб-сайт.
  • Кнопки. Чтобы разрешить пользователям инициировать немедленное действие.

• Добавьте описательное сообщение, если один из элементов управления отключен. Используйте свойство Description, чтобы объяснить, почему параметр SettingsCard недоступен.

• Когда пользователь изменяет параметр, приложение должно немедленно отразить изменение— не требуется кнопка подтверждения.

Связанные статьи

• SettingsCard и SettingsExpander (набор средств сообщества Windows)
• Основы проектирования команд
• Рекомендации по контролям прогресса
• Сохранение и получение данных приложения