Класс ViewBuilder
Предоставляет API для итеративного построения представления.
После настройки представления и определения всего контекста вы можете создать экземпляр представления с помощью build().
- Cake\View\ViewBuilder реализует JsonSerializable, Serializable
Краткое описание свойств
-
$_autoLayoutprotectedВключён ли режим autoLayout.boolean -
$_classNameprotectedstringИмя класса представления для использования. Может использовать запись плагина, короткое имя или полное имя класса с пространством имён.
-
$_helpersprotectedИспользуемые помощники (helpers).array -
$_layoutprotectedИмя макета для отрисовки.string -
$_layoutPathprotectedПуть к макету для построения представления.string -
$_nameprotectedПеременные представления для использования.string -
$_optionsprotectedДополнительные параметры, используемые при создании представления.array -
$_pluginprotectedИмя плагина для использования.string -
$_templateprotectedИмя файла шаблона для отрисовки.string -
$_templatePathprotectedПодкаталог к шаблону.string -
$_themeprotectedИмя темы для использования.string
Краткое описание методов
- autoLayout() public
Включает или отключает стандартный режим CakePHP применения файлов макета. Включено по умолчанию. Отключение означает, что макеты не будут автоматически применяться к отрисовываемым представлениям.
- build() publicСоздание экземпляра представления на основе данных в билдере.
- className() publicПолучение/установка имени класса представления.
- createFromArray() publicНастройка экземпляра билдера представления из сериализованной конфигурации.
- helpers() publicИспользуемые помощники (helpers).
- jsonSerialize() public
Сериализация объекта билдера представления в значение, которое можно напрямую сериализовать и повторно использовать для клонирования этого билдера.
- layout() public
Получение/установка имени файла макета для отрисовки представления внутри него. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.
- layoutPath() publicПолучение/установка пути к файлам макета.
- name() publicПолучение/установка имени представления.
- options() publicУстановка дополнительных параметров для представления.
- plugin() publicИмя плагина для использования.
- serialize() publicСериализация объекта билдера представления.
- template() public
Получение/установка имени файла представления для отрисовки. Указанное имя — имя файла в /src/Template/
без расширения .ctp. - templatePath() publicПолучение/установка пути к файлам шаблонов.
- theme() publicИспользуемая тема представления.
- unserialize() publicДесериализация объекта билдера представления.
Подробное описание методов
autoLayout()source public
autoLayout( boolean|null $autoLayout null )
Включает или отключает стандартный режим CakePHP применения файлов макета. Включено по умолчанию. Отключение означает, что макеты не будут автоматически применяться к отрисовываемым представлениям.
Параметры
- boolean|null
$autoLayoutнеобязательно null - Булево значение для включения/выключения. Если null, возвращает текущее значение.
Возвращаемое значение
boolean|Cake\View\ViewBuilder$this
build()source public
build( array $vars [] , Cake\Network\Request $request null , Cake\Network\Response $response null , Cake\Event\EventManager $events null )
Создание экземпляра представления на основе данных в билдере.
Если className() равно null, будет использоваться App\View\AppView. Если этот класс не существует, используется Cake\View\View.
Параметры
- array
$varsнеобязательно [] - Переменные/контекст представления для использования.
-
Cake\Network\Request$requestнеобязательно null - Используемый запрос.
-
Cake\Network\Response$responseнеобязательно null - Используемый ответ.
-
Cake\Event\EventManager$eventsнеобязательно null - Используемый менеджер событий.
Возвращаемое значение
Cake\View\ViewВызываемые исключения
Cake\View\Exception\MissingViewExceptionclassName()source public
className( string|null $name null )
Получение/установка имени класса представления.
Принимает короткое имя (Ajax), имя плагина (MyPlugin.Ajax) или полное имя с пространством имён (App\View\AppView).
Параметры
- string|null
$nameнеобязательно null Имя класса представления. Может быть ссылкой на имя класса плагина, коротким псевдонимом или полным именем с пространством имён.
Возвращаемое значение
array|Cake\View\ViewBuilder$this
createFromArray()source public
createFromArray( array $config )
Настройка экземпляра билдера представления из сериализованной конфигурации.
Параметры
- array
$config - Массив конфигурации билдера представления.
Возвращаемое значение
$this Настроенный экземпляр билдера представления.
helpers()source public
helpers( array $helpers null , boolean $merge true )
Используемые помощники (helpers)
Параметры
- array
$helpersнеобязательно null - Используемые помощники.
- boolean
$mergeнеобязательно true - Объединить ли существующие данные с новыми.
Возвращаемое значение
array|Cake\View\ViewBuilder$this
jsonSerialize()source public
jsonSerialize( )
Сериализация объекта билдера представления в значение, которое можно напрямую сериализовать и повторно использовать для клонирования этого билдера.
Возвращаемое значение
arrayСериализуемый массив свойств конфигурации.
Реализация
JsonSerializable::jsonSerialize() layout()source public
layout( string|null $name null )
Получить/установить имя файла макета для рендеринга представления. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.
Параметры
- string|null
$nameнеобязательно null - Имя файла макета для установки. Если null, возвращает текущее имя.
Возвращает
string|Cake\View\ViewBuilder$this
layoutPath()source public
layoutPath( string|null $path null )
Получить/установить путь к файлам макета.
Параметры
- string|null
$pathнеобязательно null - Путь к файлам макета. Если null, возвращает текущий путь.
Возвращает
string|Cake\View\ViewBuilder$this
name()source public
name( string|null $name null )
Получить/установить имя представления
Параметры
- string|null
$nameнеобязательно null - Имя представления
Возвращает
array|Cake\View\ViewBuilder$this
options()source public
options( array $options null , boolean $merge true )
Установить дополнительные параметры для представления.
Это позволяет передавать пользовательские аргументы конструктора класса представления в приложениях/плагинах.
Параметры
- array
$optionsнеобязательно null - Массив параметров или null для получения текущих параметров.
- boolean
$mergeнеобязательно true - Флаг, объединять ли существующие данные с новыми данными.
Возвращает
array|Cake\View\ViewBuilder$this
plugin()source public
plugin( string|null|false $name null )
Имя плагина для использования
Параметры
- string|null|false
$nameнеобязательно null Имя плагина. Если null, возвращает текущий плагин. Используйте false для удаления текущего имени плагина.
Возвращает
string|Cake\View\ViewBuilder$this
serialize()source public
serialize( )
Сериализует объект билдера представления.
Возвращает
stringРеализация
Serializable::serialize() template()source public
template( string|null $name null )
Получить/установить имя файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/<подпапка> без расширения .ctp.
Параметры
- string|null
$nameнеобязательно null - Имя файла представления для установки. Если null, возвращает текущее имя.
Возвращает
string|Cake\View\ViewBuilder$this
templatePath()source public
templatePath( string|null $path null )
Получить/установить путь к файлам шаблонов.
Параметры
- string|null
$pathнеобязательно null - Путь к файлам представлений. Если null, возвращает текущий путь.
Возвращает
string|Cake\View\ViewBuilder$this
theme()source public
theme( string|null|false $theme null )
Тема представления для использования.
Параметры
- string|null|false
$themeнеобязательно null Имя темы. Если null, возвращает текущую тему. Используйте false для удаления текущей темы.
Возвращает
string|Cake\View\ViewBuilder$this
unserialize()source public
unserialize( string $data )
Десериализует объект билдера представления.
Параметры
- string
$data - Сериализованная строка.
Возвращает
$this Конфигурированный экземпляр билдера представления.
Реализация
Serializable::unserialize() Подробное описание свойств
$_classNamesource
protected string
Имя используемого класса представления. Может использовать обозначение плагина, короткое имя или полностью квалифицированное имя класса.
$_optionssource
protected array
Дополнительные параметры, используемые при построении представления.
Этот массив параметров позволяет передавать пользовательские аргументы конструктора классов представления в приложениях/плагинах.
[]
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.View.ViewBuilder.html