Spec-Zone.ru › CodeIgniter 4

Типографика

Библиотека Типографика содержит методы, которые помогают форматировать текст в семантически релевантных форматах.

  • Загрузка библиотеки
  • Доступные статические функции

Загрузка библиотеки

Как и все сервисы в 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API