Paul Klimov
7 years ago
committed by
GitHub
15 changed files with 15 additions and 445 deletions
@ -1,216 +0,0 @@
|
||||
<?php |
||||
/** |
||||
* @link http://www.yiiframework.com/ |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yii\widgets; |
||||
|
||||
use Yii; |
||||
use yii\base\Widget; |
||||
use yii\helpers\ArrayHelper; |
||||
use yii\helpers\Html; |
||||
use yii\helpers\Json; |
||||
use yii\web\Response; |
||||
|
||||
/** |
||||
* Pjax is a widget integrating the [pjax](https://github.com/yiisoft/jquery-pjax) jQuery plugin. |
||||
* |
||||
* Pjax only deals with the content enclosed between its [[begin()]] and [[end()]] calls, called the *body content* of the widget. |
||||
* By default, any link click or form submission (for those forms with `data-pjax` attribute) within the body content |
||||
* will trigger an AJAX request. In responding to the AJAX request, Pjax will send the updated body content (based |
||||
* on the AJAX request) to the client which will replace the old content with the new one. The browser's URL will then |
||||
* be updated using pushState. The whole process requires no reloading of the layout or resources (js, css). |
||||
* |
||||
* You may configure [[linkSelector]] to specify which links should trigger pjax, and configure [[formSelector]] |
||||
* to specify which form submission may trigger pjax. |
||||
* |
||||
* You may disable pjax for a specific link inside the container by adding `data-pjax="0"` attribute to this link. |
||||
* |
||||
* The following example shows how to use Pjax with the [[\yii\grid\GridView]] widget so that the grid pagination, |
||||
* sorting and filtering can be done via pjax: |
||||
* |
||||
* ```php |
||||
* use yii\widgets\Pjax; |
||||
* |
||||
* Pjax::begin(); |
||||
* echo GridView::widget([...]); |
||||
* Pjax::end(); |
||||
* ``` |
||||
* |
||||
* @author Qiang Xue <qiang.xue@gmail.com> |
||||
* @since 2.0 |
||||
*/ |
||||
class Pjax extends Widget |
||||
{ |
||||
/** |
||||
* @var array the HTML attributes for the widget container tag. The following special options are recognized: |
||||
* |
||||
* - `tag`: string, the tag name for the container. Defaults to `div` |
||||
* This option is available since version 2.0.7. |
||||
* See also [[\yii\helpers\Html::tag()]]. |
||||
* |
||||
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
||||
*/ |
||||
public $options = []; |
||||
/** |
||||
* @var string|false the jQuery selector of the links that should trigger pjax requests. |
||||
* If not set, all links within the enclosed content of Pjax will trigger pjax requests. |
||||
* If set to false, no code will be registered to handle links. |
||||
* Note that if the response to the pjax request is a full page, a normal request will be sent again. |
||||
*/ |
||||
public $linkSelector; |
||||
/** |
||||
* @var string|false the jQuery selector of the forms whose submissions should trigger pjax requests. |
||||
* If not set, all forms with `data-pjax` attribute within the enclosed content of Pjax will trigger pjax requests. |
||||
* If set to false, no code will be registered to handle forms. |
||||
* Note that if the response to the pjax request is a full page, a normal request will be sent again. |
||||
*/ |
||||
public $formSelector; |
||||
/** |
||||
* @var string The jQuery event that will trigger form handler. Defaults to "submit". |
||||
* @since 2.0.9 |
||||
*/ |
||||
public $submitEvent = 'submit'; |
||||
/** |
||||
* @var bool whether to enable push state. |
||||
*/ |
||||
public $enablePushState = true; |
||||
/** |
||||
* @var bool whether to enable replace state. |
||||
*/ |
||||
public $enableReplaceState = false; |
||||
/** |
||||
* @var int pjax timeout setting (in milliseconds). This timeout is used when making AJAX requests. |
||||
* Use a bigger number if your server is slow. If the server does not respond within the timeout, |
||||
* a full page load will be triggered. |
||||
*/ |
||||
public $timeout = 1000; |
||||
/** |
||||
* @var bool|int how to scroll the page when pjax response is received. If false, no page scroll will be made. |
||||
* Use a number if you want to scroll to a particular place. |
||||
*/ |
||||
public $scrollTo = false; |
||||
/** |
||||
* @var array additional options to be passed to the pjax JS plugin. Please refer to the |
||||
* [pjax project page](https://github.com/yiisoft/jquery-pjax) for available options. |
||||
*/ |
||||
public $clientOptions; |
||||
/** |
||||
* {@inheritdoc} |
||||
* @internal |
||||
*/ |
||||
public static $counter = 0; |
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public static $autoIdPrefix = 'p'; |
||||
|
||||
|
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public function init() |
||||
{ |
||||
parent::init(); |
||||
if (!isset($this->options['id'])) { |
||||
$this->options['id'] = $this->getId(); |
||||
} |
||||
|
||||
if ($this->requiresPjax()) { |
||||
ob_start(); |
||||
ob_implicit_flush(false); |
||||
$view = $this->getView(); |
||||
$view->clear(); |
||||
$view->beginPage(); |
||||
$view->head(); |
||||
$view->beginBody(); |
||||
if ($view->title !== null) { |
||||
echo Html::tag('title', Html::encode($view->title)); |
||||
} |
||||
} else { |
||||
$options = $this->options; |
||||
$tag = ArrayHelper::remove($options, 'tag', 'div'); |
||||
echo Html::beginTag($tag, array_merge([ |
||||
'data-pjax-container' => '', |
||||
'data-pjax-push-state' => $this->enablePushState, |
||||
'data-pjax-replace-state' => $this->enableReplaceState, |
||||
'data-pjax-timeout' => $this->timeout, |
||||
'data-pjax-scrollto' => $this->scrollTo, |
||||
], $options)); |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public function run() |
||||
{ |
||||
if (!$this->requiresPjax()) { |
||||
echo Html::endTag(ArrayHelper::remove($this->options, 'tag', 'div')); |
||||
$this->registerClientScript(); |
||||
|
||||
return; |
||||
} |
||||
|
||||
$view = $this->getView(); |
||||
$view->endBody(); |
||||
|
||||
$view->endPage(true); |
||||
|
||||
$content = ob_get_clean(); |
||||
|
||||
// only need the content enclosed within this widget |
||||
$response = Yii::$app->getResponse(); |
||||
$response->clearOutputBuffers(); |
||||
$response->setStatusCode(200); |
||||
$response->format = Response::FORMAT_HTML; |
||||
$response->content = $content; |
||||
$response->headers->setDefault('X-Pjax-Url', Yii::$app->request->url); |
||||
$response->send(); |
||||
|
||||
Yii::$app->end(); |
||||
} |
||||
|
||||
/** |
||||
* @return bool whether the current request requires pjax response from this widget |
||||
*/ |
||||
protected function requiresPjax() |
||||
{ |
||||
$request = Yii::$app->getRequest(); |
||||
return $request->hasHeader('X-Pjax') && explode(' ', $request->getHeader('X-Pjax-Container')[0])[0] === '#' . $this->options['id']; |
||||
} |
||||
|
||||
/** |
||||
* Registers the needed JavaScript. |
||||
*/ |
||||
public function registerClientScript() |
||||
{ |
||||
$id = $this->options['id']; |
||||
$this->clientOptions['push'] = $this->enablePushState; |
||||
$this->clientOptions['replace'] = $this->enableReplaceState; |
||||
$this->clientOptions['timeout'] = $this->timeout; |
||||
$this->clientOptions['scrollTo'] = $this->scrollTo; |
||||
if (!isset($this->clientOptions['container'])) { |
||||
$this->clientOptions['container'] = "#$id"; |
||||
} |
||||
$options = Json::htmlEncode($this->clientOptions); |
||||
$js = ''; |
||||
if ($this->linkSelector !== false) { |
||||
$linkSelector = Json::htmlEncode($this->linkSelector !== null ? $this->linkSelector : '#' . $id . ' a'); |
||||
$js .= "jQuery(document).pjax($linkSelector, $options);"; |
||||
} |
||||
if ($this->formSelector !== false) { |
||||
$formSelector = Json::htmlEncode($this->formSelector !== null ? $this->formSelector : '#' . $id . ' form[data-pjax]'); |
||||
$submitEvent = Json::htmlEncode($this->submitEvent); |
||||
$js .= "\njQuery(document).on($submitEvent, $formSelector, function (event) {jQuery.pjax.submit(event, $options);});"; |
||||
} |
||||
$view = $this->getView(); |
||||
PjaxAsset::register($view); |
||||
|
||||
if ($js !== '') { |
||||
$view->registerJs($js); |
||||
} |
||||
} |
||||
} |
@ -1,35 +0,0 @@
|
||||
<?php |
||||
/** |
||||
* @link http://www.yiiframework.com/ |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yii\widgets; |
||||
|
||||
use yii\web\AssetBundle; |
||||
use yii\web\YiiAsset; |
||||
|
||||
/** |
||||
* This asset bundle provides the javascript files required by [[Pjax]] widget. |
||||
* |
||||
* @author Qiang Xue <qiang.xue@gmail.com> |
||||
* @since 2.0 |
||||
*/ |
||||
class PjaxAsset extends AssetBundle |
||||
{ |
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public $sourcePath = '@bower/yii2-pjax'; |
||||
|
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public $js = ['jquery.pjax.js',]; |
||||
|
||||
/** |
||||
* {@inheritdoc} |
||||
*/ |
||||
public $depends = [YiiAsset::class]; |
||||
} |
@ -1,59 +0,0 @@
|
||||
<?php |
||||
/** |
||||
* @link http://www.yiiframework.com/ |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yiiunit\framework\widgets; |
||||
|
||||
use yii\data\ArrayDataProvider; |
||||
use yii\widgets\ListView; |
||||
use yii\widgets\Pjax; |
||||
use yiiunit\TestCase; |
||||
|
||||
class PjaxTest extends TestCase |
||||
{ |
||||
public function testGeneratedIdByPjaxWidget() |
||||
{ |
||||
ListView::$counter = 0; |
||||
Pjax::$counter = 0; |
||||
$nonPjaxWidget1 = new ListView(['dataProvider' => new ArrayDataProvider()]); |
||||
ob_start(); |
||||
$pjax1 = new Pjax(); |
||||
ob_end_clean(); |
||||
$nonPjaxWidget2 = new ListView(['dataProvider' => new ArrayDataProvider()]); |
||||
ob_start(); |
||||
$pjax2 = new Pjax(); |
||||
ob_end_clean(); |
||||
|
||||
$this->assertEquals('w0', $nonPjaxWidget1->options['id']); |
||||
$this->assertEquals('w1', $nonPjaxWidget2->options['id']); |
||||
$this->assertEquals('p0', $pjax1->options['id']); |
||||
$this->assertEquals('p1', $pjax2->options['id']); |
||||
} |
||||
|
||||
protected function setUp() |
||||
{ |
||||
parent::setUp(); |
||||
$this->mockWebApplication(); |
||||
} |
||||
|
||||
/** |
||||
* @see https://github.com/yiisoft/yii2/issues/15536 |
||||
*/ |
||||
public function testShouldTriggerInitEvent() |
||||
{ |
||||
$initTriggered = false; |
||||
ob_start(); |
||||
$pjax = new Pjax( |
||||
[ |
||||
'on init' => function () use (&$initTriggered) { |
||||
$initTriggered = true; |
||||
} |
||||
] |
||||
); |
||||
ob_end_clean(); |
||||
$this->assertTrue($initTriggered); |
||||
} |
||||
} |
Loading…
Reference in new issue