Обработка JavaScript-событий

Посетительское окно чата онлайн-консультанта Netrox SC генерирует события, доступные для обработки в Javascript-коде на сайте. Обработка событий позволяет вмешиваться в поведение окна чата и корректировать стандартные действия, либо полностью их изменять.

Для подключения собственного обработчика к событию окна Netrox SC на вашем сайте в системе предусмотрено два способа:

  1. Если вы используете библиотеку jQuery, вы можете присоединять обработчики штатными методами этой библиотеки.
  2. В противном случае можно присоединить обработчики событий через объект nsc_API.
Внимание! Недопустимо комбинировать два представленных здесь способа обработки событий. Необходимо выбрать один из двух и его придерживаться в рамках документа (страницы сайта). Если объявлен объект nsc_API, jQuery-события не будут генерироваться.

Обработка событий с помощью библиотеки jQuery

Если на вашем сайте используется библиотека jQuery версии 1.7+, вы можете использовать метод .on() для подключения слушателей событий к объекту document. Помимо привычной для многих записи, преимущество этого способа в том, что возможно создавать несколько обработчиков для одного события и использовать пространства имен для гибкого подключения и отключения обработчиков.

Все события именуются в нижнем регистре с префиксом netrox вместо on (Например, netroxbeforetriggerfilter вместо onBeforeTriggerFilter). В качестве первого аргумента обработчику передается объект события, последующие аргументы - параметры событий Netrox SC в том порядке, в котором они описаны в настоящем руководстве.

Пример

function newMessageHandler(event, messages) {
    alert("new message");
}
$(document).on("netroxnewmessage", newMessageHandler);
              

Обработка событий с помощью объекта nsc_API

Обработчики могут также создаваться путем объявления на странице JavaScript-объекта nsc_API. Каждый метод этого объекта есть обработчик определенного события. Не обязательно определять методы для всех событий. Только для тех, которые вы планируете обрабатывать.

Примеры

  1. Единовременная инициализация объекта API с несколькими обработчиками событий:
    nsc_API = {
        onNewMessage: function() {
            // Ваши действия по приходу нового сообщения 
        },
        onOffline: function() {
            // Ваши действия по переходу в состояние офлайн
        },
    
        /*
         *    Еще обработчики событий
         */
    
        onOnline: function() {
            // Ваши действия по переходу в состояние онлайн
        }
    };              
  2. Добавление методов в уже инициализированный объект API
    nsc_API = { /* ... */ };
    
    nsc_API.onNewMessage = function() {
        // Ваши действия по приходу нового сообщения 
    };
    nsc_API.onOffline = function() {
        // Ваши действия по переходу в состояние офлайн
    };
        /*
         *    Еще обработчики событий
         */              

События Netrox SC, доступные к обработке:

Имя событияОписание
onAfterClose

Скрытие/сворачивания окна чата для типов "Всплывающее" и "Слайдер". Срабатывает по завершении анимации процесса закрытия.

onAfterOpen

После открытия окна чата для типов "Всплывающее" и "Слайдер". Срабатывает по завершении анимации процесса открытия.

onAfterTriggerFilter

Срабатывает после завершения выполнения автоматических действий фильтра.

onBeforeInit

Событие срабатывает перед инициализацией окна чата.

onBeforeNewMessage

Срабатывает перед отрисовкой нового сообщения в чате, предлагая возможность его модификации.

onBeforeTriggerFilter

Срабатывает перед запуском фильтра автодействия.

onChatClear

Событие срабатывает после того, как посетитель очистил переписку при помощи соответствующего инструмента окна чата.

onClose

Событие скрытия/сворачивания окна чата для типов "Всплывающее" и "Слайдер"

onEmailChatError

Срабатывет при отправке посетителем переписки на свой электронный адрес.

onEmailChatSend

Событие отправки посетителем переписки на свой электронный адрес.

onInit

Срабатывет после инициализации окна чата в одном из статусов (В сети/Не в сети).

onMessageSend

Событие отправки сообщения в онлайн-окне чата. Обязано возвращать значение true или false (отправлять сообщение по результатам или нет, соответственно)

onNewMessage

Вы можете произвести какие-либо действия по событию прихода нового сообщения в чате.

onOffline

Срабатывет при переходе окна чата в режим оффлайн. Т.е. когда последний оператор покидает систему.

onOfflineMessageSend

Событие отправки сообщения в оффлайн-форме.

onOnline

Срабатывет при переходе окна чата в режим онлайн. Т.е. когда в сети появляются операторы, готовые общаться.

onOpen

Событие открытия/выдвижения окон чата типов "Слайдер" и "Всплывающее".

onSoundSwitch

Срабатывает при включении/выключении звука в окне чата посетителем.

onVisitorInfoChange

Событие смены значения полей ввода данных о посетителе.

onWindowResize

Событие дает возможность дополнительно обработать изменение посетителем размеров окна чата.

onStartTyping

JavaScript-событие перед показом индикатора набора текста оператором чата

onStopTyping

JavaScript-событие перед скрытием индикатора набора текста оператором чата

onOfflineMessageSuccess

JavaScript-событие успешной отправки офлайн-сообщения.


Все права защищены. Copyright © 2017 Netrox SC