README
¶
Gonertia
Gonertia is a Inertia.js server-side adapter for Golang. Visit inertiajs.com to learn more.
Introdution
Inertia allows you to create fully client-side rendered, single-page apps, without the complexity that comes with modern SPAs. It does this by leveraging existing server-side patterns that you already love.
This package based on petaki/inertia-go, but with tests and some features that the official Inertia.js adapter for Laravel inertiajs/inertia-laravel has.
Roadmap
- Tests
- Validation errors
- SSR
Installation
Install using go get command:
go get github.com/romsar/gonertia
Usage
Basic example
Initialize Gonertia in your main.go:
package main
import (
"log"
"http"
"time"
inertia "github.com/romsar/gonertia"
)
func main() {
i, err := inertia.New(
"https://yourwebsite.com",
"./ui/templates/root.html",
)
if err != nil {
log.Fatal(err)
}
// Now create your HTTP server.
// Gonertia works well with standard http handlers,
// but you free to use some frameworks like Gorilla Mux or Chi.
mux := http.NewServeMux()
mux.Handle("/home", i.Middleware(homeHandler(i)))
}
func homeHandler(i *inertia.Inertia) http.Handler {
fn := func(w http.ResponseWriter, r *http.Request) {
err := i.Render(w, r, "Home/Index", inertia.Props{
"some": "data",
})
if err != nil {
handleServerErr(w, err)
}
}
return http.HandlerFunc(fn)
}
Create root.html template:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>title</title>
{{ .inertiaHead }}
</head>
<body>
{{ .inertia }}
<script src="/static/js/app.js"></script>
</body>
</html>
More examples
Load root template using embed
import "embed"
//go:embed templates
var templateFS embed.FS
// ...
i, err := inertia.New(
/* ... */
inertia.WithTemplateFS(templateFS),
)
Set asset version (learn more)
i, err := inertia.New(
/* ... */
inertia.WithVersion("some-version"),
)
Set asset version by asset url
i, err := inertia.New(
/* ... */
inertia.WithAssetURL("/static/js/1f0f8sc6.js"),
)
Set asset version by manifest file
i, err := inertia.New(
/* ... */
inertia.WithManifestFile("./ui/manifest.json"),
)
Replace standard JSON marshall function
import jsoniter "github.com/json-iterator/go"
// ...
i, err := inertia.New(
/* ... */,
inertia.WithMarshalJSON(jsoniter.Marshal),
)
Use your logger
i, err := inertia.New(
/* ... */
inertia.WithLogger(somelogger.New()),
// or inertia.WithoutLogger(),
)
Set custom container id
i, err := inertia.New(
/* ... */
inertia.WithContainerID("inertia"),
)
Closure and lazy props (learn more)
props := inertia.Props{
"regular": "prop",
"closure": func () (any, error) { return "prop", nil },
"lazy": inertia.LazyProp(func () (any, error) {
return "prop", nil
},
}
i.Render(w, r, "Some/Page", props)
Redirects (learn more)
func homeHandler(i *inertia.Inertia) http.Handler {
fn := func(w http.ResponseWriter, r *http.Request) {
i.Location(w, r, "/some-url")
}
return http.HandlerFunc(fn)
}
NOTES: If request was Inertia request - user will be redirected via Inertia.js. If not - user will be redirected via 302 status. If response is empty - user will be redirected to the previous url.
Share template data (learn more)
i.ShareTemplateData("title", "Home page")
<title>{{ .title }}</title>
Share template func
i.ShareTemplateFunc("trim", strings.Trim)
<title>{{ trim "foo bar" }}</title>
Pass template data via context (in middleware)
ctx := i.WithTemplateData(r.Context(), "title", "Home page")
// pass it to the next middleware or inertia.Render function via r.WithContext(ctx).
Share prop globally (learn more)
i.ShareProp("name", "Roman")
Pass props via context (in middleware)
ctx := i.WithProp(r.Context(), "name", "Roman")
// pass it to the next middleware or inertia.Render function via r.WithContext(ctx).
License
Gonertia is released under the MIT License.
Documentation
¶
Index ¶
- func IsInertiaRequest(r *http.Request) bool
- type Inertia
- func (i *Inertia) FlushSharedProps()
- func (i *Inertia) FlushSharedTemplateData()
- func (i *Inertia) FlushSharedTemplateFuncs()
- func (i *Inertia) Location(w http.ResponseWriter, r *http.Request, url string, status ...int)
- func (i *Inertia) Middleware(next http.Handler) http.Handler
- func (i *Inertia) Render(w http.ResponseWriter, r *http.Request, component string, props ...Props) (err error)
- func (i *Inertia) ShareProp(key string, val any)
- func (i *Inertia) ShareTemplateData(key string, val any)
- func (i *Inertia) ShareTemplateFunc(key string, val any)
- func (i *Inertia) SharedProp(key string) (any, bool)
- func (i *Inertia) SharedProps() Props
- func (i *Inertia) WithProp(ctx context.Context, key string, val any) context.Context
- func (i *Inertia) WithProps(ctx context.Context, props Props) context.Context
- func (i *Inertia) WithTemplateData(ctx context.Context, key string, val any) context.Context
- type LazyProp
- type Option
- func WithAssetURL(url string) Option
- func WithContainerID(id string) Option
- func WithLogger(log logger) Option
- func WithManifestFile(path string) Option
- func WithMarshalJSON(f marshallJSON) Option
- func WithTemplateFS(templateFS fs.FS) Option
- func WithVersion(version string) Option
- func WithoutLogger() Option
- type Props
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func IsInertiaRequest ¶
IsInertiaRequest returns true if this request is Inertia request.
Types ¶
type Inertia ¶
type Inertia struct {
// contains filtered or unexported fields
}
Inertia is a structure that contain all logic of Inertia server adapter.
func (*Inertia) FlushSharedProps ¶
func (i *Inertia) FlushSharedProps()
FlushSharedProps flushes shared props.
func (*Inertia) FlushSharedTemplateData ¶
func (i *Inertia) FlushSharedTemplateData()
FlushSharedTemplateData flushes shared template data.
func (*Inertia) FlushSharedTemplateFuncs ¶ added in v1.0.1
func (i *Inertia) FlushSharedTemplateFuncs()
FlushSharedTemplateFuncs flushes the shared template func map.
func (*Inertia) Location ¶
Location creates redirect response.
If request is Inertia request, it will set status to 409 and url will be in "X-Inertia-Location" header. Otherwise, it will do an HTTP redirect with specified status (default is 302).
func (*Inertia) Middleware ¶
Middleware returns http.Handler with Inertia support.
All of your handlers that need to be handled by the Inertia should be under this middleware.
func (*Inertia) Render ¶
func (i *Inertia) Render(w http.ResponseWriter, r *http.Request, component string, props ...Props) (err error)
Render return response with Inertia data.
If request is Inertia request - it will return JSON. Otherwise, it will return root template.
func (*Inertia) ShareTemplateData ¶
ShareTemplateData adds passed data to shared template data.
func (*Inertia) ShareTemplateFunc ¶
ShareTemplateFunc adds passed value to the shared template func map.
func (*Inertia) SharedProp ¶
SharedProp return the shared prop.
func (*Inertia) SharedProps ¶
SharedProps returns shared props.
type Option ¶
Option is an option parameter that modifies Inertia.
func WithAssetURL ¶
WithAssetURL returns Option that will set Inertia's version based on asset url.
func WithContainerID ¶
WithContainerID returns Option that will set Inertia's container id.
func WithLogger ¶
func WithLogger(log logger) Option
WithLogger returns Option that will set Inertia's logger.
func WithManifestFile ¶
WithManifestFile returns Option that will set Inertia's version based on manifest file.
func WithMarshalJSON ¶
func WithMarshalJSON(f marshallJSON) Option
WithMarshalJSON returns Option that will set Inertia's marshallJSON func.
func WithTemplateFS ¶
WithTemplateFS returns Option that will set Inertia's templateFS.
func WithVersion ¶
WithVersion returns Option that will set Inertia's version.
func WithoutLogger ¶
func WithoutLogger() Option
WithoutLogger returns Option that will unset Inertia's logger. Actually set a logger with io.Discard output.
Source Files