35877a1b2e
* scripting enhancements * tests * cleanup / tests * new docs wip * add more docs * more updates * add caching docs * add sse docs * more docs * sidebar, and fix navigation blocks * remove old docs * set proper meta * fixes
45 lines
1.5 KiB
Go
45 lines
1.5 KiB
Go
package core_concepts
|
|
|
|
import "htmgo-site/ui"
|
|
import "github.com/maddalax/htmgo/framework/h"
|
|
import . "htmgo-site/pages/docs"
|
|
|
|
func RawHtml(ctx *h.RequestContext) *h.Page {
|
|
return DocPage(
|
|
ctx,
|
|
h.Div(
|
|
h.Class("flex flex-col gap-3"),
|
|
Title("Raw HTML"),
|
|
Text(`
|
|
In some cases, you may want to render raw html instead of using htmgo's functions.
|
|
This can be done by using the following methods:
|
|
`),
|
|
Text("Rendering raw html:"),
|
|
ui.GoCodeSnippetSingleLine(RawHtmlExample),
|
|
Text("Rendering with formatting:"),
|
|
ui.GoCodeSnippetSingleLine(RawHtmlExample2),
|
|
Text("Rendering a script:"),
|
|
ui.GoCodeSnippetSingleLine(RawHtmlExample3),
|
|
Text(`
|
|
Important: Be careful when using these methods, these methods do not escape the HTML content
|
|
and should never be used with user input unless you have sanitized the input.
|
|
`),
|
|
h.P(
|
|
h.Text("Sanitizing input can be done using "),
|
|
Link("https://pkg.go.dev/html#EscapeString", "html.EscapeString"),
|
|
h.Text(" or by using "),
|
|
Link("bluemonday", "https://github.com/microcosm-cc/bluemonday."),
|
|
h.Text(" for more control over sanitization."),
|
|
),
|
|
NextStep(
|
|
"mt-4",
|
|
PrevBlock("Tags and Attributes", DocPath("/core-concepts/tags-and-attributes")),
|
|
NextBlock("Conditionals", DocPath("/control/if-else")),
|
|
),
|
|
),
|
|
)
|
|
}
|
|
|
|
const RawHtmlExample = `h.UnsafeRaw("<div>Raw HTML</div>")`
|
|
const RawHtmlExample2 = `h.UnsafeRawF("<div>%s</div>", "Raw HTML")`
|
|
const RawHtmlExample3 = `h.UnsafeRawScript("alert('Hello World')")`
|