Класс PaginatorHelper
Класс помощник для пагинации для лёгкого генерирования ссылок пагинации.
PaginatorHelper включает все методы, необходимые при работе с пагинацией.
- Cake\View\Helper implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\PaginatorHelper uses Cake\View\StringTemplateTrait
Ссылка: https://book.cakephp.org/3.0/ru/views/helpers/paginator.html
Расположение: View/Helper/PaginatorHelper.php
Краткое описание свойств
-
$_defaultConfigprotectedЗначение по умолчанию для этого классаarray -
$_defaultModelprotectedМодель по умолчанию для страницstring -
$helperspublicСписок помощников, используемых этим помощникомarray
Краткое описание магических свойств
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор. Переопределён для слияния переданных аргументов с опциями URL.
- _firstNumber() protectedГенерирует первое число для метода numbers() пагинатора.
- _formatNumber() protectedФорматирует число для вывода номера пагинатора.
- _getNumbersStartAndEnd() protectedВычисляет начало и конец для номеров пагинации.
- _hasPage() protectedСодержит ли $model страницу $page в своём диапазоне?
- _lastNumber() protectedГенерирует последнее число для метода numbers() пагинатора.
- _modulusNumbers() protectedГенерирует номера для метода numbers() пагинатора.
- _numbers() protectedГенерирует номера для метода numbers() пагинатора.
- _removeAlias() protectedУдалить псевдоним, если нужно.
- _toggledLink() protectedГенерировать активную/неактивную ссылку для методов next/prev.
- counter() publicВозвращает строку счётчика для набора результатов страниц
- current() publicПолучает текущую страницу набора записей для заданной модели
- defaultModel() publicПолучает или устанавливает модель по умолчанию для наборов страниц
- first() publicВозвращает первую или набор чисел для первых страниц.
- generateUrl() publicОбъединяет переданные опции URL с текущим состоянием пагинации для генерации URL пагинации.
- generateUrlParams() publicОбъединяет переданные опции URL с текущим состоянием пагинации для генерации URL пагинации.
- hasNext() publicВозвращает true, если заданный набор результатов не на последней странице
- hasPage() publicВозвращает true, если заданный набор результатов содержит номер страницы, заданный $page
- hasPrev() publicВозвращает true, если заданный набор результатов не на первой странице
- implementedEvents() publicОбработчики событий.
- last() publicВозвращает последнюю или набор чисел для последних страниц.
- limitControl() public
Выпадающий список для ограничения пагинации. Это сгенерирует форму обёртки.
- meta() publicВозвращает мета-ссылки для набора результатов пагинации.
- next() publicГенерирует ссылку "следующая" для набора страниц записей
- numbers() public
Возвращает набор номеров для набора результатов страниц, использует модуль, чтобы решить, сколько чисел отображать по обе стороны от текущей страницы (по умолчанию: 8).
- options() publicУстанавливает параметры по умолчанию для всех ссылок пагинации
- param() publicУдобный доступ к любому из параметров пагинатора.
- params() publicПолучает текущие параметры страниц из набора результатов для заданной модели
- prev() publicГенерирует ссылку "предыдущая" для набора страниц записей
- sort() public
Генерирует ссылку сортировки. Устанавливает именованные параметры для сортировки и направления. Автоматически обрабатывает переключение направления.
- sortDir() publicПолучает текущее направление сортировки набора записей
- sortKey() publicПолучает текущий ключ, по которому сортируется набор записей
- total() publicПолучает общее количество страниц в наборе результатов для заданной модели.
Подробное описание методов
__construct()source public
__construct( Cake\View\View $View , array $config = [] )
Конструктор. Переопределён для слияния переданных аргументов с опциями URL.
Параметры
-
Cake\View\View$View - Вид, к которому прикреплён помощник.
- массив
$configнеобязательный [] - Настройки конфигурации помощника.
Переопределяет
Cake\View\Helper::__construct() _firstNumber()source protected
_firstNumber( string $ellipsis , array $params , integer $start , array $options )
Генерирует первое число для метода numbers() пагинатора.
Параметры
- строка
$ellipsis - Символ многоточия.
- массив
$params - Параметры из метода numbers().
- целое число
$start - Начальное число.
- массив
$options - Опции из метода numbers().
Возвращает
строкаВывод разметки.
_formatNumber()source protected
_formatNumber( Cake\View\StringTemplate $templater , array $options )
Форматирует число для вывода номера страницы пагинатора.
Параметры
-
Cake\View\StringTemplate$templater - Экземпляр StringTemplate.
- массив
$options - Опции из метода numbers().
Возвращаемое значение
строка_getNumbersStartAndEnd()source protected
_getNumbersStartAndEnd( array $params , array $options )
Вычисляет начальное и конечное значение для номеров страниц пагинации.
Параметры
- массив
$params - Параметры из метода numbers().
- массив
$options - Опции из метода numbers().
Возвращаемое значение
массивМассив с начальным и конечным номерами страниц.
_hasPage()source protected
_hasPage( string $model , integer $page )
Модель $model содержит $page в своем диапазоне?
Параметры
- строка
$model - Имя модели для получения параметров.
- целое число
$page - Номер страницы, которую проверяете.
Возвращаемое значение
булевоСодержит ли модель $page
_lastNumber()source protected
_lastNumber( string $ellipsis , array $params , integer $end , array $options )
Генерирует последний номер для метода numbers() пагинатора.
Параметры
- строка
$ellipsis - Символ многоточия.
- массив
$params - Параметры из метода numbers().
- целое число
$end - Конечный номер.
- массив
$options - Опции из метода numbers().
Возвращаемое значение
строкаВывод разметки.
_modulusNumbers()source protected
_modulusNumbers( Cake\View\StringTemplate $templater , array $params , array $options )
Генерирует числа для метода numbers() пагинатора.
Параметры
-
Cake\View\StringTemplate$templater - Экземпляр StringTemplate.
- массив
$params - Параметры из метода numbers().
- массив
$options - Опции из метода numbers().
Возвращаемое значение
строкаВывод разметки.
_numbers()source protected
_numbers( Cake\View\StringTemplate $templater , array $params , array $options )
Генерирует числа для метода numbers() пагинатора.
Параметры
-
Cake\View\StringTemplate$templater - Экземпляр StringTemplate.
- массив
$params - Параметры из метода numbers().
- массив
$options - Опции из метода numbers().
Возвращаемое значение
строкаВывод разметки.
_removeAlias()source protected
_removeAlias( string $field , string|null $model = null )
Удаляет псевдоним, если нужно.
Параметры
- строка
$field - Текущее поле
- строка|null
$modelнеобязательно null - Текущий псевдоним модели
Возвращаемое значение
строкаНе псевдонимизированное поле, если применимо
_toggledLink()source protected
_toggledLink( string|boolean $text , boolean $enabled , array $options , array $templates )
Генерирует активную/неактивную ссылку для методов next/prev.
Параметры
- строка|булево
$text - Текст для активной ссылки.
- булево
$enabled - Необходимо ли создавать активную/неактивную версию.
- массив
$options - Массив опций из вызываемого метода.
- массив
$templates - Массив шаблонов с ключами 'active' и 'disabled'.
Возвращаемое значение
строкаСгенерированный HTML
counter()source public
counter( string|array $options = [] )
Возвращает строку счётчика для набора результатов, разбитого на страницы.
Опции
-
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel(); -
formatФорматная строка, которую вы хотите использовать, по умолчанию 'pages'. Она генерирует вывод вида '1 из 5'. Если установить 'range', то генерирует вывод вида '1 - 3 из 13'. Также может быть установлена пользовательская строка, содержащая следующие плейсхолдеры{{page}},{{pages}},{{current}},{{count}},{{model}},{{start}},{{end}}, и любой пользовательский контент.
Параметры
- строка|массив
$optionsнеобязательно [] Опции для строки счётчика. См. раздел «Опции» для списка ключей. Если строка, она будет использоваться как формат.
Возвращаемое значение
строкаСтрока счётчика.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-a-page-countercurrent()source public
current( string|null $model = null )
Возвращает текущую страницу набора записей для заданной модели.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Если не указано, используется значение по умолчанию.
Возвращаемое значение
целое числоНомер текущей страницы набора записей.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#checking-the-pagination-statedefaultModel()source public
defaultModel( string|null $model = null )
Возвращает или устанавливает модель по умолчанию для набора страниц.
Параметры
- строка|null
$modelнеобязательно null - Имя модели для установки
Возвращаемое значение
строка|nullИмя модели или null, если пагинация не инициализирована.
first()source public
first( string|integer $first = '<< first' , array $options = [] )
Возвращает первую или набор номеров для первых страниц.
echo $this->Paginator->first('< first'); Создаёт единственную ссылку для первой страницы. Не выводит ничего, если вы находитесь на первой странице.
echo $this->Paginator->first(3);
Создаст ссылки для первых 3 страниц, как только вы перейдете на третью или более страницу. До этого ничего не будет выведено.
Опции:
-
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel() -
escapeНеобходимо ли экранировать текст в HTML. -
urlМассив дополнительных опций URL для генерации ссылок.
Параметры
- строка|целое число
$firstнеобязательно '<< first' Если строка, используется как метка для ссылки. Если число, то количество ссылок на страницы в начале диапазона.
- массив
$optionsнеобязательно [] - Массив опций.
Возвращаемое значение
строка|ложьСтрока номеров.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-jump-linksgenerateUrl()source public
generateUrl( array $options = [] , string|null $model = null , array $urlOptions = [] )
Объединяет переданные опции URL с текущим состоянием пагинации для генерации URL пагинации.
Опции URL:
-
escape: Если false, URL будет возвращен без экранирования, используйте только в том случае, если он будет вручную экранирован перед отображением. -
fullBase: Если true, полный базовый URL будет добавлен в результат
Параметры
- массив
$optionsнеобязательно [] - Массив опций пагинации/URL
- строка|null
$modelнеобязательно null - Модель, по которой нужно производить пагинацию
- массив
$urlOptionsнеобязательно [] Массив опций. Булевое значение этого аргумента устарело и будет удалено в версии 4.0.0.
Возвращаемое значение
строкаПо умолчанию возвращает полную строку URL пагинации для использования в нестандартных контекстах (например, JavaScript)
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#generating-pagination-urlsgenerateUrlParams()source public
generateUrlParams( array $options = [] , string|null $model = null )
Объединяет переданные параметры URL с текущим состоянием пагинации для создания URL пагинации.
Параметры
- массив
$optionsнеобязательно [] - Массив опций пагинации/URL
- строка|null
$modelнеобязательно null - Модель, по которой нужно выполнить пагинацию
Возвращает
массивМассив параметров URL
hasNext()source public
hasNext( string|null $model = null )
Возвращает true, если заданный набор результатов не находится на последней странице.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если не указано.
Возвращает
booleanTrue, если набор результатов не находится на последней странице.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#checking-the-pagination-statehasPage()source public
hasPage( string|null $model = null , integer $page = 1 )
Возвращает true, если заданный набор результатов содержит указанную страницу с номером $page.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если не указано.
- целое число
$pageнеобязательно 1 - Номер страницы — если не задан, используется значение по умолчанию 1.
Возвращает
booleanTrue, если заданный набор результатов содержит указанную страницу.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#checking-the-pagination-statehasPrev()source public
hasPrev( string|null $model = null )
Возвращает true, если заданный набор результатов не находится на первой странице.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если не указано.
Возвращает
booleanTrue, если набор результатов не находится на первой странице.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#checking-the-pagination-stateimplementedEvents()source public
implementedEvents( )
Обработчики событий.
Возвращает
массивПереопределяет
Cake\View\Helper::implementedEvents() last()source public
last( string|integer $last = 'last >>' , array $options = [] )
Возвращает последнюю страницу или набор чисел для последних страниц.
echo $this->Paginator->last('last >'); Создает ссылку на последнюю страницу. Ничего не выведет, если вы на последней странице.
echo $this->Paginator->last(3);
Создаст ссылки на последние 3 страницы. Как только вы войдете в диапазон страниц, ничего не будет выведено.
Параметры:
-
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel() -
escapeНужно ли HTML-кодировать текст. -
urlМассив дополнительных параметров URL для генерации ссылок.
Параметры
- строка|число
$lastнеобязательно 'последняя >>' - Если строка, используется в качестве метки для ссылки, если число, выводятся номера страниц
- массив
$optionsнеобязательно [] - Массив параметров
Возвращает
строка|ложьСтрока с номерами.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-jump-linkslimitControl()source public
limitControl( array $limits = [] , integer|null $default = null , array $options = [] )
Выпадающий список для ограничения пагинации. Это сгенерирует форму.
Параметры
- массив
$limitsнеобязательно [] - Массив параметров.
- целое число|null
$defaultнеобязательно null - Значение по умолчанию для ограничения пагинации. По умолчанию
$this->param('perPage'). - массив
$optionsнеобязательно [] - Параметры для тега Select, такие как class, id или event
Возвращает
строкаHTML вывод.
meta()source public
meta( array $options = [] )
Возвращает мета-ссылки для набора результатов пагинации.
echo $this->Paginator->meta();
Выводит ссылки напрямую. Ничего не выведет, если нет ни предыдущей, ни следующей страницы.
$this->Paginator->meta(['block' => true]);
Добавит результат работы функции мета в указанный блок — если передано true, используется блок "мета".
Параметры:
-
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel() -
blockИмя блока, в который добавить вывод, или false/отсутствует, чтобы вернуть как строку -
prev(по умолчанию True) True, чтобы сгенерировать мета для предыдущей страницы -
next(по умолчанию True) True, чтобы сгенерировать мета для следующей страницы -
first(по умолчанию False) True, чтобы сгенерировать мета для первой страницы -
last(по умолчанию False) True, чтобы сгенерировать мета для последней страницы
Параметры
- массив
$optionsнеобязательно [] - Массив параметров
Возвращает
строка|nullМета-ссылки
next()source public
next( string $title = 'Next >>' , array $options = [] )
Генерирует ссылку "следующая" для набора отсортированных записей.
Параметры:
-
disabledTitleТекст, используемый, когда ссылка отключена. По умолчанию такой же, как у активной ссылки. Если значение false, метод возвращает пустую строку. -
escapeНужно ли кодировать содержимое HTML, по умолчанию true -
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel() -
urlМассив дополнительных параметров URL для генерации ссылок. -
templatesМассив шаблонов или имя файла шаблона, содержащего шаблоны, которые вы хотите использовать при генерации ссылки на следующую страницу. Исходные шаблоны помощника будут восстановлены после выполнения next().
Параметры
- строка
$titleнеобязательно 'Следующая >>' - Заголовок ссылки. По умолчанию 'Следующая >>'.
- массив
$optionsнеобязательно [] - Параметры для ссылки на страницу. См. выше список ключей.
Возвращает
строкаСсылка "следующая" или текст $disabledTitle, если ссылка отключена.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-jump-linksnumbers()source public
numbers( array $options = [] )
Возвращает набор чисел для результирующего набора страниц, используя модуль, чтобы определить, сколько чисел отображать по обе стороны от текущей страницы (по умолчанию: 8).
$this->Paginator->numbers(['first' => 2, 'last' => 2]);
Используя опции first и last, вы можете создать ссылки на начало и конец набора страниц.
Параметры
-
beforeСодержимое, которое будет вставлено перед числами, но после первых ссылок. -
afterСодержимое, которое будет вставлено после чисел, но перед последними ссылками. -
modelМодель, для которой создаются числа, по умолчанию PaginatorHelper::defaultModel() -
modulusКоличество чисел, которые нужно включить по обе стороны от текущей страницы, по умолчанию 8. Установите вfalse, чтобы отключить и отобразить все числа. -
firstНужно ли генерировать ссылки на первую страницу, установите целое число, чтобы определить количество ссылок «первая» для генерации. Если задана строка, будет сгенерирована ссылка на первую страницу с указанным значением в качестве заголовка. -
lastНужно ли генерировать ссылки на последнюю страницу, установите целое число, чтобы определить количество ссылок «последняя» для генерации. Если задана строка, будет сгенерирована ссылка на последнюю страницу с указанным значением в качестве заголовка. -
templatesМассив шаблонов или имя файла шаблона, содержащего шаблоны, которые вы хотите использовать при генерации чисел. Исходные шаблоны помощника будут восстановлены после выполнения numbers(). -
urlМассив дополнительных параметров URL, которые нужно использовать для генерации ссылок.
Сгенерированные числовые ссылки будут включать шаблон «многоточие», когда опции first и last и количество страниц превышают модуль. Например, если у вас 25 страниц, и вы используете опции «первая»/«последняя» и модуль 8, содержимое «многоточие» будет вставлено после наборов ссылок «первая» и «последняя».
Параметры
- массив
$optionsнеобязательно [] - Параметры для чисел.
Возвращает
строка|ложьСтрока чисел.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-page-number-linksoptions()source public
options( array $options = [] )
Устанавливает значения параметров по умолчанию для всех ссылок постраничной навигации.
Параметры
- массив
$optionsнеобязательно [] Параметры по умолчанию для ссылок постраничной навигации. См. PaginatorHelper::$options для списка ключей.
param()source public
param( string $key , string|null $model = null )
Удобный доступ к любому из параметров пагинатора.
Параметры
- строка
$key - Ключ массива параметров пагинатора для извлечения.
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если оно не указано.
Возвращает
смешанноеСодержимое запрошенного параметра.
params()source public
params( string|null $model = null )
Получает текущие параметры постраничной навигации из набора результатов для заданной модели.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если оно не указано.
Возвращает
массивМассив параметров постраничной навигации для набора результирующих данных.
prev()source public
prev( string $title = '<< Previous' , array $options = [] )
Генерирует ссылку «предыдущая» для набора страниц записей.
Параметры:
-
disabledTitleТекст, используемый, когда ссылка отключена. По умолчанию совпадает с текстом активной ссылки. Установка в false приведет к тому, что этот метод вернет ''. -
escapeНужно ли кодировать содержимое в HTML-сущности, по умолчанию true -
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel() -
urlМассив дополнительных параметров URL для генерации ссылок. -
templatesМассив шаблонов или имя файла шаблона, содержащего шаблоны, которые вы хотите использовать при генерации ссылки на предыдущую страницу. Исходные шаблоны помощника будут восстановлены после выполнения prev().
Параметры
- строка
$titleнеобязательно '<< Предыдущая' - Заголовок ссылки. По умолчанию '<< Предыдущая'.
- массив
$optionsнеобязательно [] - Параметры для ссылки постраничной навигации. См. выше список ключей.
Возвращает
строкаСсылка «предыдущая» или отключенная ссылка.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-jump-linkssort()source public
sort( string $key , string|null $title = null , array $options = [] )
Генерирует ссылку сортировки. Устанавливает именованные параметры для сортировки и направления. Автоматически обрабатывает переключение направления.
Параметры:
-
escapeНужно ли кодировать содержимое в HTML-сущности, по умолчанию true. -
modelМодель для использования, по умолчанию PaginatorHelper::defaultModel(). -
directionНаправление по умолчанию для использования, когда эта ссылка не активна. -
lockЗаблокировать направление. Будет использоваться только направление по умолчанию, по умолчанию false.
Параметры
- строка
$key - Имя ключа, по которому должен быть отсортирован набор записей.
- строка|null
$titleнеобязательно null Заголовок ссылки. Если $title равен null, $key будет использован для заголовка и будет сгенерирован с помощью inflection.
- массив
$optionsнеобязательно [] - Параметры для ссылки сортировки. См. выше список ключей.
Возвращает
строкаСсылка для сортировки по умолчанию по «возрастанию». Если набор результатов отсортирован по «возрастанию» по указанному ключу, возвращаемая ссылка будет сортировать по «убыванию».
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-sort-linkssortDir()source public
sortDir( string|null $model = null , array $options = [] )
Получает текущее направление сортировки набора записей.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если оно не указано.
- массив
$optionsнеобязательно [] - Параметры для ссылок постраничной навигации. См. #options для списка ключей.
Возвращает
строкаНаправление, по которому отсортирован набор записей, или null, если результаты не отсортированы.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-sort-linkssortKey()source public
sortKey( string|null $model = null , array $options = [] )
Получает текущий ключ, по которому отсортирован набор записей.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если оно не указано.
- массив
$optionsнеобязательно [] - Параметры для ссылок постраничной навигации. См. #options для списка ключей.
Возвращает
строка|nullИмя ключа, по которому отсортирован набор записей, или null, если результаты не отсортированы.
Ссылка
https://book.cakephp.org/3.0/ru/views/helpers/paginator.html#creating-sort-linkstotal()source public
total( string|null $model = null )
Получает общее количество страниц в наборе записей для заданной модели.
Параметры
- строка|null
$modelнеобязательно null - Необязательное имя модели. Используется значение по умолчанию, если оно не указано.
Возвращает
целое числоОбщее количество страниц для набора записей.
Методы, унаследованные от Cake\View\Helper
__call()source public
__call( string $method , array $params )
Обеспечивает некритичные ошибки при вызовах отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
array__get()source public
__get( string $name )
Ленично загружает помощники.
Параметры
- string
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр помощника, если помощник с указанным именем существует
__set()source public
__set( string $name , mixed $value )
Магический метод установки для удаленных свойств.
Параметры
- string
$name - Имя свойства.
- mixed
$value - Значение для установки.
_cleanConfirmMessage()source protected
_cleanConfirmMessage( string $message )
Возвращает строку, готовую для использования в confirm()
Параметры
- string
$message - Сообщение для очистки
Возвращает
mixed_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode = '' , array $options = [] )
Возвращает строку, предназначенную для использования в качестве обработчика onclick для диалоговых окон подтверждения.
Параметры
- string
$message - Сообщение, которое должно быть отображено
- string
$okCode - Код, который должен быть выполнен после того, как пользователь выбрал 'OK'
- string
$cancelCodeoptional '' - Код, который должен быть выполнен после того, как пользователь выбрал 'Отмена'
- array
$optionsoptional [] - Массив параметров
Возвращает
stringкод onclick JS
addClass()source public
addClass( array $options = [] , string|null $class = null , string $key = 'class' )
Добавляет заданный класс к параметрам элемента.
Параметры
- array
$optionsoptional [] - Массив параметров/атрибутов, к которым добавляется класс
- string|null
$classoptional null - Имя добавляемого класса.
- string
$keyoptional 'class' - Ключ, используемый для класса.
Возвращает
arrayМассив параметров со значением $key.
getView()source public
getView( )
Получает экземпляр представления, к которому привязан этот помощник.
Возвращает
Cake\View\ViewЭкземпляр привязанного представления.
initialize()source public
initialize( array $config )
Метод-обработчик конструктора.
Реализуйте этот метод, чтобы избежать необходимости перезаписывать конструктор и вызывать родительский.
Параметры
- array
$config - Параметры настройки, предоставленные этому помощнику.
Методы, используемые из Cake\View\StringTemplateTrait
formatTemplate()source public
formatTemplate( string $name , array $data )
Форматирует строку шаблона с помощью $data
Параметры
- string
$name - Имя шаблона.
- array
$data - Данные для вставки.
Возвращает
stringgetTemplates()source public
getTemplates( string|null $template = null )
Получает шаблоны для использования или определенный шаблон.
Параметры
- string|null
$templateoptional null - Строка для чтения определенного шаблона, null для всех.
Возвращает
string|arraysetTemplates()source public
setTemplates( array $templates )
Устанавливает используемые шаблоны.
Параметры
- array
$templates - Добавляемые шаблоны.
Возвращает
$this
templater()source public
templater( )
Возвращает экземпляр templater.
Возвращает
Cake\View\StringTemplatetemplates()source public deprecated
templates( string|null|array $templates = null )
Получение/установка используемых шаблонов.
Устарело
3.4.0 Используйте setTemplates()/getTemplates() вместо этого.Параметры
- string|null|array
$templatesoptional null null или строка для чтения шаблонов. Массив позволяет добавлять шаблоны.
Возвращает
$this|string|array
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- string
$key - Ключ для удаления.
Исключение
Cake\Core\Exception\Exceptionесли происходит попытка переопределения существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Считывает ключ конфигурации.
Параметры
- string|null
$key - Ключ для чтения.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge = false )
Записывает ключ конфигурации.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeoptional false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключение
Cake\Core\Exception\Exceptionесли происходит попытка переопределения существующей конфигурации
config()source public deprecated
config( string|array|null $key = null , mixed|null $value = null , boolean $merge = true )
Получает/устанавливает конфигурацию.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определенного значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устарело
3.4.0 используйте setConfig()/getConfig() вместо этого.Параметры
- string|array|null
$keyoptional null - Ключ для получения/установки или полный массив конфигураций.
- mixed|null
$valueoptional null - Значение для установки.
- boolean
$mergeoptional true - Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию true.
Возвращает
mixedЗначение считываемой конфигурации или сам объект при операциях записи.
Исключение
Cake\Core\Exception\ExceptionПри попытке установить недействительный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value = null )
Объединить предоставленные конфигурационные данные с существующими. В отличие от config(), этот метод выполняет простое объединение, а не рекурсивное для вложенных ключей.
Установка конкретного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанное|null
$valueдополнительно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key = null , mixed $default = null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение конкретного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- строка|null
$keyдополнительно null - Ключ для получения или null для всей конфигурации.
- смешанное
$defaultдополнительно null - Возвращаемое значение, если ключ не существует.
Возвращает
смешанноеКонфигурационные данные по указанному ключу или null, если ключ не существует.
setConfig()source public
setConfig( string|array $key , mixed|null $value = null , boolean $merge = true )
Устанавливает конфигурацию.
Использование
Установка конкретного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанное|null
$valueдополнительно null - Значение для установки.
- логическое
$mergeдополнительно true - Выполнять рекурсивное объединение или перезаписывать существующую конфигурацию, по умолчанию — true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить несуществующий ключ.
Подробное описание свойств
$_defaultConfigsource
protected массив
Конфигурация по умолчанию для этого класса
Параметры: содержат значения по умолчанию для ссылок на страницы пагинации
Допустимые значения:
-
urlURL действия. См. Router::url() -
url['sort']Ключ, по которому сортируется набор записей. -
url['direction']Направление сортировки (по умолчанию: 'asc'). -
url['page']Номер страницы, используемый в ссылках. -
modelНазвание модели. -
escapeОпределяет, нужно ли экранировать поле заголовка ссылки (по умолчанию: true).
Шаблоны: шаблоны, используемые этим классом
[
'options' => [],
'templates' => [
'nextActive' => '<li class="next"><a rel="next" href="{{url}}">{{text}}</a></li>',
'nextDisabled' => '<li class="next disabled"><a href="" onclick="return false;">{{text}}</a></li>',
'prevActive' => '<li class="prev"><a rel="prev" href="{{url}}">{{text}}</a></li>',
'prevDisabled' => '<li class="prev disabled"><a href="" onclick="return false;">{{text}}</a></li>',
'counterRange' => '{{start}} - {{end}} of {{count}}',
'counterPages' => '{{page}} of {{pages}}',
'first' => '<li class="first"><a href="{{url}}">{{text}}</a></li>',
'last' => '<li class="last"><a href="{{url}}">{{text}}</a></li>',
'number' => '<li><a href="{{url}}">{{text}}</a></li>',
'current' => '<li class="active"><a href="">{{text}}</a></li>',
'ellipsis' => '<li class="ellipsis">…</li>',
'sort' => '<a href="{{url}}">{{text}}</a>',
'sortAsc' => '<a class="asc" href="{{url}}">{{text}}</a>',
'sortDesc' => '<a class="desc" href="{{url}}">{{text}}</a>',
'sortAscLocked' => '<a class="asc locked" href="{{url}}">{{text}}</a>',
'sortDescLocked' => '<a class="desc locked" href="{{url}}">{{text}}</a>',
]
] $helperssource
public массив
Список помощников, используемых этим помощником
['Url', 'Number', 'Html', 'Form']
Подробное описание магических свойств
$Formsource
public Cake\View\Helper\FormHelper
$Htmlsource
public Cake\View\Helper\HtmlHelper
$Numbersource
$Urlsource
public Cake\View\Helper\UrlHelper
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.View.Helper.PaginatorHelper.html