Свойства компонента интерфейса, унаследованного от компонента «СтандартноеКлиентскоеПриложениеСРазделами»
Клиентское приложение, которое содержит следующие стандартные области:
- Панель навигации, она расположена слева;
- Область содержимого, в которой открываются формы;
- Вкладки последнего уровня навигации, они расположены в верхней части области содержимого;
- Панель действий, она расположена справа;
- Дополнительный командный интерфейс, часть панели действий, обычно содержит команды профиля.
Иерархия наследования
- Компонент (абстрактный)
- КлиентскоеПриложение (абстрактный)
Свойства
- ВидимостьИнформацииОПриложении
- Показать или скрыть на панели действий иконку Информация, которая предоставляет доступ к информации о
приложении.Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ВидимостьИнформацииОПриложении: Ложь
- ВидимостьЦентраУведомлений
- Показать или скрыть на панели действий иконку Колокольчик, которая предоставляет доступ к центру уведомлений.Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ВидимостьЦентраУведомлений: Ложь
- Последний уровень навигации это пункты, у которых нет соседних групп, например Задачи и
События:
- Главная
- Пресейл
- Мероприятия
- Задачи
- События
- Настройки
- Сервис
- ВПанелиНавигации — при нажатии на Мероприятия эти пункты будут показаны в панели навигации, при нажатии на Задачи откроется содержимое пункта Задачи;
- Страницы — эти пункты не будут показаны в панели навигации. При нажатии на Мероприятия откроется содержимое первого из этих пунктов — Задачи, а в верхней части области содержимого появятся вкладки последнего уровня навигации — Задачи и События;
- Авто — вид Страницы.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ВидПоследнегоУровняНавигации: ВПанелиНавигации
- ДополнительныйКомандныйИнтерфейс
- Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, содержащий одну группу с командами.
Описывает интерфейс дополнительной панели навигации.Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ДополнительныйКомандныйИнтерфейс: ДополнительныйИнтерфейс
- КомандныйИнтерфейсПанелиДействий
- Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, состоящий из команд. Описывает интерфейс
панели действий.Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами КомандныйИнтерфейсПанелиДействий: ПанельДействий
- КомандныйИнтерфейсПанелиНавигации
- Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>. Описывает интерфейс панели
навигации.Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами КомандныйИнтерфейсПанелиНавигации: ПанельНавигации
- Логотип
- Логотип приложения. Ссылка на ресурс.Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами Логотип: Логотип.svg
- Вертикальная — слева от области содержимого;
- Горизонтальная — над областью содержимого;
- Авто — вид Вертикальная.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ОриентацияПанелиНавигации: Горизонтальная
- ОсобоеОформлениеПервогоРаздела
- Необходимость оформления области содержимого
первого раздела особым образом, отличным от других разделов:
- Серый фон;
- Нет скруглений верхних углов.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ОсобоеОформлениеПервогоРаздела: Ложь
- ПоложениеЗаголовка
- Способ совместного отображения логотипа и заголовка приложения:
- Горизонтально — «1С:Шина» отображает заголовок справа от логотипа;
- Вертикально — «1С:Шина» отображает заголовок под логотипом;
- НеОтображать — «1С:Шина» отображает только логотип, заголовок не отображается.
- Авто — «1С:Шина» использует вариант Горизонтально.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ПоложениеЗаголовка: Вертикально
- Заголовок
- Заголовок приложения. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами Заголовок: demo APP
- ПоказыватьНеобработанныеОшибки
- Необходимость показа пользователю необработанных ошибок в приложении. Список таких ошибок выводится в модальном окне. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ПоказыватьНеобработанныеОшибки: Ложь
- Путь
- Путь публикации данного приложения (подробнее). Должен содержать один сегмент пути или
пустую строку. Не должен содержать следующие зарезервированные пути:
- api;
- stdapi;
- sys;
- ui.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами Путь: back-office
- РежимАутентификации
- Необходимость аутентификации пользователя при входе в приложение:
- Аутентифицированный — пользователь будет автоматически перенаправлен на страницу аутентификации;
- НеАутентифицированный — может работать анонимный пользователь.
Стандартно это свойство имеет значение Аутентифицированный, но вы можете установить его в значение НеАутентифицированный и тогда пользователь не будет перенаправлен на страницу аутентификации при входе в приложение. Такого пользователя не будет в списке подключенных пользователей иПользователи.ТекущийПользователь
будет возвращать Неопределено. Пример YAML-файла:ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами РежимАутентификации: НеАутентифицированный
- ВесПриРастягивании
-
Значимость данного компонента по сравнению с другими растягиваемыми компонентами. Например, если у данного компонента ВесПриРастягивании = 1, а у другого ВесПриРастягивании = 2, то другой компонент будет в 2 раза больше данного (подробнее). Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа ВесПриРастягивании: 2
- ВыравниваниеВГруппеПоВертикали
- Способ вертикального выравнивания этого компонента внутри родительской группы: Верх, Центр, Низ, ПоБазовойЛинии (по нижней линии букв), Авто — значение ПоБазовойЛинии. Позволяет управлять индивидуальным положением этого компонента в группе, если размер группы больше размера, требуемого всем ее компонентам. Например, если «1С:Шина» растягивает группу, а компоненты в ней не растягивает.
- Видимость
- Показать или скрыть компонент. Фактическая видимость компонента зависит от видимости его родительских компонентов. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа Видимость: Ложь
- Высота
- Высота компонента в пикселях (подробнее).
- ВыравниваниеВГруппеПоГоризонтали
- Способ горизонтального выравнивания этого компонента внутри родительской группы: Начало, Центр, Конец, ПоШирине, Авто — значение Начало. Позволяет управлять индивидуальным положением компонента в группе, если размер группы больше размера, требуемого всем ее компонентам. Например, если «1С:Шина» растягивает группу, а компоненты в ней не растягивает.
- Доступность
- Способность компонента принимать фокус и редактировать данные. Состояние доступности распространяется на все компоненты
содержимого, пока не встретится переопределение этого свойства. Имеет приоритет над свойством ТолькоЧтение.
Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа Доступность: Ложь
- МаксимальнаяВысота
- Максимальная высота компонента в пикселях. Свойство используется, если РастягиватьПоВертикали вычислено как Растягивать. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа МаксимальнаяВысота: 100
- МаксимальнаяШирина
- Максимальная ширина компонента в пикселях. Свойство используется, если РастягиватьПоГоризонтали вычислено как Растягивать. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа МаксимальнаяШирина: 300
- МинимальнаяВысота
- Минимальная высота компонента в пикселях. Свойство используется, если РастягиватьПоВертикали вычислено как Растягивать. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа МинимальнаяВысота: 100
- МинимальнаяШирина
- Минимальная ширина компонента в пикселях. Свойство используется, если РастягиватьПоГоризонтали вычислено как Растягивать. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа МинимальнаяШирина: 300
- РастягиватьПоВертикали
- Необходимость растягивания компонента по всей доступной высоте (подробнее).
- РастягиватьПоГоризонтали
- Необходимость растягивания компонента по всей доступной ширине (подробнее).
- ТолькоЧтение
- Запрет редактирования данных компонента. Если флажок установлен, то компонент может принимать фокус, текст более четкий, его
данные можно просматривать и копировать. В этом состоянии некоторые компоненты могут сохранять свою интерактивность, которая не
влечет за собой изменение каких-либо данных. Состояние ТолькоЧтение распространяется на все компоненты
содержимого, пока не встретится переопределение этого свойства. Имеет более низкий приоритет, чем свойство
Доступность. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа ТолькоЧтение: Истина
- Ширина
- Ширина компонента в пикселях (подробнее).
- НастройкиТипа
- Контракты, которые реализует компонент интерфейса
- Контракты
- Массив<Тип>. Имена контрактов типа, которые реализует данный компонент.
- <Свойство разработчика>
- Собственное свойство компонента (добавленное вами). Каждое собственное свойство описывается следующими свойствами:
- ЗначениеПоУмолчанию
- Стандартное значение свойства. Значение можно не указывать, если у его типа/типов есть значение по умолчанию (в
частности, если его тип включает Неопределено или Null). Если тип свойства
составной (включает несколько типов), необходимо указать тип значения. Иначе просто само значение. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2 Имя: МояФормаОбъекта Свойства: - Имя: Готовность Тип: Булево ЗначениеПоУмолчанию: Ложь - Имя: Проверено Тип: Булево|Строка ЗначениеПоУмолчанию: Тип: Булево Значение: Ложь Наследует: Тип: ФормаОбъекта
В описании экземпляра этого компонента вы можете установить другое значение этому свойству - Имя
- Имя свойства. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2 Имя: МояФормаОбъекта Свойства: - Имя: ЭлектроннаяПочта Тип: Строка - Имя: Пользователь Тип: Пользователи.Ссылка? Наследует: Тип: ФормаОбъекта
- СохраняемыеДанные
- Истина — при изменении значения этого свойства «1С:Шина» установит
свойство СобственнаяМодифицированность элемента компонента в значение Истина. В
значение Ложь свойство СобственнаяМодифицированность вам нужно установить
самостоятельно после записи данных. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2 Имя: МояФормаОбъекта Свойства: - Имя: ЭлектроннаяПочта Тип: Строка СохраняемыеДанные: Истина Наследует: Тип: ФормаОбъекта
- Тип
- Тип свойства. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2 Имя: МояФормаОбъекта Свойства: - Имя: ЭлектроннаяПочта Тип: Строка - Имя: Пользователь Тип: Пользователи.Ссылка? - Имя: Проверено Тип: Булево|Строка|? Наследует: Тип: ФормаОбъекта
- <Событие разработчика>
- Собственные события компонента (добавленные вами). Здесь вы описываете только само событие, обработчик для этого события вы
назначите при описании экземпляра этого компонента. О вызове
и назначении обработчиков собственных событий компонента вы можете прочитать здесь. Каждое
событие описывается следующими свойствами:
- Имя
- Имя события. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 4a2f1305-d442-41e2-9c07-5aaebbe6bdeb Имя: МойПроизвольнаяСтрокаСписка События: - Имя: ВыбратьСотрудника Тип: СобытиеСДанными<ДанныеМероприятия> Наследует: Тип: ПроизвольнаяСтрокаСписка
- Тип
- Тип объекта события:
- Тип должен быть наследником типа СобытиеКомпонента;
- Если значение не указано, то тип события — СобытиеКомпонента.
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 4a2f1305-d442-41e2-9c07-5aaebbe6bdeb Имя: МойПроизвольнаяСтрокаСписка События: - Имя: ВыбратьСотрудника Тип: СобытиеСДанными<ДанныеМероприятия> Наследует: Тип: ПроизвольнаяСтрокаСписка
- Тип
- Тип наследуемого компонента. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 746eb2b7-5067-4ee4-badd-16751a6ecd16 Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа
- Внешний
- Является ли элемент проекта или компонент внешним. Пример
YAML-файла:
ВидЭлемента: Пользователи Внешний: Истина Имя: Пользователи СобственныйПакет: Стд::Пользователи
- Имя
- Имя элемента проекта или компонента. Пример YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- Импорт
- Список импортированных пространств имен (подробнее). Пример
YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600 Импорт: - Главная - Настройки::НовыйПакет
- Ид
- Идентификатор элемента проекта или компонента. «1С:Шина» создает этот идентификатор автоматически. Пример
YAML-файла:
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- ОбластьВидимости
- Видимость элемента проекта (подробнее):
- Подсистема — элемент виден внутри одной подсистемы во всех пакетах. Значение по умолчанию.
- Проект — элемент виден во всех подсистемах одного проекта.
- Глобально — элемент виден в других проектах.
ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
- СобственныйПакет
- Имя пакета собственного объекта. Пример
YAML-файла:
ВидЭлемента: Пользователи Внешний: Истина Имя: Пользователи СобственныйПакет: Стд::Пользователи
- ВидЭлемента
- Вид элементов проекта (подробнее) либо компонент интерфейса
(подробнее). Пример YAML-файла элемента
проекта:
Пример YAML-файла компонента:ВидЭлемента: Справочник ОбластьВидимости: Подсистема Имя: МойСправочник Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа
События
- ПриИзмененииИсторииПереходов
- Вызывается при прохождении по истории переходов. В браузере при нажатии на стрелки назад/вперед. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9 Имя: МоеПриложение Наследует: Тип: СтандартноеКлиентскоеПриложениеСРазделами ПриИзмененииИсторииПереходов: ОбработчикИсторииПереходов
- ПослеСоздания
- Предназначено для дополнительной инициализации свойств экземпляра компонента на клиенте и вызова прикладной логики инициализации
экземпляра компонента. Возникает после полного конструирования экземпляра компонента, т. е. когда:
- установлены значения свойств экземпляра компонента, указанные при описании экземпляра;
- созданы свои компоненты данного экземпляра;
- значения их свойств своих компонентов установлены из описаний их экземпляров;
- подключены обработчики событий в экземпляре компонента и в экземплярах его внутренних компонентов.
Пример YAML-файла:ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа ПослеСоздания: ОбработчикПослеСоздания
Сигнатура обработчика события на встроенном языке:метод ОбработчикПослеСоздания() ;
- ПриПеретаскивании
- Возникает при окончании перетаскивания, например, перетаскивание файлов из проводника на компонент. Если обработчик события не
установил свойство СобытиеПриПеретаскивании.СтандартнаяОбработка равным Ложь, то происходит
системная обработка события (она есть, например у компонента ВыборФайлов), после чего «1С:Шина» вызывает событие у родительского по визуальной иерархии компонента, вплоть до компонента,
унаследованного от КлиентскоеПриложение. Пример
YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: Подсистема Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb Имя: МояГруппа Наследует: Тип: ОбычнаяГруппа ПриПеретаскивании: ОбработчикПриПеретаскивании
Сигнатура обработчика события на встроенном языке:метод ОбработчикПриПеретаскивании(Компонент: Компонент, Событие: СобытиеПриПеретаскивании) ;