Класс PaginatorHelper
Класс-помощник для упрощённого создания ссылок для пагинации.
PaginatorHelper содержит все необходимые методы для работы с пагинацией.
- Cake\View\Helper реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\PaginatorHelper использует 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 )
Является ли $page частью диапазона страниц для модели $model?
Параметры
- строка
$model - Имя модели для получения параметров.
- целое число
$page - Номер страницы, которую проверяем.
Возвращает
логическое значениеTrue, если модель имеет страницу $page, иначе False.
_lastNumber()source protected
_lastNumber( string $ellipsis , array $params , integer $end , array $options )
Генерирует последний номер для метода paginator numbers().
Параметры
- строка
$ellipsis - Символ эллипса.
- массив
$params - Параметры из метода numbers().
- целое число
$end - Конечный номер страницы.
- массив
$options - Опции из метода numbers().
Возвращает
строкаВыводимая разметка.
_modulusNumbers()source protected
_modulusNumbers( Cake\View\StringTemplate $templater , array $params , array $options )
Генерирует номера страниц для метода paginator numbers().
Параметры
-
Cake\View\StringTemplate$templater - Экземпляр StringTemplate.
- массив
$params - Параметры из метода numbers().
- массив
$options - Опции из метода numbers().
Возвращает
строкаВыводимая разметка.
_numbers()source protected
_numbers( Cake\View\StringTemplate $templater , array $params , array $options )
Генерирует номера страниц для метода paginator 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необязательно [] Опции для строки счётчика. Список ключей см. в разделе #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Нужно ли экранировать текст. -
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 - Необязательное имя модели. Используется по умолчанию, если не указано.
Возвращает
логическое значениеTrue, если результат не на последней странице.
Ссылка
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.
Возвращает
логическое значениеTrue, если заданный результат содержит указанную страницу.
Ссылка
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 - Необязательное имя модели. Используется по умолчанию, если не указано.
Возвращает
логическое значениеTrue, если результат не на первой странице.
Ссылка
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Необходимо ли экранировать текст. -
urlМассив дополнительных параметров URL для генерации ссылки.
Параметры
- строка|целое число
$lastнеобязательно 'последняя >>' - Если строка, используется в качестве метки для ссылки. Если число, выводятся номера страниц.
- массив
$optionsнеобязательно [] - Массив параметров
Возвращает
строка|falseСтрока с номерами страниц.
Ссылка
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]);
Добавляет результат функции meta в указанный блок. Если передано true, используется блок "meta".
Параметры:
-
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 страниц и вы используете опции first/last и модуль 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 будет использован для заголовка и будет сгенерирован с помощью инфлексации.
- массив
$optionsнеобязательно [] - Опции для ссылки сортировки. См. выше для списка ключей.
Возвращает
строкаСсылка сортировки по умолчанию по 'asc'. Если набор результатов отсортирован по 'asc' по указанному ключу, возвращаемая ссылка будет отсортирована по 'desc'.
Ссылка
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 [] - Массив опций
Возвращает
stringJS-код onclick
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']);
Параметры
- string|array
$key - Ключ для установки или массив конфигурации.
- mixed|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'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Возвращаемое значение, когда ключ не существует.
Возвращает
mixedЗначение конфигурации.
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']);
Параметры
- string|array
$key - Ключ для установки или массив конфигурации.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Производить рекурсивное объединение или перезаписывание существующей конфигурации, по умолчанию — true.
Возвращает
$this
Вызывает исключение
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_defaultConfigsource
protected array
Конфигурация по умолчанию для данного класса
Опции: Содержит значения по умолчанию для ссылок постраничной навигации
Доступные значения:
-
urlАдрес действия. См. 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 array
Список помощников, используемых этим помощником
['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.7/class-Cake.View.Helper.PaginatorHelper.html