Spec-Zone.ru › CakePHP 2.9

Класс TextHelper

Библиотека для работы с текстом.

Обработка текста: выделение, извлечение фрагмента, обрезка, удаление ссылок, преобразование адресов электронной почты в ссылки mailto: ...

AppHelper
Extended by TextHelper
Пакет: Cake\View\Helper
Ссылка: http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html
См.: String
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/View/Helper/TextHelper.php

Краткое описание свойств

  • $_engine protected
    stdClass
    Экземпляр утилиты CakeText
  • $_placeholders protected
    array

    Массив md5 сумм и их содержимого. Используется при вставке ссылок в текст.

  • $helpers public
    array
    helpers

Краткое описание магических свойств

  • $Html public
    HtmlHelper

Краткое описание методов

  • __call() public
    Вызов методов из класса утилиты CakeText
  • __construct() public
    Конструктор
  • _insertPlaceHolder() protected

    Сохраняет заполнитель для строки, для последующего использования. Это позволяет избежать двойного экранирования содержимого в URL.

  • _linkEmails() protected
    Создаёт ссылки на адреса электронной почты
  • _linkUrls() protected
    Заменяет плейсхолдеры ссылками.
  • autoLink() public
    Преобразует все ссылки и адреса электронной почты в HTML-ссылки.
  • autoLinkEmails() public
    Добавляет ссылки на электронную почту (
    autoLinkUrls() public

    Добавляет ссылки (<a href=....) к заданному тексту, определяя текст, начинающийся со строк, таких как http:// и ftp://.

  • autoParagraph() public

    Форматирует абзацы вокруг заданного текста для всех символов перевода строки
    добавленных для одиночной строки возврата

    <

    p> добавлены для двойного перевода строки

  • excerpt() public

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

  • highlight() public

    Выделяет заданную фразу в тексте. Вы можете указать любое выражение в выделенном тексте, которое может включать выражение \1 для включения найденной фразы $phrase.

  • stripLinks() public
    Удаляет из заданного текста все ссылки (<a href=....)
  • tail() public
    Обрезает текст, начиная с конца.
  • toList() public
    Создаёт список, разделённый запятыми, где последние два элемента объединяются со словом «и», образуя естественный язык.
  • truncate() public
    Обрезает текст.

Подробное описание методов

__call()source public 

__call( string $method , array $params )

Вызов методов из класса утилиты CakeText

Параметры

строка $method
Метод для вызова.
массив $params
Параметры для передачи методу.

Возвращает

смешанный тип
Результат вызываемого метода или false при ошибке

__construct()source public 

__construct( View $View , array $settings array() )

Конструктор

Настройки:

  • engine Имя класса для замены функциональности CakeText. Класс должен быть размещён в директории Utility.

Параметры

View $View
объект представления, к которому прикреплён помощник.
массив $settings необязательно массив()
Массив настроек

Выбрасывает

CakeException
если класс движка не найден.

_insertPlaceHolder()source protected 

_insertPlaceHolder( array $matches )

Сохраняет заполнитель для строки, для последующего использования. Это позволяет избежать двойного экранирования содержимого в URL.

Параметры

массив $matches
Массив совпадений по регулярному выражению.

Возвращает

строка
Заменённые значения.

_linkEmails()source protected 

_linkEmails( string $text , array $options )

Создаёт ссылки на адреса электронной почты

Параметры

строка $text
Текст для обработки
массив $options
Массив опций для использования в HTML.

Возвращает

строка

См.

TextHelper::autoLinkEmails()

_linkUrls()source protected 

_linkUrls( string $text , array $htmlOptions )

Заменяет плейсхолдеры ссылками.

Параметры

строка $text
Текст для обработки.
массив $htmlOptions
Опции для сгенерированных ссылок.

Возвращает

строка
Текст со вставленными ссылками.

autoLink()source public 

autoLink( string $text , array $options array() )

Преобразует все ссылки и адреса электронной почты в HTML-ссылки.

Опции

  • escape Управление экранированием ввода HTML. По умолчанию true.

Параметры

строка $text
Текст
массив $options необязательно массив()
Массив HTML опций и опций, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::autoLink

autoLinkEmails()source public 

autoLinkEmails( string $text , array $options array() )

Добавляет ссылки на электронную почту (<a href="mailto:....) к заданному тексту.

Опции

  • escape Управление экранированием ввода HTML. По умолчанию true.

Параметры

строка $text
Текст
массив $options необязательно массив()
Массив HTML опций и опций, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::autoLinkEmails

autoLinkUrls()source public 

autoLinkUrls( string $text , array $options array() )

Добавляет ссылки (<a href=....) к заданному тексту, определяя текст, начинающийся со строк, таких как http:// и ftp://.

Опции

  • escape Управление экранированием ввода HTML. По умолчанию true.

Параметры

строка $text
Текст
массив $options необязательно массив()
Массив HTML опций и опций, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::autoLinkUrls
END_OF_DOCUMENT_MARKER

autoParagraph()source public 

autoParagraph( string $text )

Форматирует абзацы вокруг заданного текста для всех символов перевода строки
добавленных для одиночного возврата строки

<

p> добавлен для двойного возврата строки

Параметры

строка $text
Текст

Возвращает

строка

Текст с правильными

<

p> и
тегами


Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::autoParagraph

excerpt()source public 

excerpt( string $text , string $phrase , integer $radius 100 , string $ending '...' )

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

Параметры

строка $text
Строка, в которой будет выполняться поиск фразы
строка $phrase
Фраза, которая будет искаться
целое число $radius необязательно 100
Количество символов, которое будет возвращено с каждой стороны найденной фразы
строка $ending необязательно '...'
Заключительный символ, который будет добавлен

Возвращает

строка
Изменённая строка

См. также

CakeText::excerpt()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::excerpt

highlight()source public 

highlight( string $text , string $phrase , array $options array() )

Выделяет заданную фразу в тексте. Вы можете указать любое выражение в инструменте выделения, которое может включать выражение \1 для включения найденной фразы.

Параметры

строка $text
Текст, в котором будет выполняться поиск фразы
строка $phrase
Фраза, которая будет искаться
массив $options необязательно массив()
Массив HTML атрибутов и опций.

Возвращает

строка
Выделенный текст

См. также

CakeText::highlight()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::highlight

stripLinks()source public 

stripLinks( string $text )

Удаляет из заданного текста все ссылки (<a href=....)

Параметры

строка $text
Текст

Возвращает

строка
Текст без ссылок

См. также

CakeText::stripLinks()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::stripLinks

tail()source public 

tail( string $text , integer $length 100 , array $options array() )

Обрезает текст, начиная с конца.

Укорачивает строку до длины $length и заменяет первые символы многоточием, если текст длиннее, чем длина.

Параметры:

  • ellipsis Будет использоваться как начало и предварять обрезанную строку
  • exact Если ложь, $text не будет обрезан в середине слова

Параметры

строка $text
Строка для обрезки.
целое число $length необязательно 100
Длина возвращаемой строки, включая многоточие.
массив $options необязательно массив()
Массив HTML атрибутов и опций.

Возвращает

строка
Обрезанная строка.

См. также

CakeText::tail()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::tail

toList()source public 

toList( array $list , string $and null , string $separator ', ' )

Создаёт список, разделённый запятыми, где последние два элемента объединяются со словом 'и', образуя естественный язык.

Параметры

массив $list
Список для объединения.
строка $and необязательно null
Слово, используемое для объединения последнего и предпоследнего элементов. По умолчанию равно 'и'.
строка $separator необязательно ', '
Разделитель, используемый для объединения всех остальных элементов. По умолчанию равно ', '.

Возвращает

строка
Объединённая строка.

См. также

CakeText::toList()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::toList

truncate()source public 

truncate( string $text , integer $length 100 , array $options array() )

Обрезает текст.

Укорачивает строку до длины $length и заменяет последние символы многоточием, если текст длиннее, чем длина.

Параметры:

  • ellipsis Будет использоваться как окончание и добавляться к обрезанной строке (ending устарело)
  • exact Если ложь, $text не будет обрезан в середине слова
  • html Если истина, HTML теги будут обработаны корректно

Параметры

строка $text
Строка для обрезки.
целое число $length необязательно 100
Длина возвращаемой строки, включая многоточие.
массив $options необязательно массив()
Массив HTML атрибутов и опций.

Возвращает

строка
Обрезанная строка.

См. также

CakeText::truncate()

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/text.html#TextHelper::truncate

Подробное описание свойств

$_enginesource

защищённое stdClass

Экземпляр утилиты CakeText

$_placeholderssource

защищённое массив

Массив md5sum и их содержимого. Используется при вставке ссылок в текст.

array()

$helperssource

public массив

helpers

array('Html')

Подробное описание магических свойств

$Htmlsource

public HtmlHelper

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.9/class-TextHelper.html

Spec-Zone.ru

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