LinkPager.php 6.88 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13
<?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\InvalidConfigException;
use yii\helpers\Html;
use yii\base\Widget;
14
use yii\data\Pagination;
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38

/**
 * LinkPager displays a list of hyperlinks that lead to different pages of target.
 *
 * LinkPager works with a [[Pagination]] object which specifies the totally number
 * of pages and the current page number.
 *
 * Note that LinkPager only generates the necessary HTML markups. In order for it
 * to look like a real pager, you should provide some CSS styles for it.
 * With the default configuration, LinkPager should look good using Twitter Bootstrap CSS framework.
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class LinkPager extends Widget
{
	/**
	 * @var Pagination the pagination object that this pager is associated with.
	 * You must set this property in order to make LinkPager work.
	 */
	public $pagination;
	/**
	 * @var array HTML attributes for the pager container tag.
	 */
Alexander Makarov committed
39
	public $options = ['class' => 'pagination'];
40 41 42 43
	/**
	 * @var array HTML attributes for the link in a pager container tag.
	 */
	public $linkOptions = [];
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
	/**
	 * @var string the CSS class for the "first" page button.
	 */
	public $firstPageCssClass = 'first';
	/**
	 * @var string the CSS class for the "last" page button.
	 */
	public $lastPageCssClass = 'last';
	/**
	 * @var string the CSS class for the "previous" page button.
	 */
	public $prevPageCssClass = 'prev';
	/**
	 * @var string the CSS class for the "next" page button.
	 */
	public $nextPageCssClass = 'next';
	/**
	 * @var string the CSS class for the active (currently selected) page button.
	 */
	public $activePageCssClass = 'active';
	/**
	 * @var string the CSS class for the disabled page buttons.
	 */
	public $disabledPageCssClass = 'disabled';
	/**
	 * @var integer maximum number of page buttons that can be displayed. Defaults to 10.
	 */
	public $maxButtonCount = 10;
	/**
	 * @var string the label for the "next" page button. Note that this will NOT be HTML-encoded.
	 * If this property is null, the "next" page button will not be displayed.
	 */
	public $nextPageLabel = '&raquo;';
	/**
	 * @var string the text label for the previous page button. Note that this will NOT be HTML-encoded.
	 * If this property is null, the "previous" page button will not be displayed.
	 */
	public $prevPageLabel = '&laquo;';
	/**
	 * @var string the text label for the "first" page button. Note that this will NOT be HTML-encoded.
	 * If this property is null, the "first" page button will not be displayed.
	 */
	public $firstPageLabel;
	/**
	 * @var string the text label for the "last" page button. Note that this will NOT be HTML-encoded.
	 * If this property is null, the "last" page button will not be displayed.
	 */
	public $lastPageLabel;
92 93 94 95 96 97 98
	/**
	 * @var bool whether to register link tags in the HTML header for prev, next, first and last page.
	 * Defaults to `false` to avoid conflicts when multiple pagers are used on one page.
	 * @see http://www.w3.org/TR/html401/struct/links.html#h-12.1.2
	 * @see registerLinkTags()
	 */
	public $registerLinkTags = false;
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116


	/**
	 * Initializes the pager.
	 */
	public function init()
	{
		if ($this->pagination === null) {
			throw new InvalidConfigException('The "pagination" property must be set.');
		}
	}

	/**
	 * Executes the widget.
	 * This overrides the parent implementation by displaying the generated page buttons.
	 */
	public function run()
	{
117 118 119
		if ($this->registerLinkTags) {
			$this->registerLinkTags();
		}
120
		echo $this->renderPageButtons();
121 122
	}

