Encoding extensions
If you use Razor you have access to the full spectrum of C# methods - e.g. the String.StartsWith Method (String).
For the less powerful HTML-based template tag system, you can use a series of encoding extensions to format your data.
These are the encoding extensions available to you:
|
*.HtmlEncoded() |
HTML encodes the output. |
|
*.UrlEncoded() |
URL encodes the output. |
|
*.JSEncoded() |
Escapes ' and " in value. |
|
*.Raw() |
Does not encode if default htmlencoding is set to true). |
|
*.Length() |
Returns the length of the tag value. |
|
*.StripHtml() |
Removes the HTML. |
|
*.Remove(startIndex) |
Removes all characters from startIndex to end of string. Returns a string no longer than the passed integer, i.e: |
|
*.Remove(startIndex, count) |
Removes count characters from start index. |
|
*.Replace(oldValue, newValue) |
Replaces oldValue with newValue in the tag. |
|
*.ToLower() |
Converts to lower case. |
|
*.ToUpper() |
Converts to upper case. |
|
*.Contains(value) |
Returns True if tag value contains value. |
|
*.StartsWith(value) |
Returns True if tag value starts with value. |
|
*.EndsWith(value) |
Returns True if tag value end with value. |
|
*.Substring(startIndex) |
Returns substring starting at the startIndex position in the current string. |
|
*.Substring(startIndex, length) |
Returns substring with length characters starting from the startIndex position in the current string. |
|
*.Crop(length) |
Crops to length characters and appends … (three dots) |
|
*.Format(format) |
Formats tag value using String.Format(format, value) |
|
*.FormatDouble(format) |
Same as *.Format, but converts tag value to a double before formatting. |
|
*.FormatInteger(format) |
Same as *.Format, but converts tag value to an integer before formatting. |
|
*.FormatDate(format) |
Same as *.Format, but converts tag value to a date before formatting. |
|
*.IndexedValue() |
Gets an indexed value of the template tag. The value of the tag will be splittet on new lines or ; and will return first item 0, then 1 until N and restart the list. For SEO purposes to use different terms on the same button, i.e. instead of "Compare" 10 times, using "Compare product", "Compare item" etc. |
HTML encoding can be enabled by default in a template using this tag:
Use .Raw to get the unencoded value of the tag.
Please note, that it is not possible to use If tags on .HtmlEncoded and .UrlEncoded.