Разрботка расширений для CMS Joomla

Генерация элементов HTML (класс JHTML)

Лекция посвящена классу JHTML и поддерживающим классам. Рассмотрены методы для вывода элементов XHTML.

Цель лекции:Изучить готовые методы Joomla для генерации и отображения элементов XHTML и поведений JavaScript.

Основной метод класса JHTML

Joomla содержит методы для генерации и отображения элементов XHTML и поведений JavaScript. Эти методы вызываются с помощью

mixed _(string $type)

Несмотря на то, что в прототипе метода JHTML::_() указан всего один параметр, на практике их, как правило, бывает больше. Они интерпретируются так: по первому параметру метод _() определяет, какой метод необходимо вызвать, а остальные параметры передаются в этот метод.

Параметр $type может быть трех видов:

Название метода самого класса JHTML. Например, $type = 'image' приведет к вызову JHTML::image().

<имя файла>.<имя метода>. Будет вызван метод поддерживающего класса JHTML<Имя файла>.<имя метода>(). В имени поддерживающего класса первая буква <имени файла> станет заглавной. Например, если $type='select.genericlist', то будет вызван метод JHTMLSelect::genericlist().

<префикс>.<имя файла>.<имя метода> и будет вызван метод <префикс>.<Имя файла>.<имя метода>().

Методы класса JHTML

Класс JHTML содержит восемь методов для вывода элементов XHTML.

Поле для ввода даты и пиктограмма, по щелчку на которой появляется календарь

string calendar(string $value, string $name, string $id, string $format = '%Y-%m-%d', array $attribs = null)

где:

$value - значение даты; $name - имя текстового поля; $id - id текстового поля; $format - формат даты; $attribs - дополнительные атрибуты, которые должны быть выведены в теге .

Для примера выведем текущую дату (рис. 3.1):

echo JHTML::_('calendar', date('Y-m-d',time()), 'created', 'created', '%Y-%m-%d', array('size'=>10,'style'=>"class='inputbox'"));

Рис. 3.1.  Поле для ввода даты и пиктограмма для вывода календаря

Строка, содержащая дату в заданном формате и часовом поясе

string date(string $input = 'now', string $format = null, mixed $tz = true, bool $gregorian=false)

где:

$input - строка в формате, подходящем для функции date(); $format - формат, к которому необходимо привести дату; $tz - одна из временных зон, поддерживаемых PHP (их список можно найти на странице ссылка: http://www.php.net/manual/ru/timezones.php). Кроме того, $tz может иметь логическое значение: при $tz=true временная зона берется из настроек пользователя, при $tz=false - из настроек сервера; $gregorian - при false для форматирования даты будет использоваться локальный календарь.

Для примера выведем текущую дату:

echo JHTML::_('date',date('Y-m-d',time()), 'Y-m-d h:m', 'Europe/Moscow', false);

Элемент

string iframe(string $url, string $name, array $attribs = null, string $noFrames = '')

где

$url - относительный URL, будущее значение атрибута src; $name - название будущего элемента

Пример:

echo JHTML::_('iframe','index.php', 'myelement', array('width'=>500,'height'=>300), 'Ваш браузер не поддерживает плавающие фреймы');

Элемент

string image(string $file, string $alt, mixed $attribs = null, bool $relative = false, bool $path_only = false)

где

$file - абсолютный или относительный URL изображения; $alt - альтернативный текст; $attribs - ассоциативный массив атрибутов будущего тега (может быть задан сразу в виде строки, например: "width="100%" height="100%""); $relative - перебирать ли варианты пути к файлу; $path_only - возвращать ли только путь к изображению или тег со всеми атрибутами.

Для методов image(), script() и stylesheet() будет выполнена следующая процедура поиска файла. Если $file начинается с "http", то метод просто вернет $file. В противном случае он производит поиск файла, перебирая возможные варианты его названия в зависимости от браузера пользователя. Например, для значения "/pics/pic.png" и браузера Mozilla 5.0 будут перебираться варианты "/pics/pic.png", "/pics/pic_mozilla.png", "/pics/pic_mozilla_5.png", "/pics/pic_mozilla_5_0.png". При $relative=true перебираются также различные варианты пути к файлу в папке текущего шаблона и папке /media. В противном случае метод будет искать файл JPATH_ROOT/<имя файла>для каждого варианта названия файла.

Например, следующий код

echo JHTML::_('image','req.png','Восклицательный знак', array('width'=>25,'height'=>25), true, false);

выведет

Если последним параметром указать true, то эта же строка выведет на экран

/joomla/templates/beez_20/images/req.png