Attention

TYPO3 v9 has reached its end-of-life September 30th, 2021 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.

format.crop

Use this ViewHelper to crop the text between its opening and closing tags.

Examples

Defaults

<f:format.crop maxCharacters="10">
    This is some very long text
</f:format.crop>

This is

Custom suffix

<f:format.crop maxCharacters="17" append="&nbsp;[more]">
    This is some very long text
</f:format.crop>

This is some&nbsp;[more]

Don't respect word boundaries

<f:format.crop maxCharacters="10" respectWordBoundaries="false">
    This is some very long text
</f:format.crop>

This is so

Don't respect HTML tags

<f:format.crop maxCharacters="28" respectWordBoundaries="false" respectHtml="false">
    This is some text with <strong>HTML</strong> tags
</f:format.crop>

This is some text with <stro

Inline notation

{someLongText -> f:format.crop(maxCharacters: 10)}

someLongText cropped after 10 characters Depending on the value of {someLongText}.

Arguments

maxCharacters

DataType

mixed

Required

false

Description

Place where to truncate the string

append

DataType

string

Default

'&hellip;'

Required

false

Description

What to append, if truncation happened

respectWordBoundaries

DataType

mixed

Default

true

Required

false

Description

If TRUE and division is in the middle of a word, the remains of that word is removed.

respectHtml

DataType

mixed

Default

true

Required

false

Description

If TRUE the cropped string will respect HTML tags and entities. Technically that means, that cropHTML() is called rather than crop()