Шрифт:
$name - название элемента <select>; $extension - расширение, к которому относятся категории; $selected - выбранное по умолчанию значение; $javascript - дополнительный код Javascript, который будет выведен внутри тега <select>; $size - высота списка (значение атрибута size тега <select>); $sel_cat - при null строки " Выберите категорию" в списке не будет.
Пример:
echo JHTML::_('list.category', 'catlist', 'com_content', 2, 'onclick="someFunc"', 'id', 1, 1);
Данный код выведет на экран список, представленный на рис. 3.7.
Рис. 3.7. Список для выбора категории
JHTMLMenu
Класс используется для отображения элементов меню и не представляет интереса для использования в расширениях.
JHTMLSelect
Класс JHTMLSelect используется для генерации кода списков.
Выпадающий список
string genericlist(array $data, string $name, mixed $attribs = null, string $optKey = 'value', string $optText = 'text', mixed $selected = null, mixed $idtag = false, bool $translate = false)
где
$data - массив данных для отображения. Каждый элемент может быть сгенерирован с помощью метода JHTMLSelect.option или другим образом; $name - имя элемента HTML; $attribs - дополнительные атрибуты тега <select>. Могут быть заданы как массив атрибутов или массив опций с ключами list.attr, id, list.select и др.; $optKey - из какого поля объекта, представляющего собой элемент массива $data, брать значение элементов <option>. При $optkey = null будут использованы ключи массива; $optText - из какого поля объекта, представляющего собой элемент массива $data, брать текст элементов <option>. Тег <option> формируется так: <option value="$optkey">$optText</option>; $selected - значение выбранного по умолчанию элемента; $idtag - id тега <select>; $translate - пропускать ли текст через функцию JText::_.
Пример:
$query = 'SELECT id,title FROM #__content'; $db =& JFactory::getDBO; $db->setQuery($query); $content = $db->loadObjectList; echo JHTML::_('select.genericlist', $content, 'genlist', 'size='.count($content), 'id', 'title', 2);
Так как мы передали в функцию genericlist $selected=2, то в сгенерированном списке по умолчанию выделен элемент с id, равным 2 (рис. 3.8).
Рис. 3.8. Список для выбора материала
Объект, представляющий элемент <option> выпадающего списка
object option(string $value, string $text = '', mixed $optKey = 'value', string $optText = 'text', bool $disable = false)
где
$value - значение элемента <option>; $text - текст элемента; $optKey - если это строка, то имя того поля возвращаемого объекта, в котором будет храниться значение элемента <option>. Если массив, то это параметры. Возможные ключи массива: attr, disable, label, option.attr, option.disable, option.key, option.label, option.text; $optText - имя того поля возвращаемого объекта, в котором будет храниться текст элемента <option>; $disable - добавлять ли к тегу атрибут disable.
Рассмотрим пример:
$query = 'SELECT id,title FROM #__content'; $db =& JFactory::getDBO; $db->setQuery($query); $content = $db->loadObjectList; foreach ($content as $c) $data[] = JHTML::_('select.option', $c->id, $c->title, 'my_value', 'my_text'); echo JHTML::_('select.genericlist', $data, 'genlist', 'size='.count($data), 'my_value', 'my_text', 2);
В данном примере для каждого материала сайта с помощью метода JHTMLSelect.option создается объект, представляющий элемент <option>:
JObject Object ([_errors:protected]=>Array [my_value]=>1 [my_text]=>Материал #1 [disable]=>)
Таким образом, значения $optKey и $optText, переданные в функцию option, стали названиями полей получившегося объекта, а значения $c->id и $c->title - значениями этих полей. Теперь в функцию JHTMLSelect.genericlist необходимо передать те же названия полей, что и в option. Если не передать их, то функция genericlist будет по умолчанию искать в объектах массива $data поля $value и $text, которых там нет.
Результат работы данного примера будет выглядеть так же, как и результат предыдущего.
Список целых чисел
string integerlist(int $start, int $end, int $inc, string $name, mixed $attribs = null, mixed $selected = null, string $format = '')
где
$start - первое число последовательности; $end - последнее число последовательности; $inc - шаг; $name - имя тега; $attribs - массив атрибутов тега; $selected - значение выбранного по умолчанию элемента; $format - формат вывода числа для функции printf.