[BUGFIX] Use late static binding for compilable viewhelpers
[Packages/TYPO3.CMS.git] / typo3 / sysext / install / Classes / ViewHelpers / Format / CropViewHelper.php
1 <?php
2 namespace TYPO3\CMS\Install\ViewHelpers\Format;
3
4 /*
5 * This file is part of the TYPO3 CMS project.
6 *
7 * It is free software; you can redistribute it and/or modify it under
8 * the terms of the GNU General Public License, either version 2
9 * of the License, or any later version.
10 *
11 * For the full copyright and license information, please read the
12 * LICENSE.txt file that was distributed with this source code.
13 *
14 * The TYPO3 project - inspiring people to share!
15 */
16
17 use TYPO3\CMS\Fluid\Core\Rendering\RenderingContextInterface;
18 use TYPO3\CMS\Fluid\Core\ViewHelper\Facets\CompilableInterface;
19 use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractViewHelper;
20
21
22 /**
23 * Simplified crop view helper that does not need a frontend environment
24 *
25 * = Examples =
26 *
27 * <code title="Defaults">
28 * <f:format.crop maxCharacters="10">This is some very long text</f:format.crop>
29 * </code>
30 * <output>
31 * This is...
32 * </output>
33 *
34 * <code title="Inline notation">
35 * {someLongText -> f:format.crop(maxCharacters: 10)}
36 * </code>
37 * <output>
38 * someLongText cropped after 10 characters...
39 * (depending on the value of {someLongText})
40 * </output>
41 *
42 * @internal
43 */
44 class CropViewHelper extends AbstractViewHelper implements CompilableInterface {
45
46 /**
47 * Render the cropped text
48 *
49 * @param int $maxCharacters Place where to truncate the string
50 * @throws \TYPO3\CMS\Install\ViewHelpers\Exception
51 * @return string cropped text
52 */
53 public function render($maxCharacters) {
54 return static::renderStatic(
55 array(
56 'maxCharacters' => $maxCharacters,
57 ),
58 $this->buildRenderChildrenClosure(),
59 $this->renderingContext
60 );
61 }
62
63 /**
64 * @param array $arguments
65 * @param callable $renderChildrenClosure
66 * @param RenderingContextInterface $renderingContext
67 * @throws \TYPO3\CMS\Install\ViewHelpers\Exception
68 * @return string
69 */
70 static public function renderStatic(array $arguments, \Closure $renderChildrenClosure, RenderingContextInterface $renderingContext) {
71 $maxCharacters = $arguments['maxCharacters'];
72 if (empty($maxCharacters) || $maxCharacters < 1) {
73 throw new \TYPO3\CMS\Install\ViewHelpers\Exception(
74 'maxCharacters must be a positive integer',
75 1371410113
76 );
77 }
78 $stringToTruncate = $renderChildrenClosure();
79 return substr($stringToTruncate, 0, $maxCharacters);
80 }
81
82 }