Класс ViewBuilder
Предоставляет API для итеративного построения представления.
После настройки представления и определения всех контекстов можно создать экземпляр представления с помощью build().
- Cake\View\ViewBuilder реализует JsonSerializable, Serializable
Краткое описание свойств
-
$_autoLayoutprotectedВключить или отключить автоматическое применение макета.boolean -
$_classNameprotectedstringИмя класса представления для использования. Можно использовать обозначение плагина, короткое имя или имя класса с полным пространством имён.
-
$_helpersprotectedИспользуемые помощники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Настраивает экземпляр билдера представления из сериализованной конфигурации.
- enableAutoLayout() public
Включает или отключает традиционный режим CakePHP по применению файлов макета. По умолчанию включено. Отключение означает, что макеты не будут автоматически применяться к рендеренным представлениям.
- getClassName() publicПолучить имя класса представления.
- getHelpers() publicПолучить используемые помощники.
- getLayout() publicПолучить имя файла макета для рендеринга представления внутри него.
- getLayoutPath() publicПолучить путь к файлам макета.
- getName() publicПолучить имя представления.
- getOptions() publicПолучить дополнительные параметры для представления.
- getPlugin() publicПолучить имя плагина для использования.
- getTemplate() public
Получить имя файла представления для рендеринга. Указанное имя — имя файла в /src/Template/
без расширения .ctp. - getTemplatePath() publicПолучить путь к файлам шаблонов.
- getTheme() publicПолучить тему представления для использования.
- helpers() publicИспользуемые помощники
- isAutoLayoutEnabled() public
Возвращает, включён ли в CakePHP традиционный режим применения файлов макета. Выключено означает, что макеты не будут автоматически применяться к рендеренным представлениям.
- jsonSerialize() public
Сериализует объект билдера представления в значение, которое можно напрямую сериализовать и повторно использовать для клонирования этого билдера.
- layout() public
Получить/установить имя файла макета для рендеринга представления внутри него. Указанное имя — имя файла макета в /src/Template/Layout без расширения .ctp.
- layoutPath() publicПолучить/установить путь к файлам макета.
- name() publicПолучить/установить имя представления
- options() publicУстановить дополнительные параметры для представления.
- plugin() publicИмя плагина для использования
- serialize() publicСериализует объект билдера представления.
- setClassName() publicУстановить имя класса представления.
- setHelpers() publicУстановить используемые помощники.
- setLayout() public
Устанавливает имя файла макета для рендеринга представления внутри него. Указанное имя — имя файла макета в /src/Template/Layout без расширения .ctp.
- setLayoutPath() publicУстановить путь к файлам макета.
- setName() publicУстановить имя представления.
- setOptions() publicУстановить дополнительные параметры для представления.
- setPlugin() publicУстановить имя плагина для использования.
- setTemplate() public
Устанавливает имя файла представления для рендеринга. Указанное имя — имя файла в /src/Template/
без расширения .ctp. - setTemplatePath() publicУстановить путь к файлам шаблонов.
- setTheme() publicУстановить тему представления для использования.
- template() public
Получить/установить имя файла представления для рендеринга. Указанное имя — имя файла в /src/Template/
без расширения .ctp. - templatePath() publicПолучить/установить путь к файлам шаблонов.
- theme() publicТема представления для использования.
- unserialize() publicДесериализует объект билдера представления.
Подробное описание методов
autoLayout()source public
autoLayout( boolean|null $enable null )
Включает или отключает традиционный режим CakePHP по применению файлов макета. По умолчанию включено. Отключение означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Устарело
3.4.0 Используйте enableAutoLayout()/isAutoLayoutEnabled() вместо этого.Параметры
- boolean|null
$enableнеобязательно null - Логическое значение для включения/отключения. Если null, возвращает текущее значение.
Возвращает
boolean|Cake\View\ViewBuilder$this
build()source public
build( array $vars [] , Cake\Http\ServerRequest $request null , Cake\Http\Response $response null , Cake\Event\EventManager $events null )
Используя данные в билдере, создайте экземпляр представления.
Если className() равно null, будет использоваться App\View\AppView. Если этот класс не существует, будет использоваться Cake\View\View.
Параметры
- массив
$varsнеобязательно [] - Переменные/контекст представления, которые нужно использовать.
-
Cake\Http\ServerRequest$requestнеобязательно null - Запрос для использования.
-
Cake\Http\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).
Устаревшее
3.4.0 Используйте setClassName()/getClassName() вместо этого.Параметры
- строка|null
$nameнеобязательно null Имя класса представления. Может быть ссылкой на имя класса плагина, коротким псевдонимом или полным именем с пространством имён.
Возвращает
строка|Cake\View\ViewBuilder$this
createFromArray()source public
createFromArray( array $config )
Настройка экземпляра билдера представления из сериализованной конфигурации.
Параметры
- массив
$config - Массив конфигурации билдера представления.
Возвращает
$this Экземпляр настроенного билдера представления.
enableAutoLayout()source public
enableAutoLayout( boolean $enable true )
Включает или выключает стандартный режим CakePHP для применения файлов макета. Включено по умолчанию. Отключение означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Параметры
- логическое значение
$enableнеобязательно true - Логическое значение для включения/отключения.
Возвращает
$this
getLayout()source public
getLayout( )
Получает имя файла макета, в котором должно отображаться представление.
Возвращает
строкаgetOptions()source public
getOptions( )
Получает дополнительные параметры для представления.
Возвращает
массивgetTemplate()source public
getTemplate( )
Получает имя файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/
Возвращает
строкаgetTemplatePath()source public
getTemplatePath( )
Получает путь к файлам шаблонов.
Возвращает
строкаgetTheme()source public
getTheme( )
Получает тему представления для использования.
Возвращает
строкаhelpers()source public
helpers( array $helpers null , boolean $merge true )
Используемые помощники.
Устаревшее
3.4.0 Используйте setHelpers()/getHelpers() вместо этого.Параметры
- массив
$helpersнеобязательно null - Используемые помощники.
- логическое значение
$mergeнеобязательно true - Слияние существующих данных с новыми данными.
Возвращает
массив|Cake\View\ViewBuilder$this
isAutoLayoutEnabled()source public
isAutoLayoutEnabled( )
Возвращает значение, если стандартный режим CakePHP для применения файлов макета включен. Выключено означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Возвращает
логическое значениеjsonSerialize()source public
jsonSerialize( )
Сериализует объект билдера представления в значение, которое можно напрямую сериализовать и повторно использовать для клонирования этого экземпляра билдера.
Возвращает
массивСериализуемый массив свойств конфигурации.
Реализация
JsonSerializable::jsonSerialize() layout()source public
layout( string|null $name null )
Получение/установка имени файла макета, в котором должно отображаться представление. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.
Устаревшее
3.4.0 Используйте setLayout()/getLayout() вместо этого.Параметры
- строка|null
$nameнеобязательно null - Имя файла макета для установки. Если null, возвращает текущее имя.
Возвращает
строка|Cake\View\ViewBuilder$this
layoutPath()source public
layoutPath( string|null $path null )
Получение/установка пути к файлам макета.
Устаревшее
3.4.0 Используйте setLayoutPath()/getLayoutPath() вместо этого.Параметры
- строка|null
$pathнеобязательно null - Путь к файлам макета. Если null, возвращает текущий путь.
Возвращает
строка|Cake\View\ViewBuilder$this
name()source public
name( string|null $name null )
Получение/установка имени представления
Устаревшее
3.4.0 Используйте setName()/getName() вместо этого.Параметры
- строка|null
$nameнеобязательно null - Имя представления
Возвращает
строка|Cake\View\ViewBuilder$this
options()source public
options( array $options null , boolean $merge true )
Установить дополнительные параметры для представления.
Это позволяет предоставлять пользовательские аргументы конструктора для классов представления приложения/плагина.
Устаревшее
3.4.0 Используйте setOptions()/getOptions() вместо этого.Параметры
- массив
$optionsнеобязательно null - Массив параметров или null для получения текущих параметров.
- логический
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
массив|Cake\View\ViewBuilder$this
plugin()source public
plugin( string|null|false $name null )
Имя плагина для использования
Устаревшее
3.4.0 Используйте setPlugin()/getPlugin() вместо этого.Параметры
- строка|null|false
$nameнеобязательно null Имя плагина. Если null, возвращает текущий плагин. Используйте false для удаления текущего имени плагина.
Возвращает
строка|Cake\View\ViewBuilder$this
serialize()source public
serialize( )
Сериализует объект билдера представления.
Возвращает
строкаРеализация
Serializable::serialize() setClassName()source public
setClassName( string $name )
Устанавливает имя класса представления.
Принимает короткое имя (Ajax), имя плагина (MyPlugin.Ajax) или имя с полным пространством имён (App\View\AppView).
Параметры
- строка
$name - Имя класса для представления.
Возвращает
$this
setHelpers()source public
setHelpers( array $helpers , boolean $merge true )
Устанавливает используемые помощники.
Параметры
- массив
$helpers - Используемые помощники.
- логический
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
$this
setLayout()source public
setLayout( string $name )
Устанавливает имя файла макета для рендеринга представления. Указанное имя — имя файла макета в /src/Template/Layout без расширения .ctp.
Параметры
- строка
$name - Имя файла макета для установки.
Возвращает
$this
setLayoutPath()source public
setLayoutPath( string $path )
Устанавливает путь для файлов макета.
Параметры
- строка
$path - Путь для файлов макета.
Возвращает
$this
setName()source public
setName( string $name )
Устанавливает имя представления.
Параметры
- строка
$name - Имя представления.
Возвращает
$this
setOptions()source public
setOptions( array $options , boolean $merge true )
Устанавливает дополнительные параметры для представления.
Это позволяет предоставлять пользовательские аргументы конструктора для классов представления приложения/плагина.
Параметры
- массив
$options - Массив параметров.
- логический
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
$this
setPlugin()source public
setPlugin( string|null|false $name )
Устанавливает имя плагина для использования.
False удаление текущего имени плагина устарело с версии 3.4.0. Используйте напрямую null вместо этого.
Параметры
- строка|null|false
$name Имя плагина. Используйте null или false для удаления текущего имени плагина.
Возвращает
$this
setTemplate()source public
setTemplate( string $name )
Устанавливает имя файла представления для рендеринга. Указанное имя — имя файла в /src/Template/
Параметры
- строка
$name - Имя файла представления для установки.
Возвращает
$this
setTemplatePath()source public
setTemplatePath( string $path )
Устанавливает путь для файлов шаблонов.
Параметры
- строка
$path - Путь для файлов представлений.
Возвращает
$this
setTheme()source public
setTheme( string|null|false $theme )
Устанавливает тему представления для использования.
False удаление текущей темы устарело с версии 3.4.0. Используйте напрямую null вместо этого.
Параметры
- строка|null|false
$theme Имя темы. Используйте null или false для удаления текущей темы.
Возвращает
$this
template()source public
template( string|null $name null )
Получить/установить имя файла представления для рендеринга. Указанное имя — имя файла в /src/Template/
Устаревшее
3.4.0 Используйте setTemplate()/getTemplate()Параметры
- строка|null
$nameнеобязательно null - Имя файла представления для установки. Если null, возвращает текущее имя.
Возвращает
строка|Cake\View\ViewBuilder$this
templatePath()source public
templatePath( string|null $path null )
Получить/установить путь для файлов шаблонов.
Устаревшее
3.4.0 Используйте setTemplatePath()/getTemplatePath() вместо этого.Параметры
- строка|null
$pathнеобязательно null - Путь для файлов представлений. Если null, возвращает текущий путь.
Возвращает
строка|Cake\View\ViewBuilder$this
theme()source public
theme( string|null|false $theme null )
Текущая тема представления.
Устаревшее
3.4.0 Используйте setTheme()/getTheme() вместо этого.Параметры
- строка|null|false
$themeнеобязательно null Имя темы. Если null, возвращает текущую тему. Используйте false для удаления текущей темы.
Возвращает
строка|Cake\View\ViewBuilder$this
unserialize()source public
unserialize( string $data )
Десериализует объект билдера представления.
Параметры
- строка
$data - Сериализованная строка.
Возвращает
$this Конфигурированный экземпляр билдера представления.
Реализация
Serializable::unserialize() Подробное описание свойств
END_OF_DOCUMENT_MARKER$_classNamesource
protected строка
Имя класса представления для использования. Можно использовать обозначение плагина, короткое имя или полное имя класса с пространством имён.
$_optionssource
protected массив
Дополнительные параметры, используемые при построении представления.
Этот массив параметров позволяет предоставлять пользовательские аргументы конструктора для классов представления приложения/плагина.
[]
© 2005–2017 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.4/class-Cake.View.ViewBuilder.html