HTML Helper

Файл HTML Helper содержит функции, которые помогают работать с HTML.

Загрузка этого Helper
Доступные функции

Загрузка этого Helper

Этот helper загружается с помощью следующего кода:

$this->load->helper('html');

Доступные функции

Доступны следующие функции:

heading([$data = ''[, $h = '1'[, $attributes = '']]])

Параметры:	$data (string) – Содержимое $h (string) – Уровень заголовка $attributes (mixed) – Атрибуты HTML
Возвращает:	Тег заголовка HTML
Тип возвращаемого значения:	string

Позволяет создавать теги заголовков HTML. Первый параметр содержит данные, второй — размер заголовка. Пример:

echo heading('Welcome!', 3);

Это произведёт: <h3>Привет!</h3>

Кроме того, для добавления атрибутов к тегу заголовка, таких как классы HTML, идентификаторы или встроенные стили, третий параметр принимает строку или массив:

echo heading('Welcome!', 3, 'class="pink"');
echo heading('How are you?', 4, array('id' => 'question', 'class' => 'green'));

Этот код создаст:

<h3 class="pink">Welcome!<h3>
<h4 id="question" class="green">How are you?</h4>

img([$src = ''[, $index_page = FALSE[, $attributes = '']]])

Параметры:	$src (string) – Данные источника изображения $index_page (bool) – Указывает, считать ли $src строкой URI маршрута $attributes (array) – Атрибуты HTML
Возвращает:	Тег изображения HTML
Тип возвращаемого значения:	string

Позволяет создавать теги HTML <img />. Первый параметр содержит источник изображения. Пример:

echo img('images/picture.jpg'); // gives <img src="http://site.com/images/picture.jpg" />

Есть необязательный второй параметр, который является значением ИСТИНА/ЛОЖЬ и указывает, нужно ли добавлять страницу, указанную $config['index_page'] к адресу, который он создаёт. Вероятно, это нужно, если вы используете контроллер медиа:

echo img('images/picture.jpg', TRUE); // gives <img src="http://site.com/index.php/images/picture.jpg" alt="" />

Кроме того, ассоциативный массив может быть передан в функцию img() для полного управления всеми атрибутами и значениями. Если атрибут alt не указан, CodeIgniter сгенерирует пустую строку.

Пример:

$image_properties = array(
        'src'   => 'images/picture.jpg',
        'alt'   => 'Me, demonstrating how to eat 4 slices of pizza at one time',
        'class' => 'post_images',
        'width' => '200',
        'height'=> '200',
        'title' => 'That was quite a night',
        'rel'   => 'lightbox'
);

img($image_properties);
// <img src="http://site.com/index.php/images/picture.jpg" alt="Me, demonstrating how to eat 4 slices of pizza at one time" class="post_images" width="200" height="200" title="That was quite a night" rel="lightbox" />

link_tag([$href = ''[, $rel = 'stylesheet'[, $type = 'text/css'[, $title = ''[, $media = ''[, $index_page = FALSE]]]]]])

Параметры:	$href (string) – На что ссылаемся $rel (string) – Тип отношения $type (string) – Тип связанного документа $title (string) – Заголовок ссылки $media (string) – Тип носителя $index_page (bool) – Указывает, считать ли $src строкой URI маршрута
Возвращает:	Тег ссылки HTML
Тип возвращаемого значения:	string

Позволяет создавать теги HTML <link />. Это полезно для ссылок на таблицы стилей, а также для других ссылок. Параметры — href, с необязательными rel, type, title, media и index_page.

index_page — булево значение, которое указывает, нужно ли добавлять страницу, указанную $config['index_page'] к адресу, который он создаёт.

Пример:

echo link_tag('css/mystyles.css');
// gives <link href="http://site.com/css/mystyles.css" rel="stylesheet" type="text/css" />

Дополнительные примеры:

echo link_tag('favicon.ico', 'shortcut icon', 'image/ico');
// <link href="http://site.com/favicon.ico" rel="shortcut icon" type="image/ico" />

echo link_tag('feed', 'alternate', 'application/rss+xml', 'My RSS Feed');
// <link href="http://site.com/feed" rel="alternate" type="application/rss+xml" title="My RSS Feed" />

