logo Buffalo slack logo
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:

<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)

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/077acb8d-6cf7-4e7c-ba6c-c60e58ea5fcb/">
<!-- form content here  -->
</form>

Local Context

In addition to have the global context, you can set additional variable only for partials as “local” variables.

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.