Класс ViewBuilder
Предоставляет API для поэтапного построения представления.
После настройки представления и определения всех контекстов вы можете создать экземпляр представления с помощью build().
- Cake\View\ViewBuilder реализует JsonSerializable, Serializable
Краткое описание свойств
-
$_autoLayoutprotectedВключить или отключить автомакет.boolean|null -
$_classNameprotectedstring|nullИмя класса представления для использования. Можно использовать обозначение плагина, короткое имя или полностью квалифицированное имя класса.
-
$_helpersprotectedИспользуемые помощникиarray -
$_layoutprotectedИмя макета для рендеринга.string|null|false -
$_layoutPathprotectedПуть к макету для построения представления.string|null -
$_nameprotectedПеременные представления для использованияstring|null -
$_optionsprotectedДополнительные параметры, используемые при создании представления.array -
$_pluginprotectedИмя плагина для использования.string|null|false -
$_templateprotectedФайл шаблона для рендеринга.string|null -
$_templatePathprotectedПодкаталог к шаблону.string|null -
$_themeprotectedИмя темы для использования.string|null|false -
$_varsprotectedПеременные представленияarray
Краткое описание методов
-
Включает или выключает стандартный режим CakePHP для применения файлов шаблонов. По умолчанию включено. Выключение означает, что шаблоны не будут автоматически применяться к рендеруемых представлениям.
- build() publicИспользуя данные в билдере, создаёт экземпляр представления.
- Получение/установка имени класса представления.
- createFromArray() publicНастраивает экземпляр билдера представления из сериализованной конфигурации.
- disableAutoLayout() publicВыключает стандартный режим CakePHP для применения файлов шаблонов.
- 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Получение темы представления для использования.
- getVar() publicПолучить переменную представления.
- getVars() publicПолучить все переменные представления.
- hasVar() publicПроверка наличия переменной представления.
- Используемые помощники.
- isAutoLayoutEnabled() public
Возвращает, включён ли стандартный режим CakePHP для применения файлов шаблонов. Выключено, если шаблоны не применяются автоматически к рендеруемым представлениям.
- jsonSerialize() publicСериализация объекта билдера представления в значение, которое можно напрямую сериализовать и повторно использовать для клонирования экземпляра билдера.
-
Получение/установка имени файла шаблона, внутри которого должно отображаться представление. Указанное имя — имя файла шаблона в /src/Template/Layout без расширения .ctp.
- Получение/установка пути к файлам шаблонов.
- Получение/установка имени представления.
- Установка дополнительных параметров для представления.
- Имя плагина для использования.
- 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Установка темы представления для использования.
- setVar() publicСохранение переменной для использования внутри шаблона.
- setVars() publicСохранение переменных представления для использования внутри шаблонов.
-
Получение/установка имени файла представления для рендеринга. Указанное имя — имя файла в /src/Template/<подпапка> без расширения .ctp.
- Получение/установка пути к файлам шаблонов.
- Тема представления для использования.
- unserialize() publicДесериализация объекта билдера представления.
Подробное описание методов
autoLayout()source public deprecated
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.
Параметры
- array
$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 deprecated
className( string|null $name = null )
Получить/установить имя класса представления.
Принимает короткое имя (Ajax), имя плагина (MyPlugin.Ajax) или полностью квалифицированное имя (App\View\AppView).
Устаревшее
3.4.0 Используйте setClassName()/getClassName() вместо этого.Параметры
- string|null
$nameнеобязательно null Имя класса представления. Может ссылаться на имя класса плагина, короткий псевдоним или полностью квалифицированное имя.
Возвращает
string|Cake\View\ViewBuilder$this
createFromArray()source public
createFromArray( array $config )
Настраивает экземпляр билдера представлений из сериализованной конфигурации.
Параметры
- array
$config - Массив конфигурации билдера представлений.
Возвращает
$this Настроенный экземпляр билдера представлений.
disableAutoLayout()source public
disableAutoLayout( )
Отключает стандартный режим CakePHP по применению файлов макета.
Установка в выключенное состояние означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Возвращает
$this
enableAutoLayout()source public
enableAutoLayout( boolean $enable = true )
Включает или отключает стандартный режим CakePHP по применению файлов макета. Включено по умолчанию. Установка в выключенное состояние означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Параметры
- boolean
$enableнеобязательно true - Логическое значение для включения/выключения.
Возвращает
$this
getClassName()source public
getClassName( )
Получает имя класса представления.
Возвращает
string|nullgetLayout()source public
getLayout( )
Получает имя файла макета для отображения представления внутри него.
Возвращает
string|null|falsegetOptions()source public
getOptions( )
Получает дополнительные параметры для представления.
Возвращает
arraygetPlugin()source public
getPlugin( )
Получает имя плагина для использования.
Возвращает
string|null|falsegetTemplate()source public
getTemplate( )
Получает имя файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/
Возвращает
string|nullgetTemplatePath()source public
getTemplatePath( )
Получает путь к файлам шаблонов.
Возвращает
string|nullgetTheme()source public
getTheme( )
Получает используемую тему представления.
Возвращает
string|null|falsegetVar()source public
getVar( string $name )
Получить переменную представления
Параметры
- string
$name - Имя переменной
Возвращает
mixedЗначение переменной или null, если она не установлена.
hasVar()source public
hasVar( string $name )
Проверить, установлена ли переменная представления.
Параметры
- string
$name - Имя переменной
Возвращает
booleanhelpers()source public deprecated
helpers( array $helpers = null , boolean $merge = true )
Используемые помощники
Устаревшее
3.4.0 Используйте setHelpers()/getHelpers() вместо этого.Параметры
- array
$helpersнеобязательно null - Используемые помощники.
- boolean
$mergeнеобязательно true - Объединять ли существующие данные с новыми.
Возвращает
array|Cake\View\ViewBuilder$this
isAutoLayoutEnabled()source public
isAutoLayoutEnabled( )
Возвращает, включен ли стандартный режим CakePHP по применению файлов макета. Выключенное состояние означает, что макеты не будут автоматически применяться к рендеренным представлениям.
Возвращает
boolean|nulljsonSerialize()source public
jsonSerialize( )
Сериализует объект билдера представлений в значение, которое можно нативно сериализовать и повторно использовать для клонирования этого билдера.
Возвращает
arrayСериализуемый массив свойств конфигурации.
Реализация
JsonSerializable::jsonSerialize() layout()source public deprecated
layout( string|null $name = null )
Получить/установить имя файла макета для отображения представления внутри него. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.
Устаревшее
3.4.0 Используйте setLayout()/getLayout() вместо этого.Параметры
- string|null
$nameнеобязательно null - Имя файла макета для установки. Если null, возвращает текущее имя.
Возвращает
string|Cake\View\ViewBuilder$this
layoutPath()source public deprecated
layoutPath( string|null $path = null )
Получить/установить путь к файлам макета.
Устаревшее
3.4.0 Используйте setLayoutPath()/getLayoutPath() вместо этого.Параметры
- string|null
$pathнеобязательно null - Путь к файлам макета. Если null, возвращает текущий путь.
Возвращает
string|Cake\View\ViewBuilder$this
name()source public deprecated
name( string|null $name = null )
Получение/установка имени представления
Устарело
3.4.0 Используйте setName()/getName() вместо этого.Параметры
- string|null
$nameнеобязательно null - Имя представления
Возвращает
string|Cake\View\ViewBuilder$this
options()source public deprecated
options( array $options = null , boolean $merge = true )
Устанавливает дополнительные параметры для представления.
Это позволяет предоставлять пользовательские аргументы конструктора класса представления приложения/плагина.
Устарело
3.4.0 Используйте setOptions()/getOptions() вместо этого.Параметры
- array
$optionsнеобязательно null - Массив параметров или null для получения текущих параметров.
- boolean
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
array|Cake\View\ViewBuilder$this
plugin()source public deprecated
plugin( string|null|false $name = null )
Имя плагина для использования
Устарело
3.4.0 Используйте setPlugin()/getPlugin() вместо этого.Параметры
- string|null|false
$nameнеобязательно null Имя плагина. Если null, возвращает текущий плагин. Используйте false для удаления текущего имени плагина.
Возвращает
string|false|null|Cake\View\ViewBuilder$this
serialize()source public
serialize( )
Сериализует объект view builder.
Возвращает
stringРеализация
Serializable::serialize() setClassName()source public
setClassName( string|null $name )
Устанавливает имя класса представления.
Принимает короткое имя (Ajax), имя плагина (MyPlugin.Ajax) или полностью квалифицированное имя (App\View\AppView), или null для использования класса View, предоставляемого CakePHP.
Параметры
- string|null
$name - Имя класса для представления.
Возвращает
$this
setHelpers()source public
setHelpers( array $helpers , boolean $merge = true )
Устанавливает используемые помощники.
Параметры
- array
$helpers - Используемые помощники.
- boolean
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
$this
setLayout()source public
setLayout( string|null|false $name )
Устанавливает имя файла макета, в котором будет отображаться представление. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.
Параметры
- string|null|false
$name - Имя файла макета для установки.
Возвращает
$this
setLayoutPath()source public
setLayoutPath( string|null $path )
Устанавливает путь к файлам макетов.
Параметры
- string|null
$path - Путь к файлам макетов.
Возвращает
$this
setName()source public
setName( string|null $name )
Устанавливает имя представления.
Параметры
- string|null
$name - Имя представления.
Возвращает
$this
setOptions()source public
setOptions( array $options , boolean $merge = true )
Устанавливает дополнительные параметры для представления.
Это позволяет предоставлять пользовательские аргументы конструктора класса представления приложения/плагина.
Параметры
- array
$options - Массив параметров.
- boolean
$mergeнеобязательно true - Объединять ли существующие данные с новыми данными.
Возвращает
$this
setPlugin()source public
setPlugin( string|null|false $name )
Устанавливает имя используемого плагина.
False удаление текущего имени плагина устарело начиная с версии 3.4.0. Используйте напрямую null вместо этого.
Параметры
- string|null|false
$name Имя плагина. Используйте null или false для удаления текущего имени плагина.
Возвращает
$this
setTemplate()source public
setTemplate( string|null $name )
Устанавливает имя файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/<подпапка> без расширения .ctp.
Параметры
- string|null
$name - Имя файла представления для установки.
Возвращает
$this
setTemplatePath()source public
setTemplatePath( string|null $path )
Устанавливает путь к файлам шаблонов.
Параметры
- string|null
$path - Путь к файлам представлений.
Возвращает
$this
setTheme()source public
setTheme( string|null|false $theme )
Устанавливает используемую тему представления.
False удаление текущей темы устарело начиная с версии 3.4.0. Используйте напрямую null вместо этого.
Параметры
- string|null|false
$theme Имя темы. Используйте null или false для удаления текущей темы.
Возвращает
$this
setVar()source public
setVar( string $name , mixed $value = null )
Сохраняет переменную для использования в шаблоне.
Параметры
- string
$name - Строка или массив данных.
- mixed
$valueнеобязательно null - Значение.
Возвращает
$this
setVars()source public
setVars( array $data , boolean $merge = true )
Сохраняет переменные представления для использования в шаблонах.
Параметры
- array
$data - Массив данных.
- boolean
$mergeнеобязательно true - Объединить с существующими переменными, по умолчанию true.
Возвращает
$this
template()source public deprecated
template( string|null $name = null )
Получение/установка имени файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/<подпапка> без расширения .ctp.
Устарело
3.4.0 Используйте setTemplate()/getTemplate()Параметры
- string|null
$nameнеобязательно null - Имя файла представления для установки. Если null, возвращает текущее имя.
Возвращает
string|Cake\View\ViewBuilder$this
templatePath()source public deprecated
templatePath( string|null $path = null )
Получение/установка пути к файлам шаблонов.
Устарело
3.4.0 Используйте setTemplatePath()/getTemplatePath() вместо этого.Параметры
- string|null
$pathнеобязательно null - Путь к файлам представлений. Если null, возвращает текущий путь.
Возвращает
string|Cake\View\ViewBuilder$this
theme()source public deprecated
theme( string|null|false $theme = null )
Тема представления для использования.
Устаревшее
3.4.0 Используйте setTheme()/getTheme() вместо этого.Параметры
- string|null|false
$themeoptional null Имя темы. Если null, возвращает текущую тему. Используйте false, чтобы удалить текущую тему.
Возвращает
string|false|null|Cake\View\ViewBuilder$this
unserialize()source public
unserialize( string $data )
Десериализует объект билдера представления.
Параметры
- string
$data - Строка, закодированная в сериализованном виде.
Возвращает
$this Конфигурированный экземпляр билдера представления.
Реализация
Serializable::unserialize() Подробности свойств
$_autoLayoutsource
protected boolean|null
Включить или отключить автоматическое использование макета.
$_classNamesource
protected string|null
Имя класса представления для использования. Может использовать обозначение плагина, короткое имя или полное имя класса с пространством имён.
$_optionssource
protected array
Дополнительные параметры, используемые при построении представления.
Этот массив параметров позволяет вам передавать пользовательские аргументы конструктора для классов представления приложения/плагинов.
[]
© 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.ViewBuilder.html