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

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

Описание

Параметр 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
Наверх