Типографика
Библиотека Типографика содержит методы, которые помогают форматировать текст в семантически релевантных форматах.
Загрузка библиотеки
Как и все сервисы в CodeIgniter, она может быть загружена с помощью Config\Services, хотя обычно вам не нужно загружать её вручную:
$typography = \Config\Services::typography();
Доступные статические функции
Доступны следующие функции:
-
autoTypography($str[, $reduce_linebreaks = false]) Параметры: - $str (string) – Входная строка
- $reduce_linebreaks (bool) – Нужно ли сокращать несколько двойных переносов строк до двух
Возвращает: Строка с форматированной типографически-безопасной HTML-строкой
Тип возвращаемого значения: string
Форматирует текст так, чтобы он был семантически и типографически корректным HTML.
Пример использования:
$string = $typography->autoTypography($string);
Примечание
Типографическое форматирование может быть ресурсоёмким, особенно если у вас много контента для форматирования. Если вы решили использовать эту функцию, вы можете рассмотреть кеширование ваших страниц.
-
formatCharacters($str) Параметры: - $str (string) – Входная строка
Возвращает: Строка с отформатированными символами.
Тип возвращаемого значения: string
Эта функция в основном преобразует двойные и одинарные кавычки в сущности фигурных скобок, а также преобразует em-дефисы, двойные пробелы и амперсанды.
Пример использования:
$string = $typography->formatCharacters($string);
-
nl2brExceptPre($str) Параметры: - $str (string) – Входная строка
Возвращает: Строка с HTML-форматированными переносами строк
Тип возвращаемого значения: string
Преобразует новые строки в теги
<br />, за исключением случаев, когда они находятся внутри тегов<pre>. Эта функция идентична встроенной PHP-функцииnl2br(), за исключением того, что она игнорирует теги<pre>.Пример использования:
$string = $typography->nl2brExceptPre($string);
© 2014–2020 British Columbia Institute of Technology
Licensed under the MIT License.
https://codeigniter.com/user_guide/libraries/typography.html