Slim template engine for Go.
- Slim-compatible syntax — indentation-based HTML templating
- Expressions — arithmetic, comparison (
==,!=,<,>,<=,>=), logical (&&,||,!) - Conditionals —
if/elsif/else/unless - Iteration —
forloops over slices, arrays, and channels - Layouts —
content_for/yieldwithSetLayout, matching Ruby Slim conventions - Embedded filesystem —
ParseFSfor use withembed.FS - String interpolation —
Hello #{name} - Custom renderers — built-in
javascript:andcss:blocks, extensible viaRegisterRenderer - Whitespace control —
>(outer) and<(inner) - Wrapped attributes —
div(id="x" class="y") - Self-closing tags —
div/
doctype 5
html lang="ja"
head
meta charset="UTF-8"
title
body
ul
- for x in foo
li = xtmpl, err := slim.ParseFile("template.slim")
if err != nil {
log.Fatal(err)
}
err = tmpl.Execute(os.Stdout, slim.Values{
"foo": []string{"foo", "bar", "baz"},
})Output:
<!doctype html>
<html lang="ja">
<head>
<meta charset="UTF-8"/>
<title>
</title>
</head>
<body>
<ul>
<li>foo</li>
<li>bar</li>
<li>baz</li>
</ul>
</body>
</html>- if user.Role == "admin"
p Welcome, admin!
- elsif user.Role == "mod"
p Welcome, moderator!
- else
p Hello!
- unless hidden
p This is visibleDefine blocks in pages with content_for, render them in layouts with yield.
layout.slim:
doctype 5
html
head
title My App
body
= yield
= yield sidebarindex.slim:
h1 Hello
p Main content
- content_for sidebar
nav
a href="/" HomeGo code:
tmpl, _ := slim.ParseFile("index.slim")
tmpl.SetLayout("layout.slim")
tmpl.Execute(w, values)//go:embed templates/*
var templates embed.FS
tmpl, _ := slim.ParseFS(templates, "templates/index.slim")
tmpl.SetLayout("templates/layout.slim")
tmpl.Execute(w, values)/ Code comment (not rendered)
/! HTML comment
div#main.container
div(id="main" class="container")
img/
custom-element/
p> Removes outer whitespace
p< Removes inner whitespace
| Verbatim text
= expression (HTML escaped, wrapped in div)
== expression (raw output)
- code (control flow, no output)= name
= user.Name
= items[0]
= score + 10
= price * 1.1
= count > 0 && active
= !hidden
= greet("world")
= item.Method(arg)p Hello #{name}
a href="#{base_url}/path" Linkjavascript:
var x = 1;
css:
body { color: red; }Register custom renderers:
tmpl.RegisterRenderer("my-lang", func(out io.Writer, n *slim.Node, v *vm.VM) error {
fmt.Fprint(out, n.Text)
return nil
})| Function | Description |
|---|---|
trim(s) |
Trim whitespace |
to_upper(s) |
Convert to uppercase |
to_lower(s) |
Convert to lowercase |
repeat(s, n) |
Repeat string n times |
MIT
Yasuhiro Matsumoto (a.k.a. mattn)
