msvdev / bitrix-extension-view
Bitrix templating extension
Installs: 43
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 1
Open Issues: 0
Type:bitrix-extension
Requires
- symfony/templating: ^3.4
This package is auto-updated.
Last update: 2024-08-28 16:55:23 UTC
README
Шаблонизация в symfony - простой, мощный и расширяемый инструмент управления шаблонами. Если Вы работаете с битриксом достаточно долго, скорее всего Вас уже достали портянки кода в шаблонах. Будем честны - шаблоны битрикса ужасны. Использование данного шаблонизатора поможет частично решить эту проблему и ступить на путь простоты и повторного использования кода.
Настройка битрикс для работы с composer
Готовый шаблон проекта с composer и подробными комментариями здесь
Установка
composer require msvdev/bitrix-extension-view
Использование в компонентах
Разбиваем шаблон на логические части
template.php
<?php if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die(); $view = (new Msvdev\Bitrix\View\ViewPhp($this))->getView(); ?> <div> <h1><?=$arResult['NAME']?></h1> ...some code... <?php if(sizeof($arResult['IMAGES'])):?> <?=$view->render('gallery',['images' => $arResult['IMAGES']])?> <?php endif?> ...some code... </div>
gallery.html.php
<?php if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die(); /** * @var array $images */ ?> <?php foreach ($images as $image):?> <img src="<?=$image['src']?>" alt="<?=$image['alt']?>"/> <?php endforeach;?>
Повторное использование кода шаблона
Части шаблона можно переиспользовать в зависимости от входящих условий или в случае когда верстка различных элементов идентична.
template.php
<?php if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die(); $view = (new Msvdev\Bitrix\View\ViewPhp($this,'parts'))->getView(); ?> <div> ...some code.. <?php foreach ($arResult['ITEMS'] as $arItem):?> <?=$view->render('item',['arItem' => $arItem])?> <?php endforeach;?> ...some code... <span>Show first item</span> <?=$view->render('item',['arItem' => $arResult['ITEMS'][0]])?> </div>
part/item.html.php
<?php if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die(); /** * @var array $arItem * @var \Symfony\Component\Templating\PhpEngine $view */ ?> <div> <?= $arItem['NAME'] ?> <?php if(sizeof($arItem['IMAGES'])):?> <?php // Шаблоны можно вкладывать в друг-друга (part/images.html.php) echo $view->render('images',['images' => $arItem['IMAGES']]) ?> <?php endif?> </div>
Экранирование вывода
<?php echo $view->escape($firstname) ?> <?php echo $view->escape($var, 'js') ?>
Что еще?
Использование шаблонизации symfony в битрикс не ограничивается дополнением к стандартным шаблонам. Хотя даже в этом случае открыт невероятный простор для оптимизации вашего кода.
Подробнее о возможностях шаблонизатора можно всегда почитать в официальной документации.