K4:Добавление кнопки в панель инструментов
From In-Portal Developers Guide
Path to article:
m (1 версия) |
Current revision (19:02, 27 August 2010) (view source) (Adding Translation Links) |
||
| (2 intermediate revisions not shown.) | |||
| Line 32: | Line 32: | ||
| {{ConfigProperty|prefix|string}} || [[K4:Unit Configs#Prefix|Префикс]], который влияет на ID, которое будет проставлено созданной кнопке. | | {{ConfigProperty|prefix|string}} || [[K4:Unit Configs#Prefix|Префикс]], который влияет на ID, которое будет проставлено созданной кнопке. | ||
|} | |} | ||
| + | |||
| + | [[en:K4:Adding_New_Button_to_Toolbar]] | ||
| + | [[ru:{{FULLPAGENAME}}]] | ||
Current revision
| ||
|---|---|---|
| Статьи в этой категории | ||
|
Панель инструментов это один из основных элементов управления ходом событий в шаблонах. Для добавления новой кнопки в уже имеющуюся панель инструментов следует использовать следующий JavaScript код:
a_toolbar.AddButton( new ToolBarButton( 'custom:sample_button', '<inp2:m_phrase label="la_ToolTip_SampleButton" escape="1"/>::<inp2:m_phrase label="la_ShortToolTip_SampleButton" escape="1"/>', function() { // alert('button worked'); } ) );
Конструктор класса ToolBarButton принимает 5 параметров, из которых только первые 3 обязательные:
| название | описание |
|---|---|
title (string) | Идентификатор кнопки. Идентификатор должен быть уникальным в пределах одной панели инструментов. В идентификаторе также можно указать модуль, служащий источником пиктограмм используемых в кнопке (см. Структура директорий). Ниже приведены примеры названий файлов пиктограмм, определяющих вид кнопки:
В приведённом выше примере вместо "sample_button" нужно подставить фактическое название кнопки. Название модуля отделяется от названия кнопки при помощи символа двоеточия (" |
alt (string) | Фраза, показываемая при наведении курсора мыши на кнопку (mouseover). Также эта фраза используется для показывания вспомогательного текста под кнопкой (только если опция конфигурации UseToolbarLabels включена). Если указать 2 фразы разделённые с использованием двух двоеточий ("::"), то фраза указанная до разделителя будет использована в качестве краткой подсказки (при наведении мышки), а фраза указанная после разделителя будет использована в качестве текста, показываемого под кнопкой.
|
onclick (string) | Действие, которое должно происходить при нажатии на кнопку. Обычно, для наглядности, динамически определяется функция и в ней пишется фактический JavaScript код, который должен быть выполнен. |
| Кнопка должна быть сразу спрятана после своего добавления в панель инструментов. |
prefix (string) | Префикс, который влияет на ID, которое будет проставлено созданной кнопке. |
