Класс HtmlHelper
Класс Html Helper для удобного использования HTML-виджетов.
HtmlHelper включает все необходимые методы при работе с HTML-страницами.
- AppHelper
-
HtmlHelper
Ссылка: https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/View/Helper/HtmlHelper.php
Краткое описание свойств
-
$_crumbsprotectedХлебные крошки.array -
$_docTypesprotectedОпределения типов документовarray -
$_includedAssetsprotectedИмена файлов скриптов и CSS, которые были включены один разarray -
$_scriptBlockOptionsprotectedПараметры для текущего открытого буфера блока скрипта, если таковой имеется.array -
$_tagsprotectedHTML-теги, используемые этим помощником.array - Ссылка на объект Response
$responsepublic
Краткое описание методов
- __construct() publicКонструктор
- _nestedListItem() protectedВнутренняя функция для построения вложенного списка (UL/OL) из ассоциативного массива.
- _prepareCrumbs() protectedДобавляет startText в массив crumbs, если он задан
- addCrumb() publicДобавляет ссылку в массив хлебных крошек.
- charset() publicВозвращает тег META charset.
- css() publicСоздает элемент ссылки для таблиц стилей CSS.
- div() publicВозвращает отформатированный тег DIV для HTML-форм.
- docType() publicВозвращает строку doctype.
- getCrumbList() publicВозвращает хлебные крошки как список (x)html
- getCrumbs() publicВозвращает след хлебных крошек как последовательность ссылок, разделенных »
- image() publicСоздает отформатированный элемент IMG.
- link() publicСоздает HTML-ссылку.
- loadConfig() publicЗагрузить конфигурацию тега Html.
- media() publicВозвращает элемент audio/video
- meta() publicСоздаёт ссылку на внешний ресурс и обрабатывает базовые теги meta
- nestedList() publicПостроение вложенного списка (UL/OL) из ассоциативного массива.
- para() publicВозвращает отформатированный тег P.
- script() publicВозвращает один или несколько тегов script в зависимости от количества переданных скриптов.
- scriptBlock() publicОборачивает $script в тег script.
- scriptEnd() public
Завершает буферизованный участок захвата JavaScript. Генерирует тег script встраиваемо или в блоке в зависимости от настроек, используемых при запуске scriptBlock
- scriptStart() public
Начинает блок скрипта, который захватывает вывод до вызова HtmlHelper::scriptEnd(). Этот блок захвата будет захватывать весь вывод между методами и создавать из него scriptBlock.
- style() publicСтроит данные стиля CSS из массива свойств CSS
- tableCells() publicВозвращает отформатированную строку строк таблицы (TR с TD в них).
- tableHeaders() publicВозвращает строку отформатированных и именованных заголовков таблицы.
- tag() publicВозвращает отформатированный блок-тег, например DIV, SPAN, P.
- useTag() publicВозвращает отформатированный существующий блок $tags
Подробное описание методов
__construct()source public
__construct( View $View , array $settings array() )
Конструктор
Настройки
-
configFileФайл, содержащий массив тегов, которые вы хотите переопределить.
Настройка наборов тегов
Используя параметр configFile, вы можете переопределить теги, которые будет использовать HtmlHelper. Название файла должно соответствовать HtmlHelper::loadConfig().
Параметры
-
View$View - Представление, к которому прикреплен этот помощник.
- массив
$settingsнеобязательный array() - Настройки конфигурации для помощника.
_nestedListItem()source protected
_nestedListItem( array $items , array $options , array $itemOptions , string $tag )
Внутренняя функция для построения вложенного списка (UL/OL) из ассоциативного массива.
Параметры
- массив
$items - Набор элементов для списка
- массив
$options - Дополнительные HTML-атрибуты тега списка (ol/ul)
- массив
$itemOptions - Дополнительные HTML-атрибуты тега элемента списка (LI)
- строка
$tag - Тип тега списка для использования (ol/ul)
Возвращает
строкаЭлемент вложенного списка
См.
HtmlHelper::nestedList()_prepareCrumbs()source protected
_prepareCrumbs( string $startText , boolean $escape true )
Добавляет startText в массив crumbs, если он задан
Параметры
- строка
$startText - Текст для добавления в начало
- логическое значение
$escapeнеобязательный true - Нужно ли экранировать вывод
Возвращает
массивСписок хлебных крошек, включая startText (если указано)
addCrumb()source public
addCrumb( string $name , string $link null , string|array $options null )
Добавляет ссылку в массив хлебных крошек.
Параметры
- prepend Добавляет хлебную крошку в начало. Используя этот параметр
Параметры
- строка
$name - Текст для ссылки
- строка
$linkнеобязательный null - URL для ссылки (если пусто, это не будет ссылка)
- строка/массив
$optionsнеобязательный null - Атрибуты ссылки, например, array('id' => 'selected')
Возвращает
HtmlHelperСм.
HtmlHelper::link() для подробной информации об $options, которые могут быть использованы.Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelpercharset()source public
charset( string $charset null )
Возвращает тег META charset.
Параметры
- строка
$charsetнеобязательный null Кодировка символов для использования в теге meta. Если пусто, будет использовано значение App.encoding. Пример: "utf-8".
Возвращает
строкаТег meta, содержащий указанную кодировку символов.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::charsetcss()source public
css( string|array $path , array $options array() )
Создаёт элемент ссылки для таблиц стилей CSS.
Использование
Включение одного файла CSS:
echo $this->Html->css('styles.css');
Включение нескольких файлов CSS:
echo $this->Html->css(array('one.css', 'two.css'));
Добавление таблицы стилей в переменную макета $scripts_for_layout:
$this->Html->css('styles.css', array('inline' => false));
Добавление таблицы стилей в пользовательский блок:
$this->Html->css('styles.css', array('block' => 'layoutCss'));
Параметры
-
inlineЕсли установлено в значение false, сгенерированный тег будет добавлен в блок 'css', и включён в переменную макета$scripts_for_layout. По умолчанию true. -
onceНеобходимо ли проверять уникальность файла CSS. Если true, файлы CSS будут включены только один раз, установите false, чтобы разрешить включение одного и того же CSS более чем один раз за запрос. -
blockУстановите имя блока, к которому будет добавлен тег ссылки/стиля. Это переопределяет параметрinline. -
pluginЗначение false предотвратит обработку пути как плагина -
relПо умолчанию 'stylesheet'. Если равно 'import', таблица стилей будет импортирована. -
fullBaseЕсли true, URL получит полный адрес для файла CSS.
Параметры
- string|array
$path Имя файла таблицы стилей CSS или массив содержащий имена файлов таблиц стилей CSS. Если
$pathначинается с '/', путь будет относительным к каталогу webroot вашего приложения. В противном случае, путь будет относительным к каталогу ваших файлов CSS, обычно webroot/css.- array
$optionsoptional array() - Массив параметров и атрибутов HTML.
Возвращаемое значение
stringТег CSS
<link /> или <style />, в зависимости от типа ссылки.Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::cssdiv()source public
div( string $class null , string $text null , array $options array() )
Возвращает отформатированный тег DIV для HTML-форм.
Параметры
-
escapeНеобходимо ли экранировать содержимое.
Параметры
- string
$classoptional null - Имя класса CSS для элемента div.
- string
$textoptional null Строковое содержимое, которое будет отображаться внутри элемента div. Если null, будет выведен только открывающий тег.
- array
$optionsoptional array() - Дополнительные атрибуты HTML для тега DIV.
Возвращаемое значение
stringОтформатированный элемент DIV
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::divdocType()source public
docType( string $type 'html5' )
Возвращает строку типа документа.
Возможные типы документов:
- html4-strict: HTML4 Строгий.
- html4-trans: HTML4 Переходный.
- html4-frame: HTML4 Фреймсеты.
- html5: HTML5. Значение по умолчанию.
- xhtml-strict: XHTML1 Строгий.
- xhtml-trans: XHTML1 Переходный.
- xhtml-frame: XHTML1 Фреймсеты.
- xhtml11: XHTML1.1.
Параметры
- string
$typeoptional 'html5' - Тип документа для использования.
Возвращаемое значение
string|nullСтрока типа документа
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::docTypegetCrumbList()source public
getCrumbList( array $options array() , string|array|boolean $startText false )
Возвращает хлебные крошки как список (x)html.
Этот метод использует HtmlHelper::tag() для генерации списка и его элементов. Работает аналогично HtmlHelper::getCrumbs(), поэтому использует параметры, которые были добавлены к каждой крошке.
Параметры
-
separatorСодержимое разделителя для вставки между хлебными крошками, по умолчанию '' -
firstClassКласс для обертки тега первой хлебной крошки, по умолчанию 'first' -
lastClassКласс для обертки тега текущей активной страницы, по умолчанию 'last'
Параметры
- array
$optionsoptional array() - Массив атрибутов html, которые следует применить к сгенерированным элементам списка.
- string|array|boolean
$startTextoptional false Это будет первой крошкой, если false, по умолчанию первая крошка в массиве. Также может быть массивом, см.
HtmlHelper::getCrumbsдля подробностей.
Возвращаемое значение
string|nullСписок html хлебных крошек
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelpergetCrumbs()source public
getCrumbs( string $separator '»' , string|array|boolean $startText false )
Возвращает след хлебных крошек как последовательность разделенных символом » ссылок.
Если $startText является массивом, допустимые ключи:
-
textОпределите текст/содержимое ссылки. -
urlОпределите целевой адрес созданной ссылки.
Все остальные ключи будут переданы методу HtmlHelper::link() в качестве параметра $options.
Параметры
- string
$separatoroptional '»' - Текст для разделения крошек.
- string|array|boolean
$startTextoptional false Это будет первой крошкой, если false, по умолчанию первая крошка в массиве. Также может быть массивом, см. выше для подробностей.
Возвращаемое значение
string|nullСоставленные хлебные крошки
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelperimage()source public
image( string $path , array $options array() )
Создаёт отформатированный элемент IMG.
Этот метод установит пустой атрибут alt, если он не предоставлен.
Использование:
Создание обычной картинки:
echo $this->Html->image('cake_icon.png', array('alt' => 'CakePHP'));
Создание ссылки на изображение:
echo $this->Html->image('cake_icon.png', array('alt' => 'CakePHP', 'url' => 'https://cakephp.org'));
Параметры:
-
urlЕсли предоставлен, будет сгенерирована ссылка на изображение, которая будет указывать на$options['url']. -
fullBaseЕсли true, атрибут src получит полный адрес файла изображения. -
pluginЗначение false предотвратит обработку пути как плагина -
base64Если true, атрибут src будет вместо этого представлять собой базу данных данных URI в формате base64 файла изображения. Не может быть использован с внешними ссылками.
Параметры
- string
$path - Путь к файлу изображения, относительно каталога app/webroot/img/.
- array
$optionsoptional array() - Массив атрибутов HTML. См. выше для специальных параметров.
Возвращаемое значение
stringЗавершенный тег img
Исключения
InvalidArgumentException- если изображение не находится на диске, и вы запросили вывод base64
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::imagelink()source public
link( string $title , string|array $url null , array $options array() , string $confirmMessage false )
Создаёт HTML ссылку.
Если $url начинается с "http://", это обрабатывается как внешняя ссылка. В противном случае, это обрабатывается как путь к контроллеру/действию и анализируется с помощью метода HtmlHelper::url().
Если $url пусто, используется $title вместо.
Параметры
-
escapeУстановите в значение false для отключения экранирования заголовка и атрибутов. -
escapeTitleУстановите в значение false для отключения экранирования заголовка. (Имеет приоритет над значениемescape) -
confirmСообщение подтверждения JavaScript.
Параметры
- string
$title - Содержимое, которое будет обернуто тегами
<a>. - string|array
$urloptional null - Относительный путь к Cake или массив параметров URL, или внешний URL (начинается с http://)
- array
$optionsoptional array() - Массив параметров и атрибутов HTML.
- string
$confirmMessageoptional false Сообщение подтверждения JavaScript. Этот аргумент устарел начиная с версии 2.6. Используйте ключ
confirmв $options вместо.
Возвращаемое значение
stringЭлемент
<a />.Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::linkloadConfig()source public
loadConfig( string|array $configFile , string $path null )
Загрузка конфигурации тегов HTML.
Загружает файл из CONFIG, содержащий данные тегов. По умолчанию ожидается, что файл совместим с PhpReader:
$this->Html->loadConfig('tags.php');
Файл tags.php может выглядеть следующим образом:
$tags = array(
'meta' => '<meta%s>'
); Если вы хотите сохранить определения тегов в другом формате, вы можете указать массив, содержащий имя файла и имя класса ридера:
$this->Html->loadConfig(array('tags.ini', 'ini'));
Ожидается, что индекс tags будет существовать во всех считываемых файлах конфигурации. Вы также можете указать путь к файлу конфигурации, если он не находится в каталоге CONFIG.
$this->Html->loadConfig('tags.php', APP . 'Lib' . DS);
Файлы конфигурации могут определять следующие разделы:
-
tagsТеги для замены. -
minimizedAttributesАтрибуты, которые представлены какdisabled="disabled" -
docTypesДополнительные доctypes для использования. -
attributeFormatФормат для длинных атрибутов, например,'%s="%s"' -
minimizedAttributeFormatФормат для свёрнутых атрибутов, например,'%s="%s"'
Параметры
- string|array
$configFile - Строка с именем файла конфигурации (загрузка с использованием PhpReader) или массив с именем файла и ридера.
- string
$pathопционально null - Путь к файлу конфигурации.
Возвращает
mixedFalse в случае ошибки или загруженные конфигурации
Выбрасывает
ConfigureExceptionСсылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#changing-the-tags-output-by-htmlhelpermedia()source public
media( string|array $path , array $options array() )
Возвращает элемент аудио/видео.
Использование
Использование аудиофайла:
echo $this->Html->media('audio.mp3', array('fullBase' => true));
Вывод:
<video src="http://www.somehost.com/files/audio.mp3">Fallback text</video>
Использование видеофайла:
echo $this->Html->media('video.mp4', array('text' => 'Fallback text'));
Вывод:
<video src="/files/video.mp4">Fallback text</video>
Использование нескольких видеофайлов:
echo $this->Html->media(
array('video.mp4', array('src' => 'video.ogv', 'type' => "video/ogg; codecs='theora, vorbis'")),
array('tag' => 'video', 'autoplay')
); Вывод:
<video autoplay="autoplay">
<source src="/files/video.mp4" type="video/mp4"/>
<source src="/files/video.ogv" type="video/ogv; codecs='theora, vorbis'"/>
</video> Опции
-
tagТип элемента медиа, который необходимо сгенерировать, "audio" или "video". Если тег не указан, он определяется на основе MIME-типа файла. -
textТекст, который нужно включить внутри тега аудио/видео. -
pathPrefixПрефикс пути для использования для относительных URL-адресов, по умолчанию "files/". -
fullBaseЕсли указано, атрибут src получит полный адрес, включая доменное имя.
Параметры
- string|array
$path Путь к видеофайлу, относительно каталога webroot/{$options['pathPrefix']}. Или массив, где каждый элемент может быть строкой пути или ассоциативным массивом, содержащим ключи
srcиtype.- array
$optionsопционально массив() - Массив HTML-атрибутов и специальных опций, описанных выше.
Возвращает
stringСгенерированный элемент медиа
meta()source public
meta( string $type , string|array $url null , array $options array() )
Создаёт ссылку на внешний ресурс и обрабатывает базовые теги meta.
Создать тег meta, который выводится встроеным:
`$this->Html->meta('icon', 'favicon.ico');
Добавить тег meta к $scripts_for_layout:
$this->Html->meta('description', 'A great page', array('inline' => false));
Добавить тег meta в пользовательский блок представления:
$this->Html->meta('description', 'A great page', array('block' => 'metaTags'));
Опции
-
inlineВыводить ли элемент ссылки встроеным. Установите в false, чтобы добавить тег meta в$scripts_for_layoutи добавить его в блок представления 'meta'. -
blockВыберите пользовательский блок для добавления тега meta. Использование этой опции переопределит опцию inline.
Параметры
- string
$type - Название внешнего ресурса.
- string|array
$urlопционально null - Адрес внешнего ресурса или строка для атрибута content.
- array
$optionsопционально массив() Другие атрибуты для сгенерированного тега. Если атрибут type равен html, rss, atom или icon, возвращается MIME-тип.
Возвращает
stringЗавершенный элемент
<link />.Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::metanestedList()source public
nestedList( array $list , array $options array() , array $itemOptions array() , string $tag 'ul' )
Построение вложенного списка (UL/OL) из ассоциативного массива.
Параметры
- array
$list - Множество элементов для списка.
- array
$optionsопционально массив() - Дополнительные HTML-атрибуты тега списка (ol/ul), или, если используется ul/ol, тег.
- array
$itemOptionsопционально массив() - Дополнительные HTML-атрибуты тега элемента списка (LI).
- string
$tagопционально 'ul' - Тип тега списка для использования (ol/ul).
Возвращает
stringВложенный список
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::nestedListpara()source public
para( string $class , string $text , array $options array() )
Возвращает отформатированный тег P.
Опции
-
escapeHTML-сущности должны быть экранированы.
Параметры
- string
$class - Имя класса CSS элемента p.
- string
$text - Строка контента, которая будет отображаться внутри элемента p.
- array
$optionsопционально массив() - Дополнительные HTML-атрибуты тега P.
Возвращает
stringОтформатированный элемент P
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::parascript()source public
script( string|array $url , array|boolean $options array() )
Возвращает один или несколько тегов script, в зависимости от количества переданных скриптов.
Если имя файла начинается с "/", путь будет относительным к корневому пути вашего приложения. В противном случае путь будет относительным к вашему пути к JavaScript, обычно webroot/js.
Использование
Включение одного файла скрипта:
echo $this->Html->script('styles.js');
Включение нескольких файлов скриптов:
echo $this->Html->script(array('one.js', 'two.js'));
Добавление файла скрипта в переменную макета $scripts_for_layout:
$this->Html->script('styles.js', array('inline' => false));
Добавление файла скрипта в пользовательский блок:
$this->Html->script('styles.js', array('block' => 'bodyScript'));
Опции
-
inlineВыводить ли скрипт в строке или в$scripts_for_layout. При установке в false, тег script будет добавлен в блок представления 'script', а также в$scripts_for_layout. -
blockНазвание блока, в который будет добавлен скрипт. Оставьте не определённым, чтобы вывести inline. Использование этой опции переопределит опцию inline. -
onceПроверять ли скрипт на уникальность. Если true, скрипты будут включены только один раз. Используйте false, чтобы разрешить включение одного и того же скрипта более чем один раз за запрос. -
pluginЗначение false предотвратит интерпретацию пути как плагина. -
fullBaseЕсли true, URL получит полный адрес для файла скрипта.
Параметры
- string|array
$url - Строка или массив файлов JavaScript для включения.
- array|boolean
$optionsопционально массив() - Массив опций и HTML-атрибутов, см. выше. Если булево, устанавливает $options['inline'] = значение.
Возвращает
mixedСтрока тегов <script /> или null, если $inline равен false или если $once равен true и файл уже был включён ранее.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::scriptscriptBlock()source public
scriptBlock( string $script , array $options array() )
Оборачивает $script в тег script.
Параметры
-
safe(boolean) Включает/выключает обёртывание $script в<![CDATA[ ]]> -
inline(boolean) Включает/выключает добавление $script в$scripts_for_layout/scriptблок, или вывод в строку. (Устарело, используйтеblockвместо этого) -
blockБлок, в который будет добавлен этот блок скрипта. По умолчанию -script.
Параметры
- string
$script - Скрипт для обёртывания
- array
$optionsoptional array() Параметры для использования. Параметры, не указанные выше, будут обработаны как атрибуты HTML.
Возвращаемое значение
mixedстрока или null в зависимости от значения
$options['block']Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::scriptBlockscriptEnd()source public
scriptEnd( )
Завершает буферизованный участок захвата JavaScript. Генерирует тег script в строку или в $scripts_for_layout в зависимости от настроек, используемых при запуске scriptBlock.
Возвращаемое значение
mixedв зависимости от настроек scriptStart(), либо тег script, либо null
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::scriptEndscriptStart()source public
scriptStart( array $options array() )
Начинает блок скрипта, который захватывает вывод до вызова HtmlHelper::scriptEnd(). Этот блок захвата будет захватывать весь вывод между методами и создавать из него scriptBlock.
Параметры
-
safeВключает/выключает CDATA в блоке кода -
inlineВыводить сгенерированный тег script в строку или в$scripts_for_layout
Параметры
- array
$optionsoptional array() - Параметры для блока кода.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::scriptStartstyle()source public
style( array $data , boolean $oneline true )
Создаёт данные CSS из массива свойств CSS.
Пример:
echo $this->Html->style(array('margin' => '10px', 'padding' => '10px'), true);
// creates
'margin:10px;padding:10px;' Параметры
- array
$data - Массив данных стилей, ключи будут использованы как имена свойств, значения как значения свойств.
- boolean
$onelineoptional true - Включает/выключает вывод блока стиля в одну строку.
Возвращаемое значение
stringДанные стилей CSS
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::styletableCells()source public
tableCells( array $data , array $oddTrOptions null , array $evenTrOptions null , boolean $useCount false , boolean $continueOddEven true )
Возвращает отформатированную строку строк таблицы (TR с TD внутри).
Параметры
- array
$data - Массив данных таблицы
- array
$oddTrOptionsoptional null - Опции HTML для нечётных элементов TR, если true, используется useCount.
- array
$evenTrOptionsoptional null - Опции HTML для чётных элементов TR.
- boolean
$useCountoptional false - Добавляет класс "column-$i".
- boolean
$continueOddEvenoptional true Если false, будет использоваться нестатическая переменная $count, поэтому счётчик чётных/нечётных строк будет сброшен в ноль только для этого вызова.
Возвращаемое значение
stringОтформатированный HTML
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::tableCellstableHeaders()source public
tableHeaders( array $names , array $trOptions null , array $thOptions null )
Возвращает строку отформатированных и именованных заголовков TABLE.
Параметры
- array
$names Массив имён таблиц. Каждое имя таблицы также может быть ключом, указывающим на массив с набором атрибутов для соответствующего тега.
- array
$trOptionsoptional null - Опции HTML для элементов TR.
- array
$thOptionsoptional null - Опции HTML для элементов TH.
Возвращаемое значение
stringЗаголовки таблицы
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::tableHeaderstag()source public
tag( string $name , string $text null , array $options array() )
Возвращает отформатированный тег блока, например, DIV, SPAN, P.
Параметры
-
escapeВключает/выключает html_entity_escape содержимого.
Параметры
- string
$name - Имя тега.
- string
$textoptional null Строковое содержимое, которое будет отображаться внутри элемента div. Если null, будет напечатан только открывающий тег.
- array
$optionsoptional array() - Дополнительные атрибуты HTML тега DIV, см. выше.
Возвращаемое значение
stringОтформатированный элемент тега
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::taguseTag()source public
useTag( string $tag )
Возвращает отформатированный существующий блок $tags.
Параметры
- string
$tag - Имя тега
Возвращаемое значение
stringОтформатированный блок
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/html.html#HtmlHelper::useTagПодробное описание свойств
$_docTypessource
protected array
Определения типов документов
array(
'html4-strict' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">',
'html4-trans' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">',
'html4-frame' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">',
'html5' => '<!DOCTYPE html>',
'xhtml-strict' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">',
'xhtml-trans' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">',
'xhtml-frame' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">',
'xhtml11' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'
) $_includedAssetssource
protected array
Имена файлов скриптов и CSS, которые были включены один раз
array()
$_scriptBlockOptionssource
protected array
Параметры для текущего открытого буфера блока скрипта, если таковой имеется.
array()
$_tagssource
protected array
Теги HTML, используемые этим хелпером.
array(
'meta' => '<meta%s/>',
'metalink' => '<link href="%s"%s/>',
'link' => '<a href="%s"%s>%s</a>',
'mailto' => '<a href="mailto:%s"%s>%s</a>',
'form' => '<form action="%s"%s>',
'formwithoutaction' => '<form%s>',
'formend' => '</form>',
'input' => '<input name="%s"%s/>',
'textarea' => '<textarea name="%s"%s>%s</textarea>',
'hidden' => '<input type="hidden" name="%s"%s/>',
'checkbox' => '<input type="checkbox" name="%s"%s/>',
'checkboxmultiple' => '<input type="checkbox" name="%s[]"%s />',
'radio' => '<input type="radio" name="%s" id="%s"%s />%s',
'selectstart' => '<select name="%s"%s>',
'selectmultiplestart' => '<select name="%s[]"%s>',
'selectempty' => '<option value=""%s> </option>',
'selectoption' => '<option value="%s"%s>%s</option>',
'selectend' => '</select>',
'optiongroup' => '<optgroup label="%s"%s>',
'optiongroupend' => '</optgroup>',
'checkboxmultiplestart' => '',
'checkboxmultipleend' => '',
'password' => '<input type="password" name="%s"%s/>',
'file' => '<input type="file" name="%s"%s/>',
'file_no_model' => '<input type="file" name="%s"%s/>',
'submit' => '<input%s/>',
'submitimage' => '<input type="image" src="%s"%s/>',
'button' => '<button%s>%s</button>',
'image' => '<img src="%s"%s/>',
'tableheader' => '<th%s>%s</th>',
'tableheaderrow' => '<tr%s>%s</tr>',
'tablecell' => '<td%s>%s</td>',
'tablerow' => '<tr%s>%s</tr>',
'block' => '<div%s>%s</div>',
'blockstart' => '<div%s>',
'blockend' => '</div>',
'hiddenblock' => '<div style="display:none;">%s</div>',
'tag' => '<%s%s>%s</%s>',
'tagstart' => '<%s%s>',
'tagend' => '</%s>',
'tagselfclosing' => '<%s%s/>',
'para' => '<p%s>%s</p>',
'parastart' => '<p%s>',
'label' => '<label for="%s"%s>%s</label>',
'fieldset' => '<fieldset%s>%s</fieldset>',
'fieldsetstart' => '<fieldset><legend>%s</legend>',
'fieldsetend' => '</fieldset>',
'legend' => '<legend>%s</legend>',
'css' => '<link rel="%s" type="text/css" href="%s"%s/>',
'style' => '<style type="text/css"%s>%s</style>',
'charset' => '<meta http-equiv="Content-Type" content="text/html; charset=%s" />',
'ul' => '<ul%s>%s</ul>',
'ol' => '<ol%s>%s</ol>',
'li' => '<li%s>%s</li>',
'error' => '<div%s>%s</div>',
'javascriptblock' => '<script%s>%s</script>',
'javascriptstart' => '<script>',
'javascriptlink' => '<script type="text/javascript" src="%s"%s></script>',
'javascriptend' => '</script>'
)
© 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/2.10/class-HtmlHelper.html