Scryber Data Binding Reference

On this page

Overview
Handlebars Helpers
Binding Operators
Expression Functions
Special Variables
Common Patterns
Additional Resources
Custom Functions and Operators

Overview

This reference covers all data binding features available in Scryber templates, including Handlebars helpers, operators, and expression functions.

6 Handlebars Helpers - Block-level control structures
15+ Operators - Mathematical, logical, and comparison operators
90+ Functions - Organized into 8 categories
Special Variables - Context-aware variables like @index, this, ..

Handlebars Helpers

Block-level helpers for control flow and iteration in templates.

Helper	Syntax	Description
each	`...`	Iterate over arrays or collections. Access items with ``
with	`...`	Change data context to a specific object
if	`...`	Conditional rendering based on expression
else if	``	Additional condition in an if block
else	``	Fallback when conditions aren’t met
log	``	Output debug messages to trace log

→ Detailed Handlebars Helpers Documentation

Binding Operators

Operators used within `` bindings.

Mathematical Operators

Operator	Example	Description
`+`	``	Addition
`-`	``	Subtraction
`*`	``	Multiplication
`/`	``	Division
`%`	``	Modulus (remainder)
`^`	``	Power (exponentiation)

Comparison Operators

Operator	Example	Description
`==`	``	Equality
`!=`	``	Inequality
`<`	``	Less than
`<=`	``	Less than or equal
`>`	``	Greater than
`>=`	``	Greater than or equal

Logical Operators

Operator	Example	Description
`&&`	``	Logical AND
`\|\|`	``	Logical OR
`!`	``	Logical NOT

Other Operators

Operator	Example	Description
`??`	``	Null coalescing - returns b if a is null
`.`	``	Property access
`[]`	``	Array/indexer access
`..`	``	Navigate to parent context
`this`	``	Current context reference

→ Detailed Operators Documentation

Expression Functions

Built-in functions available in `` bindings.

Conversion Functions

Function	Signature	Description
string	`string(value, format?)`	Convert to string with optional formatting
int	`int(value)`	Convert to 32-bit integer
integer	`integer(value)`	Alias for int()
long	`long(value)`	Convert to 64-bit integer
double	`double(value)`	Convert to double-precision float
decimal	`decimal(value)`	Convert to decimal number
bool	`bool(value)`	Convert to boolean
date	`date(value)`	Convert to DateTime
typeof	`typeof(value)`	Get type name as string

→ Conversion Functions Details

String Functions

Function	Signature	Description
concat	`concat(str1, str2, ...)`	Concatenate multiple strings
join	`join(separator, array)`	Join array elements with separator
substring	`substring(str, start, length?)`	Extract portion of string
replace	`replace(str, find, replace)`	Replace text in string
toLower	`toLower(str)`	Convert to lowercase
toUpper	`toUpper(str)`	Convert to uppercase
trim	`trim(str)`	Remove whitespace from both ends
trimEnd	`trimEnd(str)`	Remove trailing whitespace
length	`length(str)`	Get string length
contains	`contains(str, search)`	Check if string contains text
startsWith	`startsWith(str, prefix)`	Check if starts with prefix
endsWith	`endsWith(str, suffix)`	Check if ends with suffix
indexOf	`indexOf(str, search)`	Find position of substring
padLeft	`padLeft(str, length, char)`	Pad string on left
padRight	`padRight(str, length, char)`	Pad string on right
split	`split(str, separator)`	Split string into array
regexIsMatch	`regexIsMatch(str, pattern)`	Test if matches regex
regexMatches	`regexMatches(str, pattern)`	Get all regex matches
regexSwap	`regexSwap(str, pattern, replacement)`	Replace using regex

→ String Functions Details

Mathematical Functions

Function	Signature	Description
abs	`abs(value)`	Absolute value
ceiling	`ceiling(value)`	Round up to nearest integer
floor	`floor(value)`	Round down to nearest integer
round	`round(value, decimals?)`	Round to nearest value
truncate	`truncate(value)`	Remove decimal portion
sqrt	`sqrt(value)`	Square root
pow	`pow(base, exponent)`	Raise to power
exp	`exp(value)`	e raised to power (e^value)
log	`log(value)`	Natural logarithm (base e)
log10	`log10(value)`	Base-10 logarithm
sign	`sign(value)`	Returns -1, 0, or 1
sin	`sin(angle)`	Sine (angle in radians)
cos	`cos(angle)`	Cosine (angle in radians)
tan	`tan(angle)`	Tangent (angle in radians)
asin	`asin(value)`	Arcsine
acos	`acos(value)`	Arccosine
atan	`atan(value)`	Arctangent
degrees	`degrees(radians)`	Convert radians to degrees
radians	`radians(degrees)`	Convert degrees to radians
pi	`pi()`	Pi constant (3.14159…)
e	`e()`	Euler’s number (2.71828…)
random	`random()`	Random value between 0 and 1

