1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192 |
- // Copyright 2014 Manu Martinez-Almeida. All rights reserved.
- // Use of this source code is governed by a MIT style
- // license that can be found in the LICENSE file.
- package render
- import (
- "html/template"
- "net/http"
- )
- // Delims represents a set of Left and Right delimiters for HTML template rendering.
- type Delims struct {
- // Left delimiter, defaults to {{.
- Left string
- // Right delimiter, defaults to }}.
- Right string
- }
- // HTMLRender interface is to be implemented by HTMLProduction and HTMLDebug.
- type HTMLRender interface {
- // Instance returns an HTML instance.
- Instance(string, any) Render
- }
- // HTMLProduction contains template reference and its delims.
- type HTMLProduction struct {
- Template *template.Template
- Delims Delims
- }
- // HTMLDebug contains template delims and pattern and function with file list.
- type HTMLDebug struct {
- Files []string
- Glob string
- Delims Delims
- FuncMap template.FuncMap
- }
- // HTML contains template reference and its name with given interface object.
- type HTML struct {
- Template *template.Template
- Name string
- Data any
- }
- var htmlContentType = []string{"text/html; charset=utf-8"}
- // Instance (HTMLProduction) returns an HTML instance which it realizes Render interface.
- func (r HTMLProduction) Instance(name string, data any) Render {
- return HTML{
- Template: r.Template,
- Name: name,
- Data: data,
- }
- }
- // Instance (HTMLDebug) returns an HTML instance which it realizes Render interface.
- func (r HTMLDebug) Instance(name string, data any) Render {
- return HTML{
- Template: r.loadTemplate(),
- Name: name,
- Data: data,
- }
- }
- func (r HTMLDebug) loadTemplate() *template.Template {
- if r.FuncMap == nil {
- r.FuncMap = template.FuncMap{}
- }
- if len(r.Files) > 0 {
- return template.Must(template.New("").Delims(r.Delims.Left, r.Delims.Right).Funcs(r.FuncMap).ParseFiles(r.Files...))
- }
- if r.Glob != "" {
- return template.Must(template.New("").Delims(r.Delims.Left, r.Delims.Right).Funcs(r.FuncMap).ParseGlob(r.Glob))
- }
- panic("the HTML debug render was created without files or glob pattern")
- }
- // Render (HTML) executes template and writes its result with custom ContentType for response.
- func (r HTML) Render(w http.ResponseWriter) error {
- r.WriteContentType(w)
- if r.Name == "" {
- return r.Template.Execute(w, r.Data)
- }
- return r.Template.ExecuteTemplate(w, r.Name, r.Data)
- }
- // WriteContentType (HTML) writes HTML ContentType.
- func (r HTML) WriteContentType(w http.ResponseWriter) {
- writeContentType(w, htmlContentType)
- }
|