Кроме того, ассоциативный массив можно передать в функцию link() для полного управления всеми атрибутами и значениями:

$link = array(
        'href'  => 'css/printer.css',
        'rel'   => 'stylesheet',
        'type'  => 'text/css',
        'media' => 'print'
);

echo link_tag($link);
// <link href="http://site.com/css/printer.css" rel="stylesheet" type="text/css" media="print" />

ul($list[, $attributes = ''])

Параметры:	$list (array) – Элементы списка $attributes (array) – Атрибуты HTML
Возвращает:	Неупорядоченный список HTML-формата
Тип возвращаемого значения:	string

Позволяет генерировать неупорядоченные списки HTML из простых или многомерных массивов. Пример:

$list = array(
        'red',
        'blue',
        'green',
        'yellow'
);

$attributes = array(
        'class' => 'boldlist',
        'id'    => 'mylist'
);

echo ul($list, $attributes);

Этот код создаст:

<ul class="boldlist" id="mylist">
        <li>red</li>
        <li>blue</li>
        <li>green</li>
        <li>yellow</li>
</ul>

Вот более сложный пример, использующий многомерный массив:

$attributes = array(
        'class' => 'boldlist',
        'id'    => 'mylist'
);

$list = array(
        'colors'  => array(
                'red',
                'blue',
                'green'
        ),
        'shapes'  => array(
                'round',
                'square',
                'circles' => array(
                        'ellipse',
                        'oval',
                        'sphere'
                )
        ),
        'moods'  => array(
                'happy',
                'upset' => array(
                        'defeated' => array(
                                'dejected',
                                'disheartened',
                                'depressed'
                        ),
                        'annoyed',
                        'cross',
                        'angry'
                )
        )
);

echo ul($list, $attributes);

Этот код создаст:

<ul class="boldlist" id="mylist">
        <li>colors
                <ul>
                        <li>red</li>
                        <li>blue</li>
                        <li>green</li>
                </ul>
        </li>
        <li>shapes
                <ul>
                        <li>round</li>
                        <li>suare</li>
                        <li>circles
                                <ul>
                                        <li>elipse</li>
                                        <li>oval</li>
                                        <li>sphere</li>
                                </ul>
                        </li>
                </ul>
        </li>
        <li>moods
                <ul>
                        <li>happy</li>
                        <li>upset
                                <ul>
                                        <li>defeated
                                                <ul>
                                                        <li>dejected</li>
                                                        <li>disheartened</li>
                                                        <li>depressed</li>
                                                </ul>
                                        </li>
                                        <li>annoyed</li>
                                        <li>cross</li>
                                        <li>angry</li>
                                </ul>
                        </li>
                </ul>
        </li>
</ul>

ol($list, $attributes = '')

Параметры:	$list (array) – Элементы списка $attributes (array) – Атрибуты HTML
Возвращает:	Отсортированный список HTML-формата
Тип возвращаемого значения:	string

Идентично ul(), только создаёт тег <ol> для упорядоченных списков вместо <ul>.

meta([$name = ''[, $content = ''[, $type = 'name'[, $newline = "n"]]]])

Параметры:	$name (string) – Имя метатега $content (string) – Содержимое метатега $type (string) – Тип метатега $newline (string) – Символ новой строки
Возвращает:	Тег метаданных HTML
Тип возвращаемого значения:	string

Помогает генерировать теги метаданных. Вы можете передавать в функцию строки, простые массивы или многомерные.

Примеры:

echo meta('description', 'My Great site');
// Generates:  <meta name="description" content="My Great Site" />

echo meta('Content-type', 'text/html; charset=utf-8', 'equiv');
// Note the third parameter.  Can be "equiv" or "name"
// Generates:  <meta http-equiv="Content-type" content="text/html; charset=utf-8" />

echo meta(array('name' => 'robots', 'content' => 'no-cache'));
// Generates:  <meta name="robots" content="no-cache" />

$meta = array(
        array(
                'name' => 'robots',
                'content' => 'no-cache'
        ),
        array(
                'name' => 'description',
                'content' => 'My Great Site'
        ),
        array(
                'name' => 'keywords',
                'content' => 'love, passion, intrigue, deception'
        ),
        array(
                'name' => 'robots',
                'content' => 'no-cache'
        ),
        array(
                'name' => 'Content-type',
                'content' => 'text/html; charset=utf-8', 'type' => 'equiv'
        )
);

echo meta($meta);
// Generates:
// <meta name="robots" content="no-cache" />
// <meta name="description" content="My Great Site" />
// <meta name="keywords" content="love, passion, intrigue, deception" />
// <meta name="robots" content="no-cache" />
// <meta http-equiv="Content-type" content="text/html; charset=utf-8" />

END_OF_DOCUMENT_MARKER

doctype([$type = 'xhtml1-strict'])

Параметры:	$type (строка) – Название типа документа
Возвращает:	Тег HTML типа документа
Тип возвращаемого значения:	строка

Помогает генерировать объявления типов документов или DTD. По умолчанию используется XHTML 1.0 Strict, но доступно множество типов документов.

Пример:

echo doctype(); // <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

echo doctype('html4-trans'); // <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

Ниже приведен список доступных типов документов. Они настраиваются и берутся из application/config/doctypes.php

Тип документа	Вариант	Результат
XHTML 1.1	xhtml11	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1//EN” “http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd”>
XHTML 1.0 Strict	xhtml1-strict	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Strict//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd”>
XHTML 1.0 Transitional	xhtml1-trans	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
XHTML 1.0 Frameset	xhtml1-frame	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Frameset//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd”>
XHTML Basic 1.1	xhtml-basic11	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML Basic 1.1//EN” “http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd”>
HTML 5	html5	<!DOCTYPE html>
HTML 4 Strict	html4-strict	<!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01//EN” “http://www.w3.org/TR/html4/strict.dtd”>
HTML 4 Transitional	html4-trans	<!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN” “http://www.w3.org/TR/html4/loose.dtd”>
HTML 4 Frameset	html4-frame	<!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Frameset//EN” “http://www.w3.org/TR/html4/frameset.dtd”>
MathML 1.01	mathml1	<!DOCTYPE math SYSTEM “http://www.w3.org/Math/DTD/mathml1/mathml.dtd”>
MathML 2.0	mathml2	<!DOCTYPE math PUBLIC “-//W3C//DTD MathML 2.0//EN” “http://www.w3.org/Math/DTD/mathml2/mathml2.dtd”>
SVG 1.0	svg10	<!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.0//EN” “http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd”>
SVG 1.1 Full	svg11	<!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd”>
SVG 1.1 Basic	svg11-basic	<!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Basic//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd”>
SVG 1.1 Tiny	svg11-tiny	<!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Tiny//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd”>
XHTML+MathML+SVG (XHTML host)	xhtml-math-svg-xh	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd”>
XHTML+MathML+SVG (SVG host)	xhtml-math-svg-sh	<!DOCTYPE svg:svg PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd”>
XHTML+RDFa 1.0	xhtml-rdfa-1	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.0//EN” “http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd”>
XHTML+RDFa 1.1	xhtml-rdfa-2	<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.1//EN” “http://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd”>

br([$count = 1])

Параметры:	$count (int) – Количество повторений тега
Возвращает:	Тег HTML перевода строки
Тип возвращаемого значения:	строка

Генерирует теги перевода строки (<br />) в соответствии с переданным количеством. Пример:

echo br(3);

Это приведет к:

<br /><br /><br />

Примечание

Эта функция устарела. Используйте встроенную функцию str_repeat() в сочетании с <br />.

nbs([$num = 1])

Параметры:	$num (int) – Количество символов неразрывного пробела
Возвращает:	Последовательность HTML-сущностей неразрывного пробела
Тип возвращаемого значения:	строка

Генерирует неразрывные пробелы ( ) в соответствии с переданным количеством. Пример:

echo nbs(3);

Это приведет к:

&nbsp;&nbsp;&nbsp;

Примечание

Эта функция устарела. Используйте встроенную функцию str_repeat() в сочетании с   вместо неё.

© 2014–2020 British Columbia Institute of Technology
Licensed under the MIT License.
https://codeigniter.com/userguide3/helpers/html_helper.html