123 124 125 126 127 128 129 130
	/**
	 * Registers relational link tags in the html header for prev, next, first and last page.
	 * These links are generated using [[yii\data\Pagination::getLinks()]].
	 * @see http://www.w3.org/TR/html401/struct/links.html#h-12.1.2
	 */
	protected function registerLinkTags()
	{
		$view = $this->getView();
AlexGx committed
131
		foreach ($this->pagination->getLinks() as $rel => $href) {
132 133 134 135
			$view->registerLinkTag(['rel' => $rel, 'href' => $href], $rel);
		}
	}

136
	/**
137 138
	 * Renders the page buttons.
	 * @return string the rendering result
139
	 */
140
	protected function renderPageButtons()
141
	{
Alexander Makarov committed
142
		$buttons = [];
143

144
		$pageCount = $this->pagination->getPageCount();
145 146 147 148
		$currentPage = $this->pagination->getPage();

		// first page
		if ($this->firstPageLabel !== null) {
149
			$buttons[] = $this->renderPageButton($this->firstPageLabel, 0, $this->firstPageCssClass, $currentPage <= 0, false);
150 151 152 153 154 155 156
		}

		// prev page
		if ($this->prevPageLabel !== null) {
			if (($page = $currentPage - 1) < 0) {
				$page = 0;
			}
157
			$buttons[] = $this->renderPageButton($this->prevPageLabel, $page, $this->prevPageCssClass, $currentPage <= 0, false);
158 159 160 161 162
		}

		// internal pages
		list($beginPage, $endPage) = $this->getPageRange();
		for ($i = $beginPage; $i <= $endPage; ++$i) {
163
			$buttons[] = $this->renderPageButton($i + 1, $i, null, false, $i == $currentPage);
164 165 166 167 168 169 170
		}

		// next page
		if ($this->nextPageLabel !== null) {
			if (($page = $currentPage + 1) >= $pageCount - 1) {
				$page = $pageCount - 1;
			}
171
			$buttons[] = $this->renderPageButton($this->nextPageLabel, $page, $this->nextPageCssClass, $currentPage >= $pageCount - 1, false);
172 173 174 175
		}

		// last page
		if ($this->lastPageLabel !== null) {
176
			$buttons[] = $this->renderPageButton($this->lastPageLabel, $pageCount - 1, $this->lastPageCssClass, $currentPage >= $pageCount - 1, false);
177 178
		}

179
		return Html::tag('ul', implode("\n", $buttons), $this->options);
180 181 182
	}

	/**
183
	 * Renders a page button.
184 185 186 187 188 189
	 * You may override this method to customize the generation of page buttons.
	 * @param string $label the text label for the button
	 * @param integer $page the page number
	 * @param string $class the CSS class for the page button.
	 * @param boolean $disabled whether this page button is disabled
	 * @param boolean $active whether this page button is active
190
	 * @return string the rendering result
191
	 */
192
	protected function renderPageButton($label, $page, $class, $disabled, $active)
193
	{
194
		$options = ['class' => $class === '' ? null : $class];
195
		if ($active) {
196
			Html::addCssClass($options, $this->activePageCssClass);
197 198
		}
		if ($disabled) {
199 200
			Html::addCssClass($options, $this->disabledPageCssClass);
			return Html::tag('li', Html::tag('span', $label), $options);
201
		}
202 203 204
		$linkOptions = $this->linkOptions;
		$linkOptions['data-page'] = $page;
		return Html::tag('li', Html::a($label, $this->pagination->createUrl($page), $linkOptions), $options);
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219
	}

	/**
	 * @return array the begin and end pages that need to be displayed.
	 */
	protected function getPageRange()
	{
		$currentPage = $this->pagination->getPage();
		$pageCount = $this->pagination->getPageCount();

		$beginPage = max(0, $currentPage - (int)($this->maxButtonCount / 2));
		if (($endPage = $beginPage + $this->maxButtonCount - 1) >= $pageCount) {
			$endPage = $pageCount - 1;
			$beginPage = max(0, $endPage - $this->maxButtonCount + 1);
		}
Alexander Makarov committed
220
		return [$beginPage, $endPage];
221
	}
222
}