render

package
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 26, 2023 License: MIT Imports: 31 Imported by: 396

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func GoTemplateEngine added in v0.7.4 

func GoTemplateEngine(input string, data map[string]interface{}, helpers map[string]interface{}) (string, error)

GoTemplateEngine implements the TemplateEngine interface for using standard Go templates

func MDTemplateEngine added in v0.10.1 

func MDTemplateEngine(input string, data map[string]interface{}, helpers map[string]interface{}) (string, error)

MDTemplateEngine runs the input through github flavored markdown before sending it to the Plush engine.

Types

type Data 

type Data map[string]interface{}

Data type to be provided to the Render function on the Renderer interface.

type Engine 

type Engine struct {
	Options
}

Engine used to power all defined renderers. This allows you to configure the system to your preferred settings, instead of just getting the defaults.

func New 

func New(opts Options) *Engine

New render.Engine ready to go with your Options and some defaults we think you might like.

func (*Engine) Auto added in v0.11.0 

func (e *Engine) Auto(ctx context.Context, i interface{}) Renderer

Auto figures out how to render the model based information about the request and the name of the model. Auto supports automatic rendering of HTML, JSON, and XML. Any status code give to Context#Render between 300 - 400 will be respected by Auto. Other status codes are not.

# Rules for HTML template lookup: GET /users - users/index.html GET /users/id - users/show.html GET /users/new - users/new.html GET /users/id/edit - users/edit.html POST /users - (redirect to /users/id or render user/new.html) PUT /users/edit - (redirect to /users/id or render user/edit.html) DELETE /users/id - redirect to /users

func (*Engine) Download added in v0.13.0 

func (e *Engine) Download(ctx context.Context, name string, r io.Reader) Renderer

Download renders a file attachment automatically setting following headers: 

Content-Type
Content-Length
Content-Disposition

Content-Type is set using mime#TypeByExtension with the filename's extension. Content-Type will default to application/octet-stream if using a filename with an unknown extension.

Note: the purpose of this method is not serving static files but to support downloading of dynamically genrated data as a file. For example, you can use this method when you implement CSV file download feature for the result of a database query.

Do not use this method for large io.Reader. It could cause out of memory if the size of io.Reader is too big.

func (*Engine) Func 

func (e *Engine) Func(s string, fn RendererFunc) Renderer

Func renderer allows for easily building one of renderers using just a RendererFunc and not having to build a whole implementation of the Render interface.

func (*Engine) HTML 

func (e *Engine) HTML(names ...string) Renderer

HTML renders the named files using the 'text/html' content type and the github.com/gobuffalo/plush/v4 package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>". If no second file is provided and an `HTMLLayout` is specified in the options, then that layout file will be used automatically.

func (*Engine) JSON 

func (e *Engine) JSON(v interface{}) Renderer

JSON renders the value using the "application/json" content type.

func (*Engine) JavaScript added in v0.10.1 

func (e *Engine) JavaScript(names ...string) Renderer

JavaScript renders the named files using the 'application/javascript' content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>". If no second file is provided and an `JavaScriptLayout` is specified in the options, then that layout file will be used automatically.

func (*Engine) Plain added in v0.9.1 

func (e *Engine) Plain(names ...string) Renderer

Plain renders the named files using the 'text/plain' content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>".

func (*Engine) String 

func (e *Engine) String(s string, args ...interface{}) Renderer

String renderer that will run the string through the github.com/gobuffalo/plush package and return "text/plain" as the content type.

func (*Engine) Template 

func (e *Engine) Template(c string, names ...string) Renderer

Template renders the named files using the specified content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "{{yield}}".

func (*Engine) XML 

func (e *Engine) XML(v interface{}) Renderer

XML renders the value using the "application/xml" content type.

type ErrRedirect added in v0.11.0 

type ErrRedirect struct {
	Status int
	URL    string
}

ErrRedirect indicates to Context#Render that this is a redirect and a template shouldn't be rendered.

func (ErrRedirect) Error added in v0.11.0 

func (ErrRedirect) Error() string

type EventSource 

type EventSource struct {
	// contains filtered or unexported fields
}

EventSource is designed to work with JavaScript EventSource objects. see https://developer.mozilla.org/en-US/docs/Web/API/EventSource for more details

func NewEventSource 

func NewEventSource(w http.ResponseWriter) (*EventSource, error)

NewEventSource returns a new EventSource instance while ensuring that the http.ResponseWriter is able to handle EventSource messages. It also makes sure to set the proper response heads.

func (*EventSource) CloseNotify 

func (es *EventSource) CloseNotify() <-chan bool

CloseNotify return true across the channel when the connection in the browser has been severed.

func (*EventSource) Flush 

func (es *EventSource) Flush()

Flush messages down the pipe. If messages aren't flushed they won't be sent.

func (*EventSource) Write 

func (es *EventSource) Write(t string, d interface{}) error

type Helpers added in v0.8.0 

type Helpers hctx.Map

Helpers to be included in all templates

type Options 

type Options struct {
	// HTMLLayout is the default layout to be used with all HTML renders.
	HTMLLayout string

	// JavaScriptLayout is the default layout to be used with all JavaScript renders.
	JavaScriptLayout string

	// TemplateFS is the fs.FS that holds the templates
	TemplatesFS fs.FS

	// AssetsFS is the fs.FS that holds the of the public assets the app will serve.
	AssetsFS fs.FS

	// Helpers to be rendered with the templates
	Helpers Helpers

	// TemplateEngine to be used for rendering HTML templates
	TemplateEngines map[string]TemplateEngine

	// DefaultContentType instructs the engine what it should fall back to if
	// the "content-type" is unknown
	DefaultContentType string
}

Options for render.Engine

type Renderer 

type Renderer interface {
	ContentType() string
	Render(io.Writer, Data) error
}

Renderer interface that must be satisfied to be used with buffalo.Context.Render

func Auto added in v0.11.0 

func Auto(ctx context.Context, i interface{}) Renderer

Auto figures out how to render the model based information about the request and the name of the model. Auto supports automatic rendering of HTML, JSON, and XML. Any status code give to Context#Render between 300 - 400 will be respected by Auto. Other status codes are not.

# Rules for HTML template lookup: GET /users - users/index.html GET /users/id - users/show.html GET /users/new - users/new.html GET /users/id/edit - users/edit.html POST /users - (redirect to /users/id or render user/new.html) PUT /users/edit - (redirect to /users/id or render user/edit.html) DELETE /users/id - redirect to /users

func Download added in v0.13.0 

func Download(ctx context.Context, name string, r io.Reader) Renderer

Download renders a file attachment automatically setting following headers: 

Content-Type
Content-Length
Content-Disposition

Content-Type is set using mime#TypeByExtension with the filename's extension. Content-Type will default to application/octet-stream if using a filename with an unknown extension.

Note: the purpose of this function is not serving static files but to support downloading of dynamically genrated data as a file. For example, you can use this function when you implement CSV file download feature for the result of a database query.

Do not use this function for large io.Reader. It could cause out of memory if the size of io.Reader is too big.

func Func 

func Func(s string, fn RendererFunc) Renderer

Func renderer allows for easily building one of renderers using just a RendererFunc and not having to build a whole implementation of the Render interface.

func HTML 

func HTML(names ...string) Renderer

HTML renders the named files using the 'text/html' content type and the github.com/gobuffalo/plush/v4 package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>".

func JSON 

func JSON(v interface{}) Renderer

JSON renders the value using the "application/json" content type.

func JavaScript added in v0.10.1 

func JavaScript(names ...string) Renderer

JavaScript renders the named files using the 'application/javascript' content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>".

func Plain added in v0.9.1 

func Plain(names ...string) Renderer

Plain renders the named files using the 'text/html' content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "<%= yield %>".

func String 

func String(s string, args ...interface{}) Renderer

String renderer that will run the string through the github.com/gobuffalo/plush package and return "text/plain" as the content type.

func Template 

func Template(c string, names ...string) Renderer

Template renders the named files using the specified content type and the github.com/gobuffalo/plush package for templating. If more than 1 file is provided the second file will be considered a "layout" file and the first file will be the "content" file which will be placed into the "layout" using "{{yield}}".

func XML 

func XML(v interface{}) Renderer

XML renders the value using the "application/xml" content type.

type RendererFunc 

type RendererFunc func(io.Writer, Data) error

RendererFunc is the interface for the the function needed by the Func renderer.

type TemplateEngine added in v0.7.4 

type TemplateEngine func(input string, data map[string]interface{}, helpers map[string]interface{}) (string, error)

TemplateEngine needs to be implemented for a template system to be able to be used with Buffalo.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.