Перейти к основному содержимому

Объект события компонента экранной формы

Свойствам компонентов экранных форм можно присвоить функции-обработчики событий. События компонента возникают в результате действий пользователя, например, использования мыши или клавиатуры.

Объект события — объект, который содержит данные о событии, например, тип, значение, цель, идентификатор.

Для получения доступа к объекту события в обработчике события необходимо использовать метод FrontendCore getEvent().

OnClick={() => {
// Получение параметра события
const event = getEvent();
// Вывод параметра события в консоль браузера
console.log(event);
}

Объект события компонента экранной формы является оберткой над объектом события React и содержит такие же поля, что и аналогичные объекты события React.

Объекты события React реализуют следующие стандартные свойства события DOM (Document Object Model):

  • bubbles: возвращает признак передачи события через DOM.
  • cancelable: возвращает признак возможности отмены события.
  • currentTarget: возвращает узел DOM, к которому подключен текущий обработчик в дереве React.
  • defaultPrevented: возвращает признак вызова метода preventDefault.
  • eventPhase: возвращает текущую фазу события, которая может быть одним из следующих значений NONE, CAPTURING_PHASE, AT_TARGET, BUBBLING_PHASE.
  • isTrusted: возвращает признак инициализации события пользователем.
  • target: возвращает узел DOM, в котором произошло событие и который может быть удаленным дочерним узлом.
  • timeStamp: возвращает временную метку события в виде количества миллисекунд, измеренного относительно момента возникновения события.
  • nativeEvent: возвращает оригинальный объект события браузера — DOM Event.

Объекты события React реализуют следующие стандартные методы события DOM:

  • preventDefault(): предотвращает поведение по умолчанию для события.
  • stopPropagation(): останавливает распространение события на родительские компоненты в дереве React.

Кроме того, объекты события React реализуют следующие методы:

  • isDefaultPrevented(): возвращает признак вызова метода preventDefault().
  • isPropagationStopped(): возвращает признак вызова метода stopPropagation().
  • persist(): возвращает свойства события после наступления события.
  • isPersistent(): возвращает признак вызова метода persist().

События на компонентах могут всплывать. Для остановки всплытия события можно воспользоваться методом FrontendCore stopEvent().

OnClick={() => {
// остановка всплытия события
stopEvent();
}

В обработчике события можно получить доступ к переменным состояния экранной формы.