Getting Started
Request handling
- Routing
- Action Controller
- Resources
- Context
- Request Binding
- Middleware
- Error Handling
- Sessions
- Cookies
Frontend
Database
- Getting started with Pop
- Soda CLI
- Database Configuration
- Buffalo Integration
- Models
- Generators
- Migrations
- Fizz
- Mutations
- Querying
- Raw Queries
- Callbacks
- Scoping
- Associations and Relationships
- One to one associations
- One to many associations
Guides
- API Applications
- File Uploads
- Background Job Workers
- Mailers
- Tasks
- Plugins
- Local Authentication
- Third Party Authentication
- Events
- Go Modules
- Localization
- Logging
- Template Engines
- Testing
- Videos
Deploy
Partials
Frontend
Partials#
This document only applies when using https://github.com/gobuffalo/buffalo/tree/main/render.
Please see github.com/gobuffalo/plush for more details on the underlying templating package.
Usage#
You can call your partials using partial plush helper:
templates/users/form.plush.html
templates/users/new.plush.html
Output
<form action="/users/" method="POST">
<!-- form content here -->
<form>
<h1>Create New User</h1>
<%= partial("users/form.html") %>
<h1>Create New User</h1>
<form action="/users/" method="POST">
<!-- form content here -->
<form>
Context#
All rendering context from the parent template will automatically pass through to the partial, and any partials that partial may call. (see also Context)
actions/users.go
templates/users/edit.plush.html
templates/users/form.plush.html
Output
func UsersEdit(c buffalo.Context) error {
user := User{
Name: "John Smith",
}
// ...
c.Set("user", user)
return c.Render(http.StatusOK, render.HTML("users/edit.plush.html"))
}
<h1>User to edit: <strong><%= user.Name %></strong></h1>
<%= partial("users/form.plush.html") %>
<form action="/users/<%= user.ID %>/">
<!-- form content here -->
</form>
<h1>User to edit: <strong>John Smith</strong></h1>
<form action="/users/<%= user.ID %>/">
<!-- form content here -->
</form>
Local Context#
In addition to have the global context, you can set additional variable only for partials as “local” variables.
actions/colors.go
templates/colors/index.plush.html
templates/colors/details.plush.html
Output
func ColorsHandler(c buffalo.Context) error {
colors := map[string]interface{}{
"White": "#FFFFFF",
"Maroon": "#800000",
"Red": "#FF0000",
"Purple": "#800080",
}
c.Set("colors", colors)
return c.Render(http.StatusOK, r.HTML("colors/index.plush.html"))
}
<div class="list">
<%= for (name, code) in colors { %>
<%= partial("colors/details.plush.html", {colorName: name, hexCode: code}) %>
<% } %>
</div>
<div>
<span>Color: <%= colorName %></span>
<span>Hex Code: <strong><%= hexCode %></strong></span>
</div>
<div class="list">
<div>
<span>Color: White</span>
<span>Hex Code: <strong>#FFFFFF</strong></span>
</div>
<div>
<span>Color: Maroon</span>
<span>Hex Code: <strong>#800000</strong></span>
</div>
<div>
<span>Color: Red</span>
<span>Hex Code: <strong>#FF0000</strong></span>
</div>
<div>
<span>Color: Purple</span>
<span>Hex Code: <strong>#800080</strong></span>
</div>
</div>
Helpers#
Partials are not much different from standard templates in Buffalo. They include all of the same helpers as well.