→ Mathematical Functions Details

Date & Time Functions

Function	Signature	Description
addDays	`addDays(date, days)`	Add days to date
addMonths	`addMonths(date, months)`	Add months to date
addYears	`addYears(date, years)`	Add years to date
addHours	`addHours(date, hours)`	Add hours to date
addMinutes	`addMinutes(date, minutes)`	Add minutes to date
addSeconds	`addSeconds(date, seconds)`	Add seconds to date
addMilliseconds	`addMilliseconds(date, ms)`	Add milliseconds to date
daysBetween	`daysBetween(date1, date2)`	Calculate days between dates
hoursBetween	`hoursBetween(date1, date2)`	Calculate hours between dates
minutesBetween	`minutesBetween(date1, date2)`	Calculate minutes between dates
secondsBetween	`secondsBetween(date1, date2)`	Calculate seconds between dates
yearOf	`yearOf(date)`	Extract year
monthOfYear	`monthOfYear(date)`	Extract month (1-12)
dayOfMonth	`dayOfMonth(date)`	Extract day of month
dayOfWeek	`dayOfWeek(date)`	Extract day of week
dayOfYear	`dayOfYear(date)`	Extract day of year (1-365)
hourOf	`hourOf(date)`	Extract hour (0-23)
minuteOf	`minuteOf(date)`	Extract minute (0-59)
secondOf	`secondOf(date)`	Extract second (0-59)
millisecondOf	`millisecondOf(date)`	Extract millisecond (0-999)

→ Date & Time Functions Details

Logical Functions

Function	Signature	Description
if	`if(condition, trueValue, falseValue)`	Ternary conditional operator
ifError	`ifError(expression, errorValue)`	Return errorValue if expression throws
in	`in(value, item1, item2, ...)`	Check if value exists in list

→ Logical Functions Details

Collection Functions

Function	Signature	Description
count	`count(array)`	Count elements in array
countOf	`countOf(array)`	Alias for count()
sum	`sum(array)`	Sum numeric array
sumOf	`sumOf(array, 'property')`	Sum property values
min	`min(array)`	Find minimum value
minOf	`minOf(array, 'property')`	Find minimum property value
max	`max(array)`	Find maximum value
maxOf	`maxOf(array, 'property')`	Find maximum property value
collect	`collect(expression, array)`	Map expression over array
each	`each(array)`	Iterate over array (returns array)
eachOf	`eachOf(array, 'property')`	Extract property from each element
firstWhere	`firstWhere(array, condition)`	Find first matching element
selectWhere	`selectWhere(array, condition)`	Filter array by condition
sortBy	`sortBy(array, 'property')`	Sort array by property
reverse	`reverse(array)`	Reverse array order

→ Collection Functions Details

Statistical Functions

Function	Signature	Description
average	`average(array)`	Calculate mean of array
averageOf	`averageOf(array, 'property')`	Calculate mean of property values
mean	`mean(array)`	Alias for average()
median	`median(array)`	Find middle value
mode	`mode(array)`	Find most common value

→ Statistical Functions Details

CSS Functions

Function	Signature	Description
calc	`calc(expression)`	CSS calculation (legacy - use operators instead)
var	`var(variableName)`	Get CSS variable value

→ CSS Functions Details

Special Variables

Variables available in specific contexts:

Variable	Context	Description
`@index`	`` loops	Zero-based index of current item
`@first`	`` loops	True if first item
`@last`	`` loops	True if last item
`this`	Any context	Reference to current data context
`.`	Any context	Shorthand for current context
`..`	Nested contexts	Reference to parent context
`model`	Root	Root data model (from `doc.Params["model"]`)

Common Patterns

Formatting Values

<!-- Currency -->

<!-- Date -->

<!-- Number with thousands separator -->

<!-- Percentage -->

Conditional Classes

<div class="">

Complex Expressions

<!-- Calculate percentage -->
%

<!-- Conditional with multiple criteria -->

  <span class="excellent">Excellent</span>

Working with Collections

<!-- Total -->
Total: 

<!-- Count -->
Items: 

<!-- Average -->
Average: 

Additional Resources

Custom Functions and Operators

Scryber allows registering custom functions and operators:

// Register custom function
BindingCalcExpressionFactory.RegisterFunction(new MyCustomFunction());

// Register custom operator
BindingCalcExpressionFactory.RegisterOperator(new MyCustomOperator());

For more information on extending the binding system, see the Extending Data Binding documentation.