Source for file TemplateHelpers.php

Documentation is available at TemplateHelpers.php

1: <?php
2:
3: /**
4: * Nette Framework
5: *
6: * Copyright (c) 2004, 2009 David Grudl (http://davidgrudl.com)
7: *
8: * This source file is subject to the "Nette license" that is bundled
9: * with this package in the file license.txt.
10: *
11: * For more information please see https://nette.org
12: *
13: * @copyright Copyright (c) 2004, 2009 David Grudl
14: * @license https://nette.org/license Nette license
15: * @link https://nette.org
16: * @category Nette
17: * @package Nette\Templates
18: * @version $Id$
19: */
20:
21:
22:
23: /**
24: * Standard template helpers shipped with Nette Framework.
25: *
26: * @author David Grudl
27: * @copyright Copyright (c) 2004, 2009 David Grudl
28: * @package Nette\Templates
29: */
30: final class TemplateHelpers
31: {
32:
33: /**
34: * Static class - cannot be instantiated.
35: */
36: final public function __construct()
37: {
38: throw new LogicException("Cannot instantiate static class " . get_class($this));
39: }
40:
41:
42:
43: /**
44: * Try to load the requested helper.
45: * @param string helper name
46: * @return callback
47: */
48: public static function loader($helper)
49: {
50: $callback = 'Nette\Templates\TemplateHelpers::' . $helper;
51: fixCallback($callback);
52: if (is_callable($callback)) {
53: return $callback;
54: }
55: $callback = 'Nette\String::' . $helper;
56: fixCallback($callback);
57: if (is_callable($callback)) {
58: return $callback;
59: }
60: }
61:
62:
63:
64: /**
65: * Escapes string for use inside HTML template.
66: * @param mixed UTF-8 encoding or 8-bit
67: * @return string
68: */
69: public static function escapeHtml($s)
70: {
71: if (is_object($s) && ($s instanceof Template || $s instanceof Html || $s instanceof Form)) {
72: return (string) $s;
73: }
74: return htmlSpecialChars($s, ENT_QUOTES);
75: }
76:
77:
78:
79: /**
80: * Escapes string for use inside XML 1.0 template.
81: * @param string UTF-8 encoding or 8-bit
82: * @return string
83: */
84: public static function escapeXML($s)
85: {
86: // XML 1.0: \x09 \x0A \x0D and C1 allowed directly, C0 forbidden
87: // XML 1.1: \x00 forbidden directly and as a character reference, \x09 \x0A \x0D \x85 allowed directly, C0, C1 and \x7F allowed as character references
88: return htmlSpecialChars(preg_replace('#[\x00-\x08\x0B\x0C\x0E-\x1F]+#', '', $s), ENT_QUOTES);
89: }
90:
91:
92:
93: /**
94: * Escapes string for use inside CSS template.
95: * @param string UTF-8 encoding or 8-bit
96: * @return string
97: */
98: public static function escapeCss($s)
99: {
100: // http://www.w3.org/TR/2006/WD-CSS21-20060411/syndata.html#q6
101: return addcslashes($s, "\x00..\x2C./:;<=>?@[\\]^`{|}~");
102: }
103:
104:
105:
106: /**
107: * Escapes string for use inside HTML style attribute.
108: * @param string UTF-8 encoding or 8-bit
109: * @return string
110: */
111: public static function escapeHtmlCss($s)
112: {
113: return htmlSpecialChars(self::escapeCss($s), ENT_QUOTES);
114: }
115:
116:
117:
118: /**
119: * Escapes string for use inside JavaScript template.
120: * @param mixed UTF-8 encoding
121: * @return string
122: */
123: public static function escapeJs($s)
124: {
125: return json_encode($s);
126: }
127:
128:
129:
130: /**
131: * Escapes string for use inside HTML JavaScript attribute.
132: * @param mixed UTF-8 encoding
133: * @return string
134: */
135: public static function escapeHtmlJs($s)
136: {
137: return htmlSpecialChars(json_encode($s), ENT_QUOTES);
138: }
139:
140:
141:
142: /**
143: * Replaces all repeated white spaces with a single space.
144: * @param string UTF-8 encoding or 8-bit
145: * @return string
146: */
147: public static function strip($s)
148: {
149: return trim(preg_replace('#\\s+#', ' ', $s));
150: }
151:
152:
153:
154: /**
155: * Indents the HTML content from the left.
156: * @param string UTF-8 encoding or 8-bit
157: * @param int
158: * @param string
159: * @return string
160: */
161: public static function indent($s, $level = 1, $chars = "\t")
162: {
163: if ($level >= 1) {
164: $s = preg_replace_callback('#<(textarea|pre).*?</\\1#si', array(__CLASS__, 'indentCb'), $s);
165: $s = String::indent($s, $level, $chars);
166: $s = strtr($s, "\x1D\x1A", "\r\n");
167: }
168: return $s;
169: }
170:
171:
172:
173: /**
174: * Callback for self::indent
175: */
176: private static function indentCb($m)
177: {
178: return strtr($m[0], "\r\n", "\x1D\x1A");
179: }
180:
181:
182:
183: /**
184: * Date/time formatting.
185: * @param string|int|DateTime
186: * @param string
187: * @return string
188: */
189: public static function date($value, $format = "%x")
190: {
191: $value = is_numeric($value) ? (int) $value : ($value instanceof DateTime ? $value->format('U') : strtotime($value));
192: return strftime($format, $value);
193: }
194:
195:
196:
197: /**
198: * Converts to human readable file size.
199: * @param int
200: * @return string
201: */
202: public static function bytes($bytes)
203: {
204: $bytes = (int) $bytes;
205: $units = array('B', 'kB', 'MB', 'GB', 'TB', 'PB');
206: foreach ($units as $unit) {
207: if (abs($bytes) < 1024) break;
208: $bytes = $bytes / 1024;
209: }
210: return round($bytes, 2) . ' ' . $unit;
211: }
212:
213: }

Source for file TemplateHelpers.php

Namespaces