Документация для разработчиков
Темная тема

BX.create

Описание и параметры

DOMNode 
BX.create(
 tag[,
 data[,
 context]]
);
или
DOMNode 
BX.create(
 data[,
 context]
);

Создание узла DOM-структуры. Допускает при создании узла "подвеску" на него каких-то событий.

Параметры функции

Параметр Описание
tag Строка с tagName узла. Если он не указан (первый параметр - объект), то имя тэга должно содержаться в свойстве tag описательного объекта data.
data Описательный объект, может иметь следующие поля:
  • tag: имя_тэга_узла,
  • props: дополнительные свойства, например, className,
  • style: стили узла,
  • events: обработчики событий узла,
  • attrs: для основных полей,
  • dataset: перечень data-атрибутов,
  • children: массив дочерних узлов, необязательный
  • text: текстовое содержимое узла,
  • html: HTML-содержимое узла

Примечание: Параметры text, html и children не совместимы между собой.

context Ссылка на контекст, в котором должен быть создан узел, необязательный.

Возвращаемое значение

Функция вернет ссылку на созданный узел.

Примеры использования

BX.create('input', {'attrs':{'readonly':'readonly'}, props{...}});

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

var completeAction = function(){
   console.log(BX.proxy_context);
};

BX.ready(function(){
   BX.insertAfter(BX.create('span', {
      attrs: {
         className: 'task-view-button'
      },
      dataset: {
         aaa: 123
      },
      events: {
         click: BX.proxy(completeAction, this)
      },
      text: 'Завершить'
   }), completeButton);
});


© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх