HTML Хелпер¶
Файл HTML хелпера содержит функции, которые помогают в работе с HTML.
Загрузка этого помощника¶
Этот помощник загружается с помощью следующего кода:
$this->load->helper('html');
Доступные функции¶
Доступны следующие функции:
-
heading
([$data = ''[, $h = '1'[, $attributes = '']]])¶ Параметры: - $data (строка) – Содержимое
- $h (строка) – Уровень заголовка
- $attributes (смешанный) – HTML атрибуты
Возвращает: HTML тег заголовка
Возвращаемый тип: строка
Позволяет создавать теги заголовков HTML. Первый параметр будет содержать данные, второй Размер заголовка. Пример:
echo heading('Welcome!', 3);
Вышеуказанное произведет: <h3>Welcome!</h3>
Чтобы добавить атрибуты к тегу заголовка, такие как: классы, идентификаторы или встроенные стили, третий параметр принимает строку или массив:
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 (строка) – Данные источника изображения
- $index_page (булев) – Следует ли рассматривать $src как маршрутизируемую строку URI
- $attributes (массив) – HTML атрибуты
Возвращает: HTML тег изображения
Возвращаемый тип: строка
Позволяет создавать HTML <img /> tags. Первый параметр содержит источник изображения. Пример:
echo img('images/picture.jpg'); // gives <img src="http://site.com/images/picture.jpg" />
Существует дополнительный второй параметр, который принимает TRUE/FALSE значение, если src должен иметь указанное в
$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 (строка) – Что связываем
- $rel (строка) – Тип отношения
- $type (строка) – Тип связанного документа
- $title (строка) – Текст ссылки
- $media (строка) – Тип медиа
- $index_page (булев) – Следует ли рассматривать $src как маршрутизируемую строку URI
Возвращает: HTML тег ссылки
Возвращаемый тип: строка
Позволяет создавать HTML <link /> теги. Это полезно для ссылок таблиц стилей и других ссылок. Параметр href, с дополнительными rel, type, title, media и index_page.
index_page логическое значение, указывающее, href должен ли иметь указанное в
$config['index_page']
добавлние к адресу, который будет создан.Пример:
echo link_tag('css/mystyles.css'); // дает <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 (массив) – Записи списка
- $attributes (массив) – HTML атрибуты
Возвращает: HTML-форматированный неупорядоченный список
Возвращаемый тип: строка
Позволяет создавать неупорядоченные 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 (массив) – Записи списка
- $attributes (массив) – HTML атрибуты
Возвращает: HTML-отформатированный нумерованный список
Возвращаемый тип: строка
Идентичен
ul()
, только производит <ol> тег вместо <ul>.
-
meta
([$name = ''[, $content = ''[, $type = 'name'[, $newline = "n"]]]])¶ Параметры: - $name (строка) – Мета-имя
- $content (строка) – Мета-контент
- $type (строка) – Мета-тип
- $newline (строка) – Символ новой строки
Возвращает: HTML мета-тег
Возвращаемый тип: строка
Помогает создавать мета-теги. Можно передать в функцию строку, простые или многомерные массивы.
Примеры:
echo meta('description', 'My Great site'); // Генерирует: <meta name="description" content="My Great Site" /> echo meta('Content-type', 'text/html; charset=utf-8', 'equiv'); // Обратите внимание на третий параметр. Может быть "equiv" или "name" // Генерирует: <meta http-equiv="Content-type" content="text/html; charset=utf-8" /> echo meta(array('name' => 'robots', 'content' => 'no-cache')); // Генерирует: <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); // Генерирует: // <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" />
-
doctype
([$type = 'xhtml1-strict'])¶ Параметры: - $type (строка) – Наименование типа документа
Возвращает: HTML тег DocType
Возвращаемый тип: строка
Помогает создавать объявления типов документов, или DTD’s. По умолчанию используется 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">
Ниже приведен список вариантов doctype. Эти настройки взяты из 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 (число) – Количество повторений тега
Возвращает: HTML тег разрыва строки
Возвращаемый тип: строка
Создает тег разрыва строки (<br />) на основе числа, которое вы передаете. Пример:
echo br(3);
Вышеуказанное произведет:
<br /><br /><br />
Примечание
Эта функция УСТАРЕЛА. Используйте родную функцию
str_repeat()
в сочетании с<br />
.
-
nbs
([$num = 1])¶ Параметры: - $num (число) – Количество пробелов для создания
Возвращает: Последовательность HTML пробелов
Возвращаемый тип: строка
Создает неразрывные пробелы ( ) на основе числа, которое вы передаете. Пример:
echo nbs(3);
The above would produce:
Примечание
Эта функция УСТАРЕЛА. Используйте родную функцию
str_repeat()
в сочетании с
.