Spec-Zone.ru › CakePHP 3.8

Класс ViewBuilder

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

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

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

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

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

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

  • $_helpers protected
    array
    Используемые помощники
  • $_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
END_OF_DOCUMENT_MARKER

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 )

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

Параметры

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

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

Возвращает

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

Сериализует объект 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 $theme optional 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

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

$_helperssource

protected array

Используемые помощники

[]

$_layoutsource

protected string|null|false

Имя макета для отрисовки.

$_layoutPathsource

protected string|null

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

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

Spec-Zone.ru

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