Spec-Zone.ru › CakePHP 3.7

Класс ViewBuilder

Предоставляет API для итеративного построения представления.

После настройки представления и определения всего контекста вы можете создать экземпляр представления с помощью build().

Cake\View\ViewBuilder реализует JsonSerializable, Serializable
Пространство имён: Cake\View
Расположение: View/ViewBuilder.php

Краткое описание свойств

  • $_autoLayout protected
    boolean|null
    Включить или отключить автоматический макет.
  • $_className protected
    string|null

    Имя класса представления для использования. Можно использовать обозначение плагина, короткое имя или полное имя класса с пространством имён.

  • $_helpers protected
    array
    Используемые помощники (helpers)
  • $_layout protected
    string|null|false
    Имя макета для рендеринга.
  • $_layoutPath protected
    string|null
    Путь к макету для построения представления.
  • $_name protected
    string|null
    Переменные представления для использования
  • $_options protected
    array
    Дополнительные параметры, используемые при построении представления.
  • $_plugin protected
    string|null|false
    Имя плагина для использования.
  • $_template protected
    string|null
    Файл шаблона для рендеринга.
  • $_templatePath protected
    string|null
    Подкаталог шаблона.
  • $_theme protected
    string|null|false
    Имя темы для использования.
  • $_vars protected
    array
    Переменные представления.

Краткое описание методов

  • autoLayout() public deprecated

    Включает или выключает стандартный режим CakePHP для применения файлов шаблонов. По умолчанию включен. Отключение означает, что макеты не будут автоматически применяться к рендеренным представлениям.

  • build() public
    Создаёт экземпляр представления, используя данные в билдере.
  • className() public deprecated
    Получение/установка имени класса представления.
  • 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
    Проверка наличия переменной представления.
  • helpers() public deprecated
    Используемые хелперы
  • isAutoLayoutEnabled() public

    Возвращает, включён ли стандартный режим CakePHP для применения файлов шаблонов. Выключенный режим означает, что макеты не будут автоматически применяться к рендеренным представлениям.

  • jsonSerialize() public

    Сериализует объект билдера представления в значение, которое может быть напрямую сериализовано и повторно использовано для клонирования этого экземпляра билдера.

  • layout() public deprecated

    Получение/установка имени файла макета для рендера представления. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.

  • layoutPath() public deprecated
    Получение/установка пути к файлам макета.
  • name() public deprecated
    Получение/установка имени представления.
  • options() public deprecated
    Установление дополнительных опций для представления.
  • plugin() public deprecated
    Имя плагина для использования.
  • 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
    Сохранение переменных представления для использования в шаблонах.
  • template() public deprecated

    Получение/установка имени файла представления для рендера. Указанное имя — это имя файла в /src/Template/<подпапка> без расширения .ctp.

  • templatePath() public deprecated
    Получение/установка пути к файлам шаблонов.
  • theme() public deprecated
    Тема представления для использования.
  • 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\MissingViewException

className()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 )

Настраивает экземпляр View Builder по сериализованной конфигурации.

Параметры

array $config
Массив конфигурации View Builder.

Возвращает


$this Настроенный экземпляр View Builder.

disableAutoLayout()source public

disableAutoLayout( )

Отключает стандартный режим CakePHP по применению файлов макета.

Отключение означает, что макеты не будут автоматически применяться к рендеряемым представлениям.

Возвращает


$this

enableAutoLayout()source public

enableAutoLayout( boolean $enable = true )

Включает или отключает стандартный режим CakePHP по применению файлов макета. Включено по умолчанию. Отключение означает, что макеты не будут автоматически применяться к рендеряемым представлениям.

Параметры

boolean $enable необязательно true
Логическое значение для включения/выключения.

Возвращает


$this

getClassName()source public

getClassName( )

Получает имя класса представления.

Возвращает

string|null

getHelpers()source public

getHelpers( )

Получает используемые помощники.

Возвращает

array

getLayout()source public

getLayout( )

Получает имя файла макета, в котором будет рендериться представление.

Возвращает

string|null|false

getLayoutPath()source public

getLayoutPath( )

Получает путь к файлам макета.

Возвращает

string|null

getName()source public

getName( )

Получает имя представления.

Возвращает

string|null

getOptions()source public

getOptions( )

Получает дополнительные параметры для представления.

Возвращает

array

getPlugin()source public

getPlugin( )

Получает имя плагина для использования.

Возвращает

string|null|false

getTemplate()source public

getTemplate( )

Получает имя файла представления для рендеринга. Указанное имя — это имя файла в /src/Template/<подпапка> без расширения .ctp.

Возвращает

string|null

getTemplatePath()source public

getTemplatePath( )

Получает путь к файлам шаблонов.

Возвращает

string|null

getTheme()source public

getTheme( )

Получает тему представления для использования.

Возвращает

string|null|false

getVar()source public

getVar( string $name )

Получить переменную представления

Параметры

string $name
Имя переменной

Возвращает

mixed
Значение переменной или null, если она не задана.

getVars()source public

getVars( )

Получить все переменные представления.

Возвращает

array

hasVar()source public

hasVar( string $name )

Проверить, установлена ли переменная представления.

Параметры

string $name
Имя переменной

Возвращает

boolean

helpers()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|null

jsonSerialize()source public

jsonSerialize( )

Сериализует объект View Builder в значение, которое можно напрямую сериализовать и повторно использовать для клонирования этого экземпляра билдера.

Возвращает

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
END_OF_DOCUMENT_MARKER

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( )

Сериализует объект билдера представления.

Возвращает

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
END_OF_DOCUMENT_MARKER

templatePath()source public устаревший

templatePath( string|null $path = null )

Получение/установка пути к файлам шаблонов.

Устаревший

3.4.0 Используйте setTemplatePath()/getTemplatePath() вместо этого.

Параметры

string|null $path необязательный null
Путь к файлам представления. Если null, возвращает текущий путь.

Возвращает

string|Cake\View\ViewBuilder
$this

theme()source public устаревший

theme( string|null|false $theme = null )

Тема представления, которую нужно использовать.

Устаревший

3.4.0 Используйте setTheme()/getTheme() вместо этого.

Параметры

string|null|false $theme необязательный null

Имя темы. Если null, возвращает текущую тему. Используйте false для удаления текущей темы.

Возвращает

string|false|null|Cake\View\ViewBuilder
$this

unserialize()source public

unserialize( string $data )

Десериализация объекта view builder.

Параметры

string $data
Строка, полученная в результате сериализации.

Возвращает


$this Настроенный экземпляр view builder.

Реализация

Serializable::unserialize()

Подробное описание свойств

$_autoLayoutsource

protected boolean|null

Включить или выключить автоматическое использование layout.

$_classNamesource

protected string|null

Имя класса представления для использования. Может использовать обозначение плагина, короткое имя или полное имя класса с пространством имен.

$_helperssource

protected array

Используемые helpers.

[]

$_layoutsource

protected string|null|false

Имя используемого layout.

$_layoutPathsource

protected string|null

Путь к файлу layout для построения представления.

$_namesource

protected string|null

Переменные представления для использования

$_optionssource

protected array

Дополнительные параметры, используемые при создании представления.

Этот массив параметров позволяет передавать пользовательские аргументы конструктора в классы представления приложения/плагина.

[]

$_pluginsource

protected string|null|false

Имя используемого плагина.

$_templatesource

protected string|null

Файл шаблона для рендеринга.

$_templatePathsource

protected string|null

Подкаталог шаблонов.

$_themesource

protected string|null|false

Имя темы для использования.

$_varssource

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.7/class-Cake.View.ViewBuilder.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API