Для веб-модуля в секции ToolPanels можно задать состав и группировку кнопок на панели действий проводника и на панели действий списка записей справочников веб-клиента. Состав кнопок по умолчанию см. в разделе «Стандартные имена кнопок панели действий».

Для оптимального размещения кнопок на панели используйте рекомендации по настройке панели действий.

Структура секции:

 
<ToolPanels>
<ToolPanel>
  <!-- Удаление всех групп кнопок по умолчанию -->
  <clear />
  <!-- Удаление конкретной группы кнопок -->
  <remove name="{Код строки локализации удаляемой группы кнопок}" />
  <!-- Группы кнопок -->
  <ToolGroup
    name="{Код строки локализации названия группы}"
    priority="{Приоритет сворачивания группы}"
    icon="{Значок группы}"
    iscollapsed="{Признак свернутой группы}"
    appendafter="{Предшествующая группа кнопок}">
    <!-- Удаление всех кнопок данной группы -->
    <clear />
    <!-- Удаление конкретной кнопки данной группы -->
    <remove name="{Имя удаляемой кнопки}" />
    <!-- Кнопки панели действий -->
    <ToolItem
      oninit="{JavaScript-функция, выполняемая при инициализации панели действий}"
      name="{Имя кнопки}"
      small="{Признак небольшого размера значка кнопки}"
      icon="{Значок кнопки}"
      smallicon="{Значок кнопки небольшого размера}"
      text="{Код строки локализации названия кнопки}"
      jsaction="{JavaScript-функция, выполняемая при нажатии на кнопку}"
      tooltip="{Код строки локализации всплывающей подсказки}"
      hidden="{Признак отображения кнопки}"
      position="{Положение кнопки в группе на панели действий}"
      linkedaction="{Имя связанного прикладного действия}"/>
  </ToolGroup>
</ToolPanel>
<ToolPanel
  type="{Тип объекта, для которого настраивается панель действий}"
  refcode="{Имя справочника}"
  refview="{Представление справочника}">
    <ToolGroup>
      name="{Код строки локализации названия группы}"
      priority="{Приоритет сворачивания}"
      icon="{Значок группы}"

      appendafter="{Предшествующая группа кнопок}">
      <!-- Удаление всех кнопок данной группы -->
      <clear />
      <!-- Удаление конкретной кнопки данной группы -->
      <remove name="{Имя удаляемой кнопки}" />
      <!-- Кнопки панели действий -->
      <ToolItem
        oninit="{JavaScript-функция, выполняемая при инициализации панели действий}"
        name="{Имя кнопки}"
        small="{Размер значка кнопки}"
        icon="{Значок кнопки}"
        smallicon="{Значок кнопки небольшого размера}"
        text="{Код строки локализации названия кнопки}"
        jsaction="{JavaScript-функция на нажатие кнопки}"
        tooltip="{Код строки локализации всплывающей подсказки}"
        hidden="{Признак отображения кнопки}"
        position="{Положение кнопки в группе на панели действий}"
        linkedaction="{Имя связанного прикладного действия}"/>
</ToolPanel>
</ToolPanels>

ToolPanels – настройки панели действий проводника и панели действий на закладках карточек записей справочников.

ToolPanel – настраиваемая панель действий.

remove – удаление конкретной группы кнопок.

name. Код строки локализации удаляемой группы кнопок.

type. Тип объекта, для которого настраивается панель действий. Возможные значения:

refcode. Имя справочника из компоненты Типы справочников. Указывается для типа объекта Reference. Панель действий настраивается только для списка записей указанного справочника.

refview. Представление карточки записи справочника по умолчанию.

ToolGroup – настройки группы кнопок.

name. Код строки локализации названия группы кнопок. Название группы кнопок отображается на панели действий, когда группа свернута. Например, TOOLBAR_REFERENCE_LIST_ACTIONS_GROUP – настройка вида списка записей справочника. Название не должно содержать более двух слов.

priority. Приоритет, в порядке возрастания которого будут сворачиваться группы кнопок при недостаточном размере окна веб-клиента. Значением является целое число. Группы сворачиваются справа налево в порядке приоритета. Группа с приоритетом 0 будет свернута первой, потом с приоритетом 1 и т.д. Если значение атрибута не указано, то группа сворачивается в последнюю очередь.

icon. Название файла значка группы кнопок (без расширения), расположенного в папке App_Sprites корневой папки веб-сайта. Значок группы кнопок отображается на панели действий, когда группа свернута. Значок группы должен иметь размер 20x20.

Если подходящего значка нет, добавьте свой в формате SVG в папку svg или PNG в папку App_Sprites. Не рекомендуется использовать один и тот же значок для нескольких групп на панели действий.

iscollapsed. Если указано значение true, группа кнопок всегда будет свернутой.

appendafter. Наименование группы кнопок, после которой будет расположена настраиваемая группа. Если в атрибуте указана пустая строка, группа кнопок располагается первой. Если атрибут пропущен, группа кнопок располагается последней.

remove – удаление конкретной кнопки группы кнопок.

name. Имя удаляемой кнопки. Имена кнопок см. в разделе «Стандартные имена кнопок панели действий».

ToolItem – настройки кнопок панели действий.

oninit. JavaScript-функция, выполняемая при инициализации панели действий.

name. Имя настраиваемой кнопки. Имена кнопок см. в разделе «Стандартные имена кнопок панели действий».

small. Размер значка кнопки. Возможные значения:

icon. Название файла значка кнопки (без расширения), расположенного в папке App_Sprites корневой папки веб-сайта. Если подходящего значка нет, добавьте свой в формате SVG в папку svg или PNG в папку App_Sprites. Значок кнопки должен иметь размер 20x20. Не рекомендуется использовать один и тот же значок для нескольких кнопок на панели действий.

smallicon. Название файла значка кнопки небольшого размера (без расширения), расположенного в папке App_Sprites корневой папки веб-сайта. Если подходящего значка нет, добавьте свой в формате SVG в папку svg или PNG в папку App_Sprites.

text. Код строки локализации названия кнопки. Рекомендуется настраивать для кнопки не только иконку, но и название длиной не более двух слов. Для более подробного описания задайте подсказку к кнопке в атрибуте tooltip.

jsaction. JavaScript-функция, запускаемая при нажатии на кнопку. При необходимости укажите параметры функции. Если при нажатии на кнопку должно выполняться прикладное действие, разработанное в десктоп-клиенте, указанная функция должна содержать вызов нужного прикладного действия средствами клиентского API веб-доступа: WebAccess.current.executeAction(actionName), где actionName – имя прикладного действия. Файл с текстом функции следует размещать в подпапке js корневой папки веб-сайта.

tooltip. Код строки локализации всплывающей подсказки.

hidden. Признак скрытия кнопки на панели действий. Возможные значения:

Значение по умолчанию false.

position. Положение кнопки в группе на панели действий. Если установлено значение 0, то кнопка будет расположена первой в группе, 1 – второй и т.д. Значение по умолчанию 1000000. Если атрибут не указан, ему автоматически присваивается значение, кратное 100: первая кнопка в группе будет иметь значение 100, вторая – 200 и т.д.

linkedaction. Имя связанного прикладного действия. При нажатии на кнопку действие будет выполняться, если не указан атрибут jsaction.

Пример

© Компания DIRECTUM, 2018

Сообщество пользователей DIRECTUM