События (Events) krpano — их можно использовать для вызова действий или функций, когда что-то происходит.
Два типа событий:
- Глобальные события krpano
- Независимые локальные события krpano
Глобальные события krpano
Это события, которые были определены в элементах <events> без атрибута имени. Всегда может быть только одно глобальное событие. Когда в xml есть еще один элемент <events> с тем же самым событием, ранее определенные события будут перезаписаны.
Примечание. При загрузке другого xml-файла или другой сцены все глобальные события будут оставаться неизменными, если они не будут определены снова в новом xml или сцене.
Независимые локальные события krpano
Когда элемент <events> в xml будет определен с атрибутом name, то это будет независимый элемент событий.
Он может содержать любое из событий, но они не будут перезаписывать глобальные события, они будут вызваны дополнительно к нему.
Эти именованные элементы <events> также имеют атрибут keep (со значением по умолчанию «false»). Это означает, что элементы <events> без keep = «true» будут автоматически удалены, когда будет загружен другая панорама.
Совет. Названные события являются хорошим способом для плагинов или независимого / включаемого кода xml для использования событий krpano, не мешая другим плагинам или другому коду.
Список событий (Events) krpano
<events onenterfullscreen=»»
onexitfullscreen=»»
onxmlcomplete=»»
onpreviewcomplete=»»
onloadcomplete=»»
onnewpano=»»
onremovepano=»»
onnewscene=»»
onxmlerror=»»
onloaderror=»»
onkeydown=»»
onkeyup=»»
onclick=»»
onsingleclick=»»
ondoubleclick=»»
onmousedown=»»
onmouseup=»»
onmousewheel=»»
oncontextmenu=»»
onidle=»»
onviewchange=»»
onviewchanged=»»
onresize=»»
onautorotatestart=»»
onautorotatestop=»»
onautorotateoneround=»»
onautorotatechange=»»
gyro_onavailable=»»
gyro_onunavailable=»»
gyro_onenable=»»
gyro_ondisable=»»
webvr_onavailable=»»
webvr_onunavailable=»»
webvr_onunknowndevice=»»
webvr_onentervr=»»
webvr_onexitvr=»»
/>
Независимые локальные события: (через элементы ‘named’ events)
<events name=»…» keep=»false»
… any events …
/>
name
Когда атрибут имени будет определен, этот элемент событий будет независимым элементом локальных событий.
Без атрибута name были установлены глобальные события.
Полное имя переменной: events[…].name
Тип: строка
keep
Если этот элемент <events> хранится или удаляется при загрузке новой панорамы или сцены.
См. Также примечания в действии loadpano ().
onenterfullscreen
onexitfullscreen
onxmlcomplete
onpreviewcomplete
onloadcomplete
onnewpano
onremovepano
onnewscene
onxmlerror
onloaderror
onkeydown
onkeyup
onclick
onsingleclick
ondoubleclick
onmousedown
onmouseup
onmousewheel
oncontextmenu
onidle
onviewchange
onviewchanged
onresize
onautorotatestart
onautorotatestop
onautorotateoneround
Это событие будет вызываться, когда:
- один поворот на 360 градусов (для панелей 360x *),
- или одна левая правая панорама для частичной или плоской панорамы.
Это можно использовать для перехода к следующей панораме в туре — например, для «автоматических туров». Это может выглядеть красиво при
использовании флага KEEPMOVING для смешивания между панорамированием во время автоматического вращения.
Полное имя переменной: events.onautorotateoneround
Тип: Действие
onautorotatechange
Это событие будет вызываться, когда параметр autorotate.enabled был изменен.
Может использоваться для обновления состояния кнопки авторотации.
Полное имя переменной: events.onautorotatechange
Тип: Действие
