Data templates transform the data model into text or HTML content. Templates are used in many areas in emakin like form controls or mail templates etc.
...
| Template | Outputs | Culture | ||
|---|---|---|---|---|
| {{ 12345678912345 }} | 12345678912345 | |||
| {{ 123456.78912345 }} | 123456.78912345 | |||
| {{ number(123456.78912345678912345) }} | 123456.789123457 | |||
| {{ format( number(123456.789) ) }} | 123456.789 | |||
| {{ format( number(123456789) ) }} | 123456789 | |||
| {{ format( number(123456789), 'n') }} | 123,456,789.00 | |||
| {{ format( number(123456789), 'n') }} | 123.456.789,00 | tr-TR | ||
| {{ format( number(123456789), 'n0') }} | 123,456,789 | |||
| {{ format(number(123456789), 'c') }} | 123.456.789,00 ₺ | tr-TR | {{ format(123.456.789, 'string') }} | 123456789 |
Date formatting
Template system automatically detects the xml date types formatted with "YYYY-MM-DD-THH:MM:SSTZ". Emakin always uses this format in data model for date values.
...
| Template | Outputs | Culture | ||||
|---|---|---|---|---|---|---|
| {{ MyDate }} | 01/31/2014 16:04:12 +02:00 | |||||
| {{ format(MyDate,'MMM/yyyy/dd') }} | Feb.2018.04 | |||||
| {{ format(MyDate,'MMM/yyyy/dd') }} | Şub.2018.04 | tr-TR | ||||
| /MM/yyyy') }} | Nisan 2021 | tr-TR | {{ format(MyDate) }} | 31/01/2014 | 09:00||
| {{ format(MyDate) }} | 31.1.2014 09:00 | tr-TR | ||||
| {{ format(MyDate,'d') }} | 31/01/2014 | |||||
| {{ format(MyDate,'D') }} | Monday, June 15, 2009 | en-US | ||||
| {{ format(MyDate,'o') }} | 2014-01-31T09:00:00+02:00 |
...
| Code Block |
|---|
$Xml.SetValue('Test/testdate', new DateTimeOffset()); // testdate will be saved to an XML as "2015-11-12T15:27:16.2568549+02:00"
$Xml.SetValue('Test/testdate2', $Xml.Format("{{ format(Test/testdate,'yyyy-MM-dd') }}")); // testdate2 will be saved to an XML as "2015-12-11"
// result : 2015-12-11 |
Text Masking
Template system also provides an mask function to filter displayed text on screen. This function can used to filter out personal data like name, credit card, identity number etc. More details can be found at mask function reference.
| Code Block |
|---|
{{ mask(DisplayName) }} -> J*****D
{{ mask(CreditCard,4,4,'','-') }} -> 1234-****-****-3456 |
Format Function Options
| Data Type | Format Option | Description | Sample Data | Output |
|---|---|---|---|---|
| String | Print string as automatically detection | <script>alert('hello')</script><div>hello</div> | <div>hello</div> | |
| String | Print string as automatically detection | 12.345 | 12.3 | |
| String | Print string as automatically detection | 12 | 12 | |
| String | Print string as automatically detection | 2022-05-07T00:00:00+03:00 | 07.05.2022 00:00 | |
| String | Print string as automatically detection | True / true | ✓ (U+2713) | |
| String | Print string as automatically detection | False / false | ✕ (U+2715) | |
| String | html | Print string as encoded html text | <script>alert('hello')</script><div>hello</div> | "<script>alert('hello')</script><div>hello</div>" |
| String | safe | Print value as safe html with discarding dangerous tags | <script>alert('hello')</script><div>hello</div> | <div>hello</div> |
| String | string | Print string without any encoding applied | <script>alert('hello')</script><div>hello</div> | <script>alert('hello')</script><div>hello</div> |
| Number | n0 | Print number as integer without any decimal | 12.345 | 12 |
| Number | n1 | Print number as decimal with 1 number after dot | 12.345 | 12.3 |
| Boolean | Print value as unicode check mark | True / true | ✓ (U+2713) | |
| Boolean | Print value as unicode check mark | False / false | ✕ (U+2715) | |
| DateTime | Print date value in user's locale preference | 2022-05-07T00:00:00+03:00 | 07.05.2022 00:00 | |
| DateTime | o | Print date in ISO format | 2022-05-07T00:00:00+03:00 | 2022-05-07T00:00:00+03:00 |
| DateTime | m | Print date in dynamic formatted format | 2022-05-07T00:00:00+03:00 | 2 days ago |
| DateTime | dd/MM/yyyy | Print date in specified date format | 2022-05-07T00:00:00+03:00 | 07/05/2022 |
Conditional Formatting
If conditional rendering is needed, the format below can be used:
...