krpano — Combobox плагин

Плагин combobox / dropdown-list / selectbox.
Этот плагин преобразует элементы <combobox> в текущий xml в несколько внутренних элементов <layer>, scrollarea и textfield.
Кроме того, также можно динамически добавлять и удалять элементы combobox.
Реализация xml-only допускает множество способов настройки (дизайн и функциональность).
Из-за плагина xml-only код автоматически работает одинаково для HTML5 и Flash.
Этот плагин можно использовать в качестве замены для старых плагинов combobox.swf / combobox.js, интерфейсы действий одинаковы.

Синтаксис

Сначала включите файл combobox.xml в любом месте xml (при необходимости отрегулируйте путь):

<include url=»plugins/combobox.xml» />

Определите элемент combobox через статический XML-код:

<combobox name=»cb1″ design=»default» …any layer settings…>
<item name=»item1″ caption=»Item 1″ onclick=»…» />
<item name=»item2″ caption=»Item 2″ onclick=»…» />
<item name=»item3″ caption=»Item 3″ onclick=»…» />
</combobox>

Этот элемент <combobox> будет преобразован в элемент <layer> при запуске. Имя слоя будет таким же. Таким образом, для динамического доступа к combobox используйте layer[name] в качестве адресации.

Или создайте элемент combobox динамическим кодом действия:

<action name=»test»>
addComboboxLayer(cb1, default);
set(layer[cb1].align, ‘lefttop’);
set(layer[cb1].x, 20);
set(layer[cb1].y, 20);
layer[cb1].addItem(‘Item 1’, trace(Item 1 clicked) );
layer[cb1].addItem(‘Item 2’, trace(Item 2 clicked) );
layer[cb1].addItem(‘Item 3’, trace(Item 3 clicked) );
</action>

Размер / Выравнивание / Положение

Выделение может быть размещено на экране или в других слоях, как элемент обычного слоя — например, используя настройки align, edge, x, y и parent.

Если ширина (width) не задана, то ширина будет определяться автоматически с помощью параметров дизайна (design settings) и наибольшего заголовка элемента.

Установка высоты (height) невозможна, высота всегда устанавливается автоматически.

Атрибуты плагинов / события

Атрибут design

Имя атрибута — design

Тип — String (строка)

Значение по умолчанию — «default»

Выберите дизайн для combobox
Здесь может быть выбран предопределенный дизайн или собственный пользовательский
Доступные проекты: default — белые ящики с тенями и черным текстом; vtour — vtourskin.xml look, темно-синий фон с белым текстом
Если не установлены никакие настройки или недействительные параметры, будет использоваться проект по умолчанию
Пользовательский дизайн может быть создан элементом <combobox_design>

Атрибут callonclickafterclose

Имя атрибута — callonclickafterclose

Тип — Boolean (логический)

Значение по умолчанию — «false»

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

true (по умолчанию) — вызов onclick задерживается после закрытия выпадающего списка
false — вызывается мгновенно, это может потребоваться при изменении настроек браузера, требующих прямого взаимодействия с пользователем, например, переключение в полноэкранный режим