Заметки
Как вывести многострочный текст в генераторе документов
Как передавать многострочный текст в шаблон документа: переносы строк, HTML, pre-wrap и ограничения Word-шаблона.
Многострочный текст лучше передавать как обычный текст с переносами строк и заранее готовить место в Word-шаблоне. Для повторяющихся пунктов часто надёжнее таблица, а не одно большое поле.
Задача
В шаблон документа нужно вывести комментарий, описание, список работ или другой текст с переносами строк. В карточке CRM текст выглядит многострочным, а в документе может стать одной строкой или потерять форматирование.
Обычный текст
Если поле подставляется как обычный текст, генератор заменяет плейсхолдер значением. Но то, как будут выглядеть переносы, зависит от самого Word-шаблона и типа данных.
Лучше не смешивать в одном поле HTML, Markdown и обычный текст. Если источник — обычное многострочное поле, передавайте обычные переносы строк.
HTML и стили
HTML-разметка не всегда должна восприниматься как HTML. Если в поле лежит <br>, оно может попасть в документ как текст. Для сложного форматирования лучше готовить шаблон под конкретный способ вывода, а не надеяться, что генератор сам разберёт произвольный HTML.
Шаблон Word
В Word-шаблоне важно оставить плейсхолдер в отдельном месте, где допускается многострочный текст. Если плейсхолдер стоит внутри плотной таблицы или строки с жёсткой высотой, переносы могут визуально обрезаться.
Для списков работ часто надёжнее не выводить всё одним многострочным полем, а формировать таблицу: одна строка — один элемент.