padRight() : Pad String on Right

Pad a string on the right side to reach a specified length.

Signature

padRight(str, totalLength, padChar?)

Parameters

Returns

Type: String

The padded string.

Examples

Align Left in Fixed Width

<pre>
{{#each model.items}}
{{padRight(this.name, 20, ' ')}} ${{format(this.price, '0.00')}}
{{/each}}
</pre>

Data:

doc.Params["model"] = new {
    items = new[] {
        new { name = "Widget", price = 19.99m },
        new { name = "Gadget", price = 29.99m },
        new { name = "Tool", price = 9.99m }
    }
};

Output:

<pre>
Widget               $19.99
Gadget               $29.99
Tool                 $9.99
</pre>

Table-Like Formatting

<pre>
{{padRight('Name', 15, ' ')}} {{padRight('Status', 10, ' ')}} Price
{{#each model.products}}
{{padRight(this.name, 15, ' ')}} {{padRight(this.status, 10, ' ')}} ${{this.price}}
{{/each}}
</pre>

Data:

doc.Params["model"] = new {
    products = new[] {
        new { name = "Product A", status = "Active", price = "99.99" },
        new { name = "Product B", status = "Sold Out", price = "149.99" }
    }
};

Output:

<pre>
Name            Status     Price
Product A       Active     $99.99
Product B       Sold Out   $149.99
</pre>

Custom Padding Character

<p>{{padRight(model.label, 20, '.')}}</p>

Data:

doc.Params["model"] = new {
    label = "Total"
};

Output:

<p>Total...............</p>

Create Separators

<div>
  <span>{{model.title}}</span>
  <span>{{padRight('', 40, '-')}}</span>
</div>

Data:

doc.Params["model"] = new {
    title = "Section Header"
};

Output:

<div>
  <span>Section Header</span>
  <span>----------------------------------------</span>
</div>

Notes

• Pads on the right (adds characters after the string)
• If string is already longer than totalLength, returns unchanged
• Default padding character is space
• Pad character must be a single character
• Useful for formatting tables and aligning text
• For left padding, use padLeft()

See Also

• padLeft Function
• format Function
• concat Function