s_list_class()

s_list_class ( int $sub, int $cc, [char $params, [bool $show_in_admin_mode]] )

функция выводит «верхние» объекты из раздела $sub, компонента раздела $cc с параметрами $params

Аргументы

$sub
номер раздела
$current (опционально)
номер компонента в разделе
$params (опционально)
может содержать произвольный состав параметров. Все они могут быть обработаны в тексте шаблона вывода объекта. Параметры подаются в URL-формате: &param1=12&param2=46.
$show_in_admin_mode (опционально)
если он имеет значение TRUE (истина), этот блок будет выведен и в режиме администрирования, иначе только в обычном режиме работы сайта

Пример использования

В макете дизайна титульной страницы необходимо вывести список последних трех новостей, но без листинга и в укороченном формате. Номер раздела новостей 1, номер компонента раздела новостей – 2.

Фрагмент хедера/футера макета:

<?= s_list_class(1, 2, "recNum=3&isTitle=1") ?>

Необходимо обратить внимание, что название isTitle выбрано произвольно. Этот параметр будет «виден» в тексте шаблона вывода.

Например, он может быть использован для того чтобы не выводить листинг по страницам компонента. Для этого обратимся к нему в суффиксе списка вывода объектов компонента «Новости»:

<?= (!$isTitle ? browse_messages($cc_env, 10) : null) ?>

А в списке объектов компонента помимо «полного» (обычного) вида списка новостей укажем укороченный:

<?= ($isTitle?"<a href='".$fullLink."'>".$f_Title."</a> (".$f_Created.")<br>":"<a href='".$fullLink."'>".$f_Title."</a> (".$f_Created.")<br>".$f_Anons."<p>") ?>

См. также

nc_objects_list() — выводит данные из другого инфоблока

Комментарии 5

ipm Ильин Павел 08 июля 2014, 11:14:15

$sub является обязательным параметром или нет?

amigo 09 июля 2014, 09:34:25

да

ipm Ильин Павел 09 июля 2014, 10:02:58

Ну смотрите:

Я делал один компонент...
Мне нужно было, чтобы в s_list_class можно было вручную указывать, из какого раздела и компонента брать данные.

Т.е. вместо $sub и $cc были необходимые поля.
Так вот, если не указан раздел (поле не заполнено), то всё-равно данные успешно отображались из указанного инфоблока ($cc). Получается, что если вызывать функцию s_list_class из компонента, то раздел указывать необязательно. Я если честно удивился, что так работает. Проверил ещё несколько раз..попробовал вывести данные из другого инфоблока, не указывая при этом номер раздела... в итоге всё успешно.

Дмитрий Коновалов Activica 10 июля 2017, 16:08:54

Чем эта функция отличается от nc_objects_list ?

Литвиненко Владислав 10 декабря 2017, 00:39:16

ничем

Наверх