Типы встроенного языка и свойства элемента проекта вида «ФрагментКомандногоИнтерфейса»

Фрагмент командного интерфейса объединяет несколько команд и групп команд для того, чтобы показать их в интерфейсе. Используется, например, в свойствах компонента СтандартноеКлиентскоеПриложениеСРазделами:

Пример фрагмента командного интерфейса в форме:

Пример фрагмента командного интерфейса в панели навигации:

После того, как вы добавили в проект фрагмент командного интерфейса и дали ему имя, создаст один тип встроенного языка. Имя этого типа совпадает с именем вашего фрагмента командного интерфейса.

Например, если в проекте есть фрагмент командного интерфейса ПанельНавигации, то будет создан тип ПанельНавигации. В общем случае имя этого типа выглядит следующим образом: <ИмяФрагментаКомандногоИнтерфейса>.

Тип <ИмяФрагментаКомандногоИнтерфейса>

Этот тип встроенного языка доступен на клиенте.

Он не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:

// Получить фрагмент командного интерфейса «ПанельНавигации»
пер Навигация = ПанельНавигации

Модуль фрагмента командного интерфейса

В проекте модуль, расширяющий тип <ИмяФрагментаКомандногоИнтерфейса>, называется модулем фрагмента командного интерфейса. Он исполняется на клиенте.

В этом модуле вы можете обработать события нажатия на команды, которые описаны в свойстве Элементы этого фрагмента.

Свойства элемента проекта

Элементы

Массив команд, экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, состоящий из команд или экземпляр ГруппаКомандногоИнтерфейса<ТипКоманды>, состоящая из команд. Тип ГруппаКомандногоИнтерфейса<ТипКоманды> предназначен для того, чтобы логически объединять команды в некоторую группу. Например, на изображении фрагмента командного интерфейса в панели навигации в самом начале страницы, курсор указывает на элемент типа ГруппаКомандногоИнтерфейса<ТипКоманды> с представлением «Настройки», которые включает в себя два элемента типа ОбычнаяКоманда: «Сотрудники» и «События».

Пример YAML-файла, в котором используются различные способы формирования фрагмента командного интерфейса:

ВидЭлемента: ФрагментКомандногоИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 58e451d8-20ff-4ba8-8b92-d8dacae520cc
Имя: ФрагментИнтерфейса
Элементы:
    - # --- Вызов собственных команд, добавленных в проект
        =МояОбычнаяКоманда
    -
        =МояНавигационнаяКоманда
    -
        =МояПереключаемаяКоманда
    -
        =МойФрагментИнтерфейса

    - # --- Использование группы командного интерфейса      
        Тип: ГруппаКомандногоИнтерфейса<Команда>
        Представление: Стандартные команды элементов проекта
        Изображение: icon-desc.svg
        Элементы:
            - # --- Вызов стандартных команд элементов проекта: открытие форм справочников
                =Сотрудники.ОткрытьСписок
            - 
                =События.СоздатьОбъект

    - # --- Навигационная команда, описанная внутри фрагмента                   
        Тип: НавигационнаяКоманда
        Представление: Задачи
        ТипФормы: МояФорма

    - # --- Обычная команда, описанная внутри фрагмента      
        Тип: ОбычнаяКоманда
        Представление: Подсказать
        Изображение: icon-q.svg
        Обработчик: ОбработчикКомандыПодсказать 

    - # --- Переключаемая команда, описанная внутри фрагмента
        Тип: ПереключаемаяКоманда
        ПредставлениеАктивного: Избранное
        ПредставлениеНеактивного: В избранное
        Обработчик: ОбработчикПереключаемойКоманды

    - # --- Фрагмент инетрфейса, описанный внутри фрагмента    
        Тип: ФрагментКомандногоИнтерфейса<Команда>
        Элементы:
            -
                Тип: ОбычнаяКоманда
                Представление: Настройки
                Изображение: РазделНастройки.svg
                Обработчик: ОбработчикКомандыНастройки
            -
                Тип: ОбычнаяКоманда
                Представление: Сервис
                Изображение: РазделСервис.svg
                Обработчик: ОбработчикКомандыСервис