Text


Назначение

Вывод блока текста при выполнении определенного условия, или вывод другого блока в противном случае (если задан "противоположный" вариант).

Ключи

source Строка, которая будет выведена. Может содержать HTML тэги, другие макроподстановки и т.п. Крайние кавычки будут обрезаны.

Данный ключ рекомендуется заключать в кавычки всегда, а не только когда строка содержит переводы строк.

" и ; в тексте Система автоматически попробует отличить от служебных. Для особых случаев (блоки javascript) предусмотрен синтаксис "квотирования" этих символов через \" и \;. Также, для целей квотирования javascript рекомендуется использование сервиса $QuoteText[]$.

condition Составное условие выполнения макроса.
antisource Строка, которая будет выведена если condition задан и его значением является логическая "ложь", то есть используется как противоположное ключу source значение.

Комментарии

Как правило, используется для реализации условного вывода блока текста на странице. Это одна из основных и часто используемых подстановок. По сути ничто иное как

if (не задан или задан но истинен "condition") then print "source" else print "antisource"

Примеры

Пример №1
$Text[source: "$Content$"; condition: $Equal[left: "$UserProfile[field: "position"; userset: "table"]$"; right: "директор"]$]$ - выведет содержимое основной контентной зоны только при условии, если значение поля position в профиле авторизованного пользователя равно "директор".

Внимание!
Если значение ключа source не заключить в кавычки - то есть сделать вот так $Text[source: $Content$]$ а не так $Text[source: "$Content$"]$, то если в $Content$ будет блок с переносами строк (символы CRLF для Windows или CR для UNIX) в результирующий HTML код он будет выведена без них (в одну строку).