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

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-2024, «1С-Битрикс», 2024