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

Параметры компонента

Описание

Параметр BUTTONS позволяет задать произвольный набор кнопок, вывести чекбокс и свой html.

Кнопки выводятся по порядку указания в параметре.

Список типов кнопок

  • save - зеленая кнопка Сохранить
  • apply - синяя кнопка Применить
  • cancel - ссылка Отмена
  • close - прозрачная кнопка Закрыть
  • button - прозрачная кнопка
  • checkbox - чекбокс в правом углу
  • custom - произвольный html

Форматы

Короткий формат

Перечисление типов и в формате ключ=>значение:

<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		'save', 
		'apply', 
		'close' => 'путь для ссылки', 
		'cancel' => 'путь для ссылки',
		'custom' => '<span></span>', 
	]
]);?> 

Полный формат

Перечисление кнопок в виде массива с полями:

<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		['TYPE' => 'save'],
		['TYPE' => 'apply'],
		['TYPE' => 'cancel', 'LINK' => '/company/list/'],
		['TYPE' => 'custom', 'LAYOUT' => '<span>my content</span>'],			
	]
]);?> 

Для всех кнопок, кроме типа custom доступны следующие поля:

<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		[
			'TYPE' => 'save', // тип - обязательный
			'CAPTION' => 'Сохранить', // название - не обязательный
			'NAME' => 'save', // атрибут `name` инпута - не обязательный
			'ID' => 'my-save-id', // атрибут `id` инпута - не обязательный
			'VALUE' => 'Y', // атрибут `value` инпута - не обязательный
			'ONCLICK' => '', // атрибут `onclick` инпута - не обязательный
		],			
	]
]);?>

По умолчанию значения этих полей уже предустановлены.

Особые поля кнопок

Тип close и cancel

Имеет уникальное поле: LINK
<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		[
			'TYPE' => 'close', // тип - обязательный
			'LINK' => '/segment/list/', // ссылка, если клик на странице - обязательный
		],			
	]
]);?>

Тип checkbox

Имеет два уникальных поля: CHECKED и HINT

<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		[
			'TYPE' => 'checkbox', // тип - обязательный
			'CAPTION' => 'Применить', // текст - не обязательный
			'NAME' => 'apply', // атрибут `name` инпута - не обязательный
			'ID' => '123', // атрибут `id` инпута - не обязательный
			'VALUE' => 'Y', // атрибут `value` инпута - не обязательный
			'ONCLICK' => '', // атрибут `onclick` инпута - не обязательный
			'CHECKED' => '', // булево, выводит атрибут `checked` инпута - не обязательный
			'HINT' => '', // выводит подсказку справа от текста чекбокса - не обязательный
		],			
	]
]);?>

Тип custom

Имеет только два поля: TYPE и LAYOUT

<?$APPLICATION->IncludeComponent('bitrix:ui.button.panel', '', [
	'BUTTONS' => [
		[
			'TYPE' => 'custom', // тип - обязательный
			'LAYOUT' => '<div></div>', // произвольная верстка - обязательный
		],			
	]
]);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024