Skip to main content
Version: v3

Literals

String​

You can use string literals and concatenate them with other strings. You can use double or single quotes for strings. Here is an example of using string literals:

{{ "Hello" + 'World!' }}

When you print a string, it will be automatically escaped. If you want to print a string without escaping it, you can use the raw() function on strings. Example: {{ "<h1>Test</h1>".raw() }}

Integer​

You can use integer literals and perform arithmetic operations with them. Here is an example of using integer literals:

<span>{{ 1 + 2 }}</span>

Nil​

You can use nil literal to check if a variable is nil. Here is an example of using nil literal:

@if(nil)
    <p>It will not be displayed</p>
@end

Float​

You can use float literals and perform arithmetic operations with them. Here is an example of using float literals:

<span>{{ 1.534 + 2.5 }}</span>
Precision limit

Most languages (including Textwire) use IEEE 754 standard for floating-point numbers. These floating-point types have a finite precision and are unable to accurately represent more than approximately 15-17 digits. For example 1234567890.1234567890 will be rounded to 1234567890.1234567 in Textwire because of the precision limit of floating-point numbers. If you need to work with large numbers, you can keep them as strings.

Boolean​

You can use boolean literals to check if a variable is true or false. Here is an example of using boolean literals:

@if(true)
    <p>Is tall</p>
@end

Array​

Defining an array in Textwire is done is a similar way as in other languages. Here is an example of defining an array:

{{ names = ["John", "Jane", "Jack"] }}

<ul>
    @each(name in names)
        <li>{{ name }}</li>
    @end
</ul>

You can access values in an array by using an index. Here is an example of accessing values in an array:

{{ names = ["John", "Jane", "Jack"] }}

<ul>
    <li>{{ names[0] }}</li> {{-- John --}}
    <li>{{ names[1] }}</li> {{-- Jane --}}
    <li>{{ names[2] }}</li> {{-- Jack --}}
    <li>{{ names[10] }}</li> {{-- nil --}}
</ul>
info

Accessing array on non-existant index returns nil instead of resulting in error.

Best Practices​

Always check array access with index for nil before using it to prevent using functions on nil errors. Here are 2 ways of performing this check:

If Statement​

{{ names = [] }}

@if(names[0] != nil)
    {{ names[0].upper() }}
@end

Ternary Expression​

{{ names = [] }}

{{ names[0] == nil ? '' : names[0].upper() }}

Object​

Objects in Textwire are very similar to JavaScript object with key-value pairs. Here is an example of defining an object:

{{ person = {"name": "John", "age": 25} }}

You can also use key names without quotes if your keys are valid identifiers:

{{ person = { name: "John", age: 25 } }}

You can access values in an object by using a key. Here is an example of accessing values in an object:

{{ user = {age: 25, name: {first: "Anna", last: "Cho"}} }}

<ul>
    <li>First name: {{ user.name.first }}</li> {{-- "Anna" --}}
    <li>Last name: {{ user.name.last }}</li> {{-- "Cho" --}}
    <li>Age: {{ user.age }}</li> {{-- 25 --}}
</ul>
First Character is Case-Insensitive

First character case-insensitivity in field access. Field name matching ignores case differences in the first character. This means {{ user.name.first }} and {{ user.Name.First }} resolve to the same result.

important

Textwire automatically converts Go structs to objects, but only exported fields are converted. Since Go doesn't export fields that start with lowercase letters, Textwire cannot access them. Make sure to capitalize field names if you want them available in your templates.

Shorthand property notation​

Similar to objects in JavaScript, you can use shorthand property notation to define an object. Here is an example of using shorthand property notation:

{{ name = "John"; age = 25 }}
{{ person = { name, age } }}