Temel kavramlar13 dk okuma

Template'ler

Template'lerin nerede durduğu, nasıl yüklenip binary'ye embed edildiği, development'ta nasıl yeniden yüklendiği; slot'lar, fonksiyonlar ve escaping.

Her fragment bir template render eder. Template'ler Go'nun html/template paketiyle yazılır: sözdizimi de, bağlama göre yapılan escaping de aynıdır. Buna, bir fragment'in ihtiyaç duyduğu şeyler için birkaç fonksiyon eklenmiştir. Bu fonksiyonlar fragment'in slot'larını, diğer page'lere link'leri, asset'leri, form'ları ve page'in <head>'ini kapsar.

<!-- templates/pages/post.html -->
<article>
  <h1>{{.Title}}</h1>
  <p class="meta">{{formatTime .Published "2 January 2006"}}</p>
  {{slot "author"}}
  <div class="body">{{.Body}}</div>
</article>

Template'ler nerede durur

Template'lerin nerede bulunacağını Config.Template belirler:

app, err := collage.New(&collage.Config{
	Template: collage.TemplateConfig{
		Root:      "templates",
		Extension: ".html",
	},
})

Root altındaki, uzantısı Extension olan her dosya bir template'tir. Root'un varsayılan değeri ./templates, Extension'ınki ise .html'dir. Başka uzantılı dosyalar yok sayılır. Bu yüzden template'lerin yanında duran bir README.md sorun çıkarmaz.

Bir template'in adı, Root'a göre göreli yoludur ve uzantıyı da içerir. Fragment'te yazdığınız ad da budur:

templates/
├── layouts/master.html      →  "layouts/master.html"
├── pages/post.html          →  "pages/post.html"
└── fragments/author.html    →  "fragments/author.html"
collage.NewFragment("author", "fragments/author.html")

Bir kez yüklenir, erkenden kontrol edilir

collage.New, daha hiçbir şey serve edilmeden bütün template'leri parse edip tek bir set'e toplar. Her hata türü, yakalanabileceği en erken noktada yakalanır:

  • Var olmayan bir root olduğunda New, ErrTemplateRootMissing ile hata döner. Bu, açılışta en sık karşılaşılan hatadır. Parse edilemeyen bir template'ten ayırt edebilmeniz için ayrı bir hatadır.
  • Parse edilemeyen bir template ya da register edilmemiş bir fonksiyonu çağıran bir template olduğunda New hata döner ve hatada dosyanın adı yer alır.
  • Yüklenmemiş bir template'i gösteren bir fragment olduğunda RegisterPage, ErrTemplateNotFound ile hata döner. Hata page'i, fragment'i ve yolu belirtir.
  • Template'inin hiç çağırmadığı bir slot'a bağlanmış bir fragment olduğunda RegisterPage, ErrUnknownSlot ile hata döner. Ayrıntılar aşağıda, Slot'lar bölümündedir.
  • Verisine uymayan bir template olduğunda (verinin tipinde yalnızca Title varken {{.Titel}} ya da yanlış sayıda argümanla çağrılan bir method gibi) RegisterPage, ErrTemplateType ile hata döner. Hata dosyayı, satırı ve sütunu belirtir. Bkz. Template'ler nasıl kontrol edilir.
  • html/template'in escape edemediği bir template olduğunda (hiç kapanmayan bir <script> string'i, bir attribute'u farklı durumlarda bırakan {{if}} dalları, bir tag'in içinde biten bir partial) RegisterPage hata döner. Hata page'i, fragment'i ve template'i belirtir. html/template bir template'i ilk çalıştığında escape eder; böyle bir template sorunsuz parse edilir ve ilk request'te başarısız olurdu, optional bir fragment de page'den sessizce eksilen bir bölüm olurdu. Her fragment'in kök template'i register sırasında, render edildiği bağlamda bir kez escape edilir ve hiçbir şey çalışmaz: ne bir data handler ne de bir template fonksiyonu. Bir partial tek başına değil, onu include eden template'in parçası olarak escape edilir.
  • Çalışırken hata veren bir template, örneğin tipi render'dan önce bilinmeyen bir verinin alanına erişen, nil bir pointer'a takılan ya da hata dönen bir fonksiyonu çağıran bir template, kendi fragment'ini başarısız kılar. Bu durumda fragment'in failure policy'si devreye girer. Çıktı buffer'lanır. Bu yüzden yarıda hata veren bir template yarım bir fragment yazmaz, hiçbir şey yazmaz.

Bütün template'ler tek bir set'te olduğu için bir template başka bir template'i adıyla include edebilir:

{{template "partials/byline.html" .}}

{{define}} ile verdiğiniz adlar, bütün dosyalarda bu tek namespace'i paylaşır. Bu yüzden ayırt edici adlar seçin.

Yalnızca Root verildiğinde template'ler diskten os.OpenRoot üzerinden okunur. Dolayısıyla dizinin dışına çıkan bir symlink takip edilmez, reddedilir: New, ErrTemplateEscapesRoot ile hata döner ve hatada dosyanın adı yer alır.

Template'leri binary'ye embed etmek

Template'lerini ./templates'ten okuyan bir binary, yalnızca bu dizinin bulunduğu bir yerden çalışır. Template'leri embed ederseniz binary her yerden çalışır: bir container'da, bir systemd unit'inde ya da bir sunucuya kopyalanmış hâliyle.

//go:embed all:templates
var templatesFS embed.FS

app, err := collage.New(&collage.Config{
	Template: collage.TemplateConfig{
		FS:        templatesFS,
		Root:      "templates",
		Extension: ".html",
	},
})

FS verildiğinde Root, o filesystem içindeki bir dizini gösterir. Root yine her template adının başından çıkarılır ve gerekli olmasının sebebi de budur. embed.FS dosyaları source tree'deki yollarıyla adlandırır. Root olmasaydı her template'in adı templates/pages/post.html gibi olurdu.

FS ile birlikte boş bir Root, filesystem'in kökü anlamına gelir. all: prefix'i, adı . ya da _ ile başlayan dosyaların da embed edilmesini sağlar. Düz bir //go:embed templates bu dosyaları atlar.

collage new aynısını tek bir filesystem olan files ile oluşturur. Bu filesystem templates, static ve plugins-config.json'ı birlikte embed eder ve Template.FS olarak verilir.

Development'ta yeniden yükleme

Development'ta, yani Config.DevMode açıkken, her render'dan önce bütün template'ler yeniden parse edilir. Bir template'i kaydettiğinizde bir sonraki request onu kullanır. Framework COLLAGE_DEV'i okumaz. Bu değişkeni collage dev set eder, scaffold edilen main.go da onu Config.DevMode'a çevirir.

Embed edilmiş bir set bunu yapamaz. Byte'ları binary build edildiği anda sabitlenmiştir ve onları yeniden parse etmek hiçbir şeyi değiştirmez.

Bu yüzden Root, çalışma dizinine göre bir dizin olarak var olduğunda development'ta diskteki dizin embed edilmiş kopyanın önüne geçer ve uygulama bu seçimi log'lar. collage dev proje dizininizde çalıştığı için bu dizin orada her zaman vardır.

collage.New template'leri nereden okur. Template.FS verilmemişse Root dizinini diskten os.OpenRoot üzerinden okur. FS verilmiş ve DevMode kapalıysa embed edilmiş FS'i okur. FS verilmiş ve DevMode açıksa, Root çalışma dizinine göre bir dizinse diskteki Root'u okur ve bunu log'lar; değilse embed edilmiş FS'i okur ve değişiklikler görünmez. Development'ta her render, okunan set'i yeniden parse eder.collage.NewTemplate.FS var mı?hayırdiskteki Rootos.OpenRootevetDevMode açık mı?hayırembed FSbuild'de sabitevetRoot diskte dizin mi?hayırembed FSeski kalırevetdiskteki Rootlog'lanır · güncelDevelopment'ta her render set'i yeniden parse eder.
Bir uygulamanın template'lerin hangi kopyasını render edeceği collage.New'da belirlenir. Template.FS yoksa bu, diskteki Root dizinidir. Bir FS varsa embed edilmiş kopyadır. Tek istisna development'tır: Root çalışma dizinine göre bir dizin olarak da varsa onun yerine o dizin okunur ve uygulama bunu log'lar. Development'ta her render, seçilen kopyayı yeniden parse eder. Böylece diskte yapılan bir değişiklik bir sonraki request'te görünür, okunmayan bir dizinde yapılan değişiklik ise ancak binary yeniden build edildiğinde görünür.

Bir değişikliğin hemen görünmesini iki şey daha sağlar:

  • Development'ta page cache hiç okunmaz. Böylece değişiklikten önce cache'lenmiş bir page, değişikliği gizlemez.
  • Development'taki her page, küçük bir script içerir. Bu script bir template ya da static bir dosya değiştiğinde tarayıcıyı yeniler. Config.DevWatch'ta belirttiğiniz bir dizindeki dosyalar da buna dahildir. Bu, handler'larınızın diskten okuduğu Markdown gibi içerikler içindir.

Bütün set yeniden parse edildiği için herhangi bir template'teki bir syntax hatası, düzeltilene kadar bütün render'ları başarısız kılar. Bu development'ta olur. Hatayı orada hemen, dosya ve satır numarasıyla birlikte görürsünüz.

Register sırasında yapılan kontroller, verinin tipine göre yapılan kontrol de dahil, açılıştan sonra düzenlenen bir template için bir sonraki yeniden başlatmaya kadar yeniden yapılmaz. Böyle bir template'in hatası bunun yerine development error page'inde görünür; önce template, satır ve neden gelir.

Bir template ne alır

., tam olarak fragment'in data handler'ının döndürdüğü değerdir ya da collage.Value'nun verdiği değerdir. Tipi de handler'ın ya da değerin belirttiği Go tipidir. Verisi olmayan ya da handler'ı collage.Effect ile uyarlanmış bir fragment, veri olmadan render edilir. Bkz. Data handler'lar.

type postView struct {
	Title     string
	Published time.Time
	Body      template.HTML // already sanitised, see below
	Tags      []string
}
<h1>{{.Title}}</h1>
{{with .Tags}}<p>Tagged {{join ", " .}}</p>{{end}}

Bir template yalnızca kendi fragment'inin verisini görür. Parent'ın verisine child'dan erişilemez ve global bir site nesnesi yoktur. Sitenin adı gibi her template'in ihtiyaç duyduğu bir şey, ya fragment'ine verilen veridir ya da sizin register ettiğiniz bir fonksiyondur.

Slot'lar

{{slot "name"}}, fragment'in o adı taşıyan slot'unda ne varsa sırasıyla render eder ve HTML olarak ekler. Child'ların çıktısı ikinci kez escape edilmez. Her child, render edilirken kendi değerlerini zaten escape etmiştir.

<main>{{slot "content"}}</main>
<aside>{{slot "sidebar"}}</aside>
  • Bir slot'u tanımlayan, onun çağrılmasıdır. Fragment'in Go kodunda bunun için WithSlot gerekmez. WithSlot yalnızca bir slot'u zorunlu kılar ya da onu tek bir fragment'le sınırlar.
  • Boş bir slot hiçbir şey render etmez. Ona daha önce bir şey bağlanmış olup olmaması bunu değiştirmez.
  • Template'inin hiç çağırmadığı bir slot'a bağlanmış bir fragment, register sırasında ErrUnknownSlot ile başarısız olur. Hata, slot'u ve template'in gerçekten çağırdığı slot'ları söyler. Aksi hâlde bağlamanın iki tarafından birindeki bir yazım hatası, page'den sessizce eksilen bir bölüm olurdu. Template'in include ettiği bir template'teki ya da tanımladığı bir block'taki çağrılar da sayılır. Bir slot'u literal dışında bir şeyle ({{slot .Which}}) adlandıran bir template bunlardan herhangi birini çağırabilir. Bu yüzden onun fragment'i kontrol edilmez.
  • Template'in atladığı bir {{if}} içindeki slot render edilmez. Ancak o slot'taki fragment'lerin data handler'ları zaten başlatılmıştır. Ayrıntılar için Fragment'ler ve slot'lar sayfasına bakın.

slot fonksiyonu, template'i çalıştıran fragment'e aittir. Bu yüzden aynı {{slot "content"}}, onu yazan her fragment'te farklı bir slot anlamına gelir.

Built-in fonksiyonlar

Aşağıdaki fonksiyonlar, html/template'in kendi fonksiyonlarıyla (printf, len, index, eq ve diğerleri) birlikte her template'te kullanılabilir:

FonksiyonNe yapar
slot "name"Bu fragment'in slot'larından birindeki fragment'leri render eder
pageURL "name" "param" value …Register edilmiş bir page'in ya da document'ın, bu render'ın locale'indeki URL'sini verir
pageURLIn "locale" "name" …Aynısını, tam olarak verilen locale'de verir
localeURL "locale"Bu page'in başka bir locale'deki URL'sini verir. Page'in o locale'de bir path'i yoksa boş döner
actionURL "name" …Bir action'ın, bu render'ın locale'indeki URL'sini verir
fragmentURL "page" "fragment" …Bir fragment path'inin, bu render'ın locale'indeki URL'sini verir
fragmentURLIn "locale" "page" "fragment" …Aynısını, tam olarak verilen locale'de verir
asset "/static/app.css"Mount edilmiş bir dosyanın content-addressed URL'sini verir
stylesheet "/static/app.css"Page'in <head>'i için bir stylesheet tanımlar
hoist "head"Page'in bir alanı için yapılan tanımların yerleşeceği yeri belirler. Alanın ismi harf, rakam, _ ve -'den oluşur; başka bir isim render'ı başarısız kılar
csrfTokenForm'un forgery token'ını taşıyan hidden input'u üretir
safeHTML, safeURLBir string'i güvenilir HTML ya da URL olarak işaretler. Escaping'i atlamanın yoludur
dict "key" value …{{template}}'e birden fazla değer geçirmek için bir map oluşturur
default fallback valuevalue'yu, boşsa fallback'i döner. Yalnızca string'lerle çalışır, başka bir tip render'ı başarısız kılar
upper, lower, titleBüyük/küçük harf dönüşümü yapar
join sep itemsBir []string'i birleştirir
formatTime t layoutBir time.Time'ı bir Go layout'uyla formatlar
withQuery "page" 2 …Query parametreleri set edilmiş hâliyle bu page'in URL'si; "" bir parametreyi kaldırır
pathEscape sBir string'i tek bir path segment'i için escape eder
json v, pre vBir değerin JSON hâli, ya da bir template'e ne verildiğini görmek için escape edilmiş bir <pre> bloğu
add, sub, mul, div, mod, min, max; addf, subf, mulf, divfTam sayı ve float64 aritmetiği
trim, replace, contains, hasPrefix, hasSuffix, split, truncateString'i en sonda alan, bu yüzden pipeline içinde doğal okunan string fonksiyonları
first, last, seq, keys, hasKey, digBir listenin uçları, üzerinde sayılacak bir aralık, bir map'in key'leri, verinin derinindeki bir değer

Link fonksiyonları katıdır. Bilinmeyen bir page adı ya da eksik bir parametre, bozuk bir link üretmek yerine render'ı başarısız kılar. Her fonksiyonun argümanlarını ve davranışını Template fonksiyonları sayfasında bulabilirsiniz.

Kendi fonksiyonlarınızı eklemek

Config.Template.Funcs, bütün template'lere fonksiyon ekler. Bu alan bir html/templateFuncMap'idir:

import "html/template"

app, err := collage.New(&collage.Config{
	Template: collage.TemplateConfig{
		FS:   templatesFS,
		Root: "templates",
		Funcs: template.FuncMap{
			"money": func(cents int64) string {
				return fmt.Sprintf("$%d.%02d", cents/100, cents%100)
			},
			"readingTime": func(words int) string {
				return fmt.Sprintf("%d min read", max(1, words/200))
			},
		},
	},
})
<p>{{money .PriceCents}} · {{readingTime .WordCount}}</p>
  • New'dan önce set edin.html/template yalnızca adı template parse edilirken bilinen bir fonksiyonu çağırabilir ve parse işlemi New'da yapılır. Register edilmemiş bir adı çağıran template New'da hata verir. Amaç da tam olarak budur: yazım hatasını uygulama açılırken yakalarsınız.
  • Built-in bir fonksiyonun adıyla eklenen bir entry, o built-in'in yerini alır. Render'a bağlı olan on iki fonksiyon bunun dışındadır: slot, hoist, asset, stylesheet, csrfToken, pageURL, pageURLIn, localeURL, actionURL, fragmentURL, fragmentURLIn ve withQuery. Render engine her render için bunların kendi versiyonlarını bağlar. Bu yüzden bunlardan birini override etmek kabul edilir, ama hiçbir etkisi olmaz; New onu adıyla anan bir uyarı log'lar.
  • Bir fonksiyon request'i göremez. Fonksiyon, bütün program için bir kez register edilir. Request'e, locale'e ya da kullanıcıya bağlı olan her şey data handler'da olmalıdır. Veri zaten oradan gelir.

Bir plugin de Configure hook'undan fonksiyon ekleyebilir. Ayrıntılar için Plugin yazmak sayfasına bakın. Bir plugin ve Funcs aynı adı tanımlarsa Funcs kazanır, çünkü ikisini birden görebilen uygulamadır; plugin'in her render'da eklediği bir fonksiyon için de. Bir plugin built-in bir adı ise hiç alamaz, template dilinin html ya da eq gibi bir adını da.

Escaping

html/template her değeri, göründüğü yere göre escape eder. Bu yer HTML metni, bir attribute, bir URL, inline JavaScript ya da CSS olabilir. Başlığı <script>alert(1)</script> olan bir yazı düz metin olarak basılır. Bir href içindeki javascript: URL'si de zararsız bir URL ile değiştirilir. Hiçbir şeyi elle escape etmezsiniz.

Bazen bir değer gerçekten HTML'dir. Örneğin CMS'inizin sanitize ettiği bir yazı gövdesi ya da kendi kodunuzun ürettiği markup böyledir. Bunu belirtmenin iki yolu vardır:

  • View'ınızda alana template.HTML tipini verin, yukarıdaki Body gibi. Bu durumda kararı tip taşır. Karar Go'da verilir ve orada review edilebilir.
  • Template'te safeHTML (URL için safeURL) kullanın.

İkisi de o değer için escaping'i kapatır. Bunları yalnızca kendi ürettiğiniz ya da sanitize ettiğiniz içerikte kullanın. Kullanıcının yazdığı hiçbir şeyde kullanmayın. Escape edilmemiş bir kullanıcı değeri bir cross-site scripting (XSS) açığıdır.

İki built-in, olduğu gibi eklenen HTML üretir:

  • {{slot}}. Child'ları kendi değerlerini zaten escape etmiştir.
  • {{hoist}}. Fragment'lerin page için tanımladıklarını yazar. rc.HoistTitle, rc.HoistMeta ve benzeri helper'lar kendilerine verilen değeri escape eder. Bunların altındaki rc.Hoist ise markup'ı tam yazıldığı gibi ekler, yani orada escaping sizin sorumluluğunuzdadır. Alanın ismi escape edilmez, kontrol edilir: harf, rakam, _ ve - dışında bir şey içeren bir isimle {{hoist .Area}} render'ı başarısız kılar, böylece request'ten gelen bir değer markup'a dönüşemez. Ayrıntılar için Head ve SEO sayfasına bakın.

pageURL ve benzerleri, path'e yerleştirdikleri parametre değerlerini escape eder. Ayrıca . ya da .. değerini reddeder, çünkü tarayıcı bunları path'te bir üst seviyeye çıkmak olarak yorumlar.

Örnek: bir blog yazısı

Bir blogun yazı page'i, bu sayfadakilerin çoğunu bir arada kullanır. Her kısım page'e farklı bir yoldan ulaşır:

KısımNerede tanımlanırPage'e nereden girer
Yazıpages/post.htmllayout'un {{slot "content"}} çağrısı
Yazar kartıfragments/author.htmlyazının {{slot "author"}} çağrısı
Yazının stylesheet'iyazıdaki {{stylesheet}}layout'un {{hoist "head"}} çağrısı
<title> ve descriptionhandler'daki rc.HoistTitle, rc.HoistMetalayout'un {{hoist "head"}} çağrısı
Okurların yorumlarıyazının verisiescape edilen {{.Text}}

Handler'lar yazının slug'ını path'ten okur. blog paketi, kendi veri katmanınızın yerini tutar:

type comment struct {
	Name string
	Text string
}

type postView struct {
	Title     string
	Published time.Time
	Body      template.HTML // rendered and sanitised by your own code
	Comments  []comment
}

type authorView struct {
	Name string
	Bio  string
}

func loadPost(ctx context.Context, rc *collage.RenderContext) (postView, []string, error) {
	slug := rc.Param("slug")
	p, err := blog.GetPost(ctx, slug)
	if err != nil {
		return postView{}, nil, err
	}
	rc.HoistTitle(p.Title)
	rc.HoistMeta("description", p.Summary)

	view := postView{Title: p.Title, Published: p.Published, Body: p.Body}
	for _, c := range p.Comments {
		view.Comments = append(view.Comments, comment{Name: c.Name, Text: c.Text})
	}
	return view, []string{"post:" + slug}, nil
}

func loadAuthor(ctx context.Context, rc *collage.RenderContext) (authorView, error) {
	a, err := blog.AuthorOf(ctx, rc.Param("slug"))
	if err != nil {
		return authorView{}, err
	}
	return authorView{Name: a.Name, Bio: a.Bio}, nil
}

Yazar kartı kendi başına bir fragment'tir ve yazının author slot'una bağlanır:

layout := collage.NewFragment("layout", "layouts/master.html").Build()

author := collage.NewFragment("author", "fragments/author.html").
	WithData(collage.Load(loadAuthor)).
	Build()

post := collage.NewFragment("post", "pages/post.html").
	WithData(collage.LoadTagged(loadPost)).
	WithSlotFragment("author", author).
	Required().
	Build()

page := collage.NewPage("post").
	WithLayouts(layout).
	WithContent(post).
	WithPath("en", "/posts/{slug}").
	Build()

if err := app.RegisterPage(page); err != nil {
	return err
}

Üç template:

<!-- templates/layouts/master.html -->
<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  {{hoist "head"}}
</head>
<body>{{slot "content"}}</body>
</html>
<!-- templates/pages/post.html -->
{{stylesheet "/static/post.css"}}
<article>
  <h1>{{.Title}}</h1>
  <p class="meta">{{formatTime .Published "2 January 2006"}}</p>
  {{slot "author"}}
  <div class="body">{{.Body}}</div>
  <section class="comments">
    {{range .Comments}}<p><b>{{.Name}}</b> {{.Text}}</p>{{end}}
  </section>
</article>
<!-- templates/fragments/author.html -->
<aside class="author">
  <strong>{{.Name}}</strong>
  <p>{{.Bio}}</p>
</aside>

/static/post.css bir mount içindeki bir dosya olmalıdır. {{stylesheet}} onun content-addressed URL'sine link verir. Hiçbir mount'un serve etmediği bir path render'ı başarısız kılar.

Render edilmiş blog yazısı page'i. Layout'un hoist head işareti, page'in tamamı render edildikten sonra doldurulur: yazının handler'ının hoist ettiği title ve description meta'sı ile yazının template'inin stylesheet ile tanımladığı post.css link'i oraya gider. Layout'un content slot'u post fragment'ini, yazının author slot'u da author fragment'ini tutar. Yazının içinde başlık ve okurların yorumları escape edilir; template.HTML tipindeki gövde olduğu gibi eklenir.layoutlayouts/master.htmlhoist "head"<title><meta>post.cssslot "content"postpages/post.htmlstylesheeth1: escape edilirslot "author"authorfragments/author.htmlyorumlar: escape edilirgövde: template.HTML, aynen
Post fragment'i layout'un content slot'unu, author fragment'i de yazının author slot'unu doldurur. Yazının handler'ının hoist ettiği title ve description ile template'inin tanımladığı stylesheet, layout'un hoist "head" işaretine çıkar. Bu işaret page'in tamamı render edildikten sonra doldurulur. Yazının içinde başlık ve okurların yorumları escape edilir; template.HTML tipindeki gövde olduğu gibi eklenir.

Okurun gördüğü

Başlığı Escaping <script> & friends olan bir yazı ve metni <script>alert(1)</script> olan bir yorum düşünün. /posts/escaping için gelen bir request 200 ile cevaplanır. Page, <head>'den </body>'ye kadar ve boş satırlar çıkarılmış hâliyle şöyledir:

<head>
  <meta charset="utf-8">
  <title>Escaping &lt;script&gt; &amp; friends</title><meta name="description" content="What html/template escapes for you"><link rel="stylesheet" href="/static/post.cba296a6afd593e0.css">
</head>
<body>
<article>
  <h1>Escaping &lt;script&gt; &amp; friends</h1>
  <p class="meta">18 October 2026</p>
<aside class="author">
  <strong>Ada</strong>
  <p>Writes about templates.</p>
</aside>
  <div class="body"><p>Hello <em>world</em></p></div>
  <section class="comments">
    <p><b>mallory</b> &lt;script&gt;alert(1)&lt;/script&gt;</p>
  </section>
</article>
</body>
  • Başlık, göründüğü iki yerde de escape edilir.rc.HoistTitle onu <title> için, {{.Title}} ise <h1> için escape eder.
  • Yorum düz metindir.{{.Text}} bir string'dir. Bu yüzden okurun script'i çalışmaz, metin olarak basılır.
  • Gövde markup'tır. Tipi template.HTML olduğu için olduğu gibi eklenir. Güvenliği sizin kodunuza kalan tek değer budur.
  • Stylesheet <head>'dedir. Yazının template'i onu <body> içinde tanımlasa da content-addressed URL'siyle head'e link'lenir.

Register'ın yakaladıkları

pages/post.html'de başlık için {{.Titel}}, yorum döngüsünde de {{.Name}} yerine {{.Author}} yazın. RegisterPage, page'i ErrTemplateType ile reddeder. İki bulguyu birden, her birini dosyası, satırı ve sütunuyla verir:

collage: page "post": fragment "post" (pages/post.html:4:8): {{.Titel}}: type main.postView has no field or method Titel (did you mean Title?)
collage: page "post": fragment "post" (pages/post.html:9:31): {{.Author}}: type main.comment has no field or method Author

{{range .Comments}} içinde . bir comment'tir. Bu yüzden ikinci bulgu yazının değil, o tipin adını verir.

Bunun yerine yazar kartını bir yazım hatasıyla bağlayın: WithSlotFragment("autor", author). Bu durumda RegisterPage, ErrUnknownSlot ile başarısız olur:

collage: unknown slot: page "post" fragment "post" binds into slot "autor", but template "pages/post.html" never calls it; it calls [author]

Bu kontrollerin ikisi de safeHTML'e ne verildiğine bakmaz, register sırasındaki escape kontrolü de bakmaz. {{.Text | safeHTML}} tiplere uyar ve hepsinden geçer, ama okurun script'ini markup olarak basar. safeHTML'i yalnızca kendi ürettiğiniz ya da sanitize ettiğiniz içerik için kullanın.