Pull to refresh

Использование Pjax в Yii2 (краткий обзор)

Reading time 2 min
Views 88K
Разрабатываю проект на yii2, попутно изучая фреймворк, и не смог не поделиться одним из замечательных инструментов, который он представляет. Пост будет полезен тем, кто до этого с Pjax не работал. Опытным разработчикам, которые уделят посту время, буду благодарен за указание на неточности и дополнения, так пост станет полезнее и информативнее.

Для справки:
Pjax — это jquery плагин, который использует pushState и ajax и предоставляет возможность грузить страницу не полностью при переходе по ссылкам, а частично, но с соответствующим заголовком страницы и возможностью возврата назад

Использование Pjax с GridView


Хорошо об этом написано здесь.

Если в кратце, то для того, чтобы pjax заработал, надо виджет GridView обернуть следующим образом:

<?php \yii\widgets\Pjax::begin(); ?>
<?= GridView::widget([
// ... configuration here
]);
<?php \yii\widgets\Pjax::end(); ?>


Если же вы не хотите, чтобы все ссылки осуществляли pjax запрос, то следует исключаемым ссылкам добавить атрибут data-pjax=0. Например так:

<?= \yii\helpers\Html::a(Yii::t('app', 'подробнее...'), ['car/view', 'id' => $car->id], ['data-pjax'=>0]) ?>


Так же у виджета pjax есть свойство:

public $linkSelector;


Его можно использовать для выборки ссылок, которые будут обрабатываться с использованием pjax.

pjax на сабмит формы

Если вы хотите повесить pjax на сабмит формы, то вам следует добавить ей атрибут data-pjax=1, так как по умолчанию код, формируемый виджетом, выглядит следующим образом:

jQuery(document).on('submit', "#w2 form[data-pjax]", function (event) {jQuery.pjax.submit(event, '#w2', {"push":true,"replace":false,"timeout":1000,"scrollTo":false});});


Однако, вы так же можете его изменить, используя свойство:

public $formSelector;


Где почитать подробнее

Ссылка на pjax виджет github.com/yiisoft/yii2-framework/blob/master/widgets/Pjax.php
Ссылка на pjax плагин github.com/yiisoft/jquery-pjax
Tags:
Hubs:
+1
Comments 5
Comments Comments 5

Articles