ui

package
v0.409.4 Latest Latest
Warning

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

 Go to latest Published: May 27, 2026 License: MIT Imports: 24 Imported by: 3

README

github.com/linkdata/jaws/lib/ui

This package is the home of JaWS widget implementations.

Goals

  • Keep widget logic out of JaWS core request/session internals.
  • Make new widget authoring local to this package.
  • Provide short widget naming (ui.Span, ui.NewSpan).
  • Expose template context types (ui.RequestWriter, ui.With).
RequestWriter helper calls

ui.RequestWriter exposes helper methods like rw.Span(...), rw.Text(...), and rw.Select(...) for concise template use. rw.Template(...) renders partial templates inside a generated JaWS wrapper, so template bodies should let that wrapper own JaWS identity and wrapper-level attributes. Attribute params passed to rw.Template(...) are applied to the generated wrapper. Template bodies used with rw.Template(...) must be partials; full page templates should be rendered through ui.Handler.

You can also use explicit constructors through:

rw.UI(ui.NewX(...), params...)

Examples:

rw.UI(ui.NewDiv("content"))
rw.UI(ui.NewCheckbox(myBoolSetter), "disabled")
rw.UI(ui.NewRange(myFloatSetter))

HTML-inner widgets such as NewDiv, NewSpan, and RequestWriter.Div pass their content through bind.MakeHTMLGetter. Plain strings are treated as trusted HTML and are not escaped; use a bind.Getter[string], bind.StringGetterFunc, or fmt.Stringer for string content that should be escaped.

Building blocks

  • HTMLInner
    • For tags like <div>...</div>, <span>...</span>, <td>...</td>.
  • Input, InputText, InputBool, InputFloat, InputDate
    • For interactive inputs with typed parse/update behavior.
  • ContainerHelper
    • For widgets that render and maintain dynamic child lists.

Widget lifetime

UI widget values are render-scoped. Construct them during rendering, typically through RequestWriter helpers such as $.Container(...) and $.Tbody(...).

Do not cache and reuse *ui.Container / *ui.Tbody instances across requests. Those widgets keep internal render/update bookkeeping and are intended to be created fresh for each render.

Adding a simple static widget

Use HTMLInner:

type Article struct{ ui.HTMLInner }

func NewArticle(inner any) *Article {
  return &Article{HTMLInner: ui.HTMLInner{HTMLGetter: bind.MakeHTMLGetter(inner)}}
}

func (w *Article) JawsRender(e *jaws.Element, wr io.Writer, params []any) error {
  return w.renderInner(e, wr, "article", "", params)
}

Adding an interactive input widget

Use one of the typed input bases:

  • InputText for string-based inputs
  • InputBool for boolean inputs
  • InputFloat for numeric inputs
  • InputDate for time.Time inputs

Each base handles:

  • tracking last rendered value
  • receiving what.Input
  • applying dirty tags on successful set
  • update-driven SetValue pushes

Adding a container widget

Use ContainerHelper:

type UList struct{ ui.ContainerHelper }

func NewUList(c jaws.Container) *UList {
  return &UList{ContainerHelper: ui.NewContainerHelper(c)}
}

func (w *UList) JawsRender(e *jaws.Element, wr io.Writer, params []any) error {
  return w.RenderContainer(e, wr, "ul", params)
}

func (w *UList) JawsUpdate(e *jaws.Element) {
  w.UpdateContainer(e)
}

Container error behavior

ContainerHelper treats child render/update failures as application bugs.

  • During initial render, child render failures are returned as errors.
  • During updates, append render failures are reported through MustLog (and may panic if no logger is configured).
  • After such failures, partial DOM/request state updates are expected; state may remain inconsistent until a subsequent full render/reload.

Documentation

Overview

Package ui contains the standard JaWS widget implementations.

The package is intentionally organized around extension-oriented building blocks so new widgets can be authored here without reading JaWS core code:

Naming follows short widget names (`Span`, `NewSpan`) instead of the legacy core names (`UiSpan`, `NewUiSpan`).

Index

Constants

This section is empty.

Variables

View Source 
var ErrIllegalJsVarName errIllegalJsVarName

ErrIllegalJsVarName is returned when a JsVar name is missing, not a string, or does not follow valid top-level identifier syntax.

View Source 
var ErrJsVarArgumentType = errors.New("expected jaws.UI or JsVarMaker")

ErrJsVarArgumentType is returned when RequestWriter.JsVar receives an argument that is neither a JaWS UI nor a JsVarMaker.

View Source 
var ErrMissingTemplate errMissingTemplate

ErrMissingTemplate is returned when trying to render an undefined template by name.

Functions

func Clickable deprecated added in v0.304.0 

func Clickable(innerHTML any, onClick func(elem *jaws.Element, click jaws.Click) (err error)) jaws.ClickHandler

Clickable returns an object implementing bind.HTMLGetter, jaws.ClickHandler and tag.TagGetter.

innerHTML is passed to bind.MakeHTMLGetter, which may or may not provide tags.

Deprecated: use New(innerHTML).Clicked(...) directly.

func Handler 

func Handler(jw *jaws.Jaws, name string, dot any) http.Handler

Handler returns an http.Handler that renders the named template.

The returned handler can be registered directly with a router. Each request results in the template being looked up through the configured template lookupers and rendered directly with dot as the template data.

Types

type A 

type A struct{ HTMLInner }

A renders an HTML anchor element with dynamic inner HTML.

func NewA 

func NewA(innerHTML any) *A

NewA returns an anchor widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*A) JawsRender 

func (u *A) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML anchor element.

type Button 

type Button struct{ HTMLInner }

Button renders an HTML button element with dynamic inner HTML.

func NewButton 

func NewButton(innerHTML any) *Button

NewButton returns a button widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Button) JawsRender 

func (u *Button) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML button element.

type Checkbox 

type Checkbox struct{ InputBool }

Checkbox renders an HTML checkbox input bound to a bool setter.

func NewCheckbox 

func NewCheckbox(g bind.Setter[bool]) *Checkbox

NewCheckbox returns a checkbox input widget bound to g.

func (*Checkbox) JawsRender 

func (u *Checkbox) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML checkbox input.

type ClickedHook added in v0.400.0 

type ClickedHook func(obj Object, elem *jaws.Element, click jaws.Click) (err error)

ClickedHook is a function to call when a click event is received.

type Container 

type Container struct {
	OuterHTMLTag string
	ContainerHelper
}

Container renders an HTML element around a dynamic child collection.

func NewContainer 

func NewContainer(outerHTMLTag string, c jaws.Container) *Container

NewContainer returns a container widget that renders c inside outerHTMLTag. The returned widget tracks child elements and updates them using ContainerHelper.

func (*Container) JawsRender 

func (u *Container) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as its configured container element.

func (*Container) JawsUpdate 

func (u *Container) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the child collection.

type ContainerHelper 

type ContainerHelper struct {
	Container jaws.Container
	Tag       any
	// contains filtered or unexported fields
}

ContainerHelper is a helper for widgets that render dynamic child collections.

It tracks previously rendered child elements and performs append/remove/order updates during ContainerHelper.UpdateContainer.

A ContainerHelper belongs to a widget instance and is intended for render-scoped widget lifetimes (for example widgets created via RequestWriter helper methods).

Error model: Child render/update failures are treated as application bugs. Initial-render errors are returned to the caller, and update-time append render errors are reported through MustLog (which may panic when no logger is configured). After such failures, DOM and request-tracked element state may be partially updated and therefore inconsistent until the next full render/reload.

func NewContainerHelper 

func NewContainerHelper(c jaws.Container) ContainerHelper

NewContainerHelper returns a ContainerHelper for rendering and updating c. ContainerHelper values are render-scoped and should not be reused across requests.

func (*ContainerHelper) RenderContainer 

func (u *ContainerHelper) RenderContainer(elem *jaws.Element, w io.Writer, outerHTMLTag string, params []any) (err error)

RenderContainer renders outerHTMLTag around the current children from jaws.Container.JawsContains.

func (*ContainerHelper) UpdateContainer 

func (u *ContainerHelper) UpdateContainer(elem *jaws.Element)

UpdateContainer updates child elements to match jaws.Container.JawsContains.

Render errors for newly appended children are reported through jaws.Jaws.MustLog, which may panic when no jaws.Jaws.Logger is configured.

type ContextMenuHook added in v0.400.0 

type ContextMenuHook func(obj Object, elem *jaws.Element, click jaws.Click) (err error)

ContextMenuHook is a function to call when a context menu event is received.

type Date 

type Date struct{ InputDate }

Date renders an HTML date input bound to a time value setter.

func NewDate 

func NewDate(g bind.Setter[time.Time]) *Date

NewDate returns a date input widget bound to g.

func (*Date) JawsRender 

func (u *Date) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML date input.

type Div 

type Div struct{ HTMLInner }

Div renders an HTML div element with dynamic inner HTML.

func NewDiv 

func NewDiv(innerHTML any) *Div

NewDiv returns a div widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Div) JawsRender 

func (u *Div) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML div element.

type HTMLInner 

type HTMLInner struct {
	// HTMLGetter returns the trusted inner HTML to render and update.
	HTMLGetter bind.HTMLGetter
}

HTMLInner is a reusable base for widgets that render as `<tag>inner</tag>`.

func (*HTMLInner) JawsUpdate 

func (u *HTMLInner) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the rendered inner HTML.

type Img 

type Img struct{ bind.Getter[string] }

Img renders an HTML img element whose src is read from a string getter.

func NewImg 

func NewImg(g bind.Getter[string]) *Img

NewImg returns an img widget whose src attribute is read from g.

func (*Img) JawsRender 

func (u *Img) JawsRender(elem *jaws.Element, w io.Writer, params []any) (err error)

JawsRender renders ui as an HTML img element.

func (*Img) JawsUpdate 

func (u *Img) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the src attribute.

type InitialHTMLAttrHook added in v0.400.0 

type InitialHTMLAttrHook func(obj Object, elem *jaws.Element) (s template.HTMLAttr)

InitialHTMLAttrHook is a function to call when an jaws.Element is initially rendered.

type Input 

type Input struct {
	Tag  any          // tag to dirty after accepted input
	Last atomic.Value // the last value received from the request
}

Input stores common state for interactive input widgets. There is one of these per request and input widget.

type InputBool 

type InputBool struct {
	Input
	bind.Setter[bool]
}

InputBool is the reusable base for boolean input widgets.

func (*InputBool) JawsInput added in v0.401.0 

func (u *InputBool) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput stores a browser-side bool input value.

func (*InputBool) JawsUpdate 

func (u *InputBool) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the input value when the bound bool value changes.

type InputDate 

type InputDate struct {
	Input
	bind.Setter[time.Time]
}

InputDate is the reusable base for date input widgets.

func (*InputDate) JawsInput added in v0.401.0 

func (u *InputDate) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput stores a browser-side date input value.

func (*InputDate) JawsUpdate 

func (u *InputDate) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the input value when the bound date value changes.

type InputFloat 

type InputFloat struct {
	Input
	bind.Setter[float64]
}

InputFloat is the reusable base for float64 input widgets.

func (*InputFloat) JawsInput added in v0.401.0 

func (u *InputFloat) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput stores a browser-side float64 input value.

func (*InputFloat) JawsUpdate 

func (u *InputFloat) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the input value when the bound float64 value changes.

type InputText 

type InputText struct {
	Input
	bind.Setter[string]
}

InputText is the reusable base for string input widgets.

func (*InputText) JawsInput added in v0.401.0 

func (u *InputText) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput stores a browser-side string input value.

func (*InputText) JawsUpdate 

func (u *InputText) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the input value when the bound string value changes.

type IsJsVar 

type IsJsVar interface {
	bind.RWLocker
	jaws.UI
	jaws.InputHandler
	PathSetter
}

IsJsVar is implemented by JaWS UI values that bind a Go value to a browser-side JavaScript variable.

type JsVar 

type JsVar[T any] struct {
	bind.RWLocker
	Ptr *T  // bound Go value
	Tag any // current dirty tag
}

JsVar binds a Go value to a named JavaScript variable in the browser.

It is safe for concurrent use when the locker passed to NewJsVar is safe for concurrent use.

func NewJsVar 

func NewJsVar[T any](l sync.Locker, v *T) *JsVar[T]

NewJsVar creates a JsVar over v protected by l.

The locker l must be non-nil and must remain valid for the lifetime of the JsVar.

func (*JsVar[T]) JawsGet 

func (jsvar *JsVar[T]) JawsGet(elem *jaws.Element) (value T)

JawsGet returns the bound value.

func (*JsVar[T]) JawsGetPath 

func (jsvar *JsVar[T]) JawsGetPath(elem *jaws.Element, jsPath string) (value any)

JawsGetPath returns the value at jsPath, logging lookup errors on elem when possible.

func (*JsVar[T]) JawsGetTag 

func (jsvar *JsVar[T]) JawsGetTag(tag.Context) any

JawsGetTag returns the current dirty tag.

func (*JsVar[T]) JawsInput added in v0.401.0 

func (jsvar *JsVar[T]) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput applies a browser-side JavaScript variable update.

func (*JsVar[T]) JawsRender 

func (jsvar *JsVar[T]) JawsRender(elem *jaws.Element, w io.Writer, params []any) (err error)

JawsRender writes the hidden element that seeds and routes the JavaScript variable.

func (*JsVar[T]) JawsSet 

func (jsvar *JsVar[T]) JawsSet(elem *jaws.Element, value T) (err error)

JawsSet replaces the root value and broadcasts the change.

func (*JsVar[T]) JawsSetPath 

func (jsvar *JsVar[T]) JawsSetPath(elem *jaws.Element, jsPath string, value any) (err error)

JawsSetPath sets the value at jsPath and broadcasts the change.

func (*JsVar[T]) JawsUpdate 

func (jsvar *JsVar[T]) JawsUpdate(elem *jaws.Element)

JawsUpdate is a no-op because updates are broadcast by path setters.

type JsVarMaker 

type JsVarMaker interface {
	JawsMakeJsVar(rq *jaws.Request) (value IsJsVar, err error)
}

JsVarMaker creates a request-scoped JavaScript variable binding.

type Label 

type Label struct{ HTMLInner }

Label renders an HTML label element with dynamic inner HTML.

func NewLabel 

func NewLabel(innerHTML any) *Label

NewLabel returns a label widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Label) JawsRender 

func (u *Label) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML label element.

type Li 

type Li struct{ HTMLInner }

Li renders an HTML list item with dynamic inner HTML.

func NewLi 

func NewLi(innerHTML any) *Li

NewLi returns a list item widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Li) JawsRender 

func (u *Li) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML list item.

type Number 

type Number struct{ InputFloat }

Number renders an HTML number input bound to a float64 setter.

func NewNumber 

func NewNumber(g bind.Setter[float64]) *Number

NewNumber returns a number input widget bound to g.

func (*Number) JawsRender 

func (u *Number) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML number input.

type Object added in v0.400.0 

type Object interface {
	bind.HTMLGetter
	tag.TagGetter
	jaws.ClickHandler
	jaws.ContextMenuHandler
	jaws.InitialHTMLAttrHandler

	// Clicked returns an [Object] that will call fn when [jaws.ClickHandler.JawsClick] is invoked.
	Clicked(fn ClickedHook) (newobj Object)

	// ContextMenu returns an [Object] that will call fn when
	// [jaws.ContextMenuHandler.JawsContextMenu] is invoked.
	ContextMenu(fn ContextMenuHook) (newobj Object)

	// InitialHTMLAttr returns an [Object] that will call fn when
	// [jaws.InitialHTMLAttrHandler.JawsInitialHTMLAttr] is invoked.
	InitialHTMLAttr(fn InitialHTMLAttrHook) (newobj Object)
}

Object is a chainable UI object that combines HTML rendering, tags and optional event handlers.

func New added in v0.400.0 

func New(innerHTML any) (obj Object)

New returns a new Object that renders innerHTML.

innerHTML is passed to bind.MakeHTMLGetter, which may or may not provide tags. Plain strings are trusted HTML.

type Option 

type Option struct{ *named.Bool }

Option renders an HTML option element backed by a named.Bool.

func NewOption 

func NewOption(nb *named.Bool) Option

NewOption returns an option widget backed by nb.

func (Option) JawsRender 

func (u Option) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML option element.

func (Option) JawsUpdate 

func (u Option) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the selected attribute.

type Password 

type Password struct{ InputText }

Password renders an HTML password input bound to a string setter.

func NewPassword 

func NewPassword(g bind.Setter[string]) *Password

NewPassword returns a password input widget bound to g.

func (*Password) JawsRender 

func (u *Password) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML password input.

type PathSetter 

type PathSetter interface {
	// JawsSetPath should set the JSON object member identified by jsPath to the given value.
	//
	// If the member is already the given value, it should return [jaws.ErrValueUnchanged].
	JawsSetPath(elem *jaws.Element, jsPath string, value any) (err error)
}

PathSetter can set a nested JSON path value.

type Radio 

type Radio struct{ InputBool }

Radio renders an HTML radio input bound to a bool setter.

func NewRadio 

func NewRadio(vp bind.Setter[bool]) *Radio

NewRadio returns a radio input widget bound to vp.

func (*Radio) JawsRender 

func (u *Radio) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML radio input.

type RadioElement 

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

RadioElement contains the input and label elements for one radio option.

func (RadioElement) Label 

func (re RadioElement) Label(params ...any) template.HTML

Label renders an HTML label element.

func (RadioElement) Radio 

func (re RadioElement) Radio(params ...any) template.HTML

Radio renders an HTML input element of type radio.

type Range 

type Range struct{ InputFloat }

Range renders an HTML range input bound to a float64 setter.

func NewRange 

func NewRange(g bind.Setter[float64]) *Range

NewRange returns a range input widget bound to g.

func (*Range) JawsRender 

func (u *Range) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML range input.

type Register 

type Register struct{ jaws.Updater }

Register creates an element used for update-only registration.

func NewRegister 

func NewRegister(updater jaws.Updater) Register

NewRegister returns an update-only widget that invokes updater during updates.

func (Register) JawsRender 

func (u Register) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders no HTML for update-only registration.

type RequestWriter 

type RequestWriter struct {
	*jaws.Request
	io.Writer
}

RequestWriter combines a jaws.Request with an io.Writer while rendering.

func (RequestWriter) A 

func (rw RequestWriter) A(innerHTML any, params ...any) error

A renders an HTML anchor element.

func (RequestWriter) Button 

func (rw RequestWriter) Button(innerHTML any, params ...any) error

Button renders an HTML button element.

func (RequestWriter) Checkbox 

func (rw RequestWriter) Checkbox(value any, params ...any) error

Checkbox renders an HTML checkbox input.

func (RequestWriter) Container 

func (rw RequestWriter) Container(outerHTMLTag string, c jaws.Container, params ...any) error

Container renders c inside outerHTMLTag.

func (RequestWriter) Date 

func (rw RequestWriter) Date(value any, params ...any) error

Date renders an HTML date input.

func (RequestWriter) Div 

func (rw RequestWriter) Div(innerHTML any, params ...any) error

Div renders an HTML div element.

func (RequestWriter) Get 

func (rw RequestWriter) Get(key string) (value any)

Get calls jaws.Request.Get.

func (RequestWriter) HeadHTML 

func (rw RequestWriter) HeadHTML() error

HeadHTML outputs the HTML code needed in the head section.

func (RequestWriter) Img 

func (rw RequestWriter) Img(imageSrc any, params ...any) error

Img renders an HTML img element.

func (RequestWriter) Initial 

func (rw RequestWriter) Initial() *http.Request

Initial returns the initial http.Request.

func (RequestWriter) JsVar 

func (rw RequestWriter) JsVar(jsvarName string, jsvar any, params ...any) (err error)

JsVar binds a JsVar to a named JavaScript variable.

You can also pass a JsVarMaker instead of a JsVar.

func (RequestWriter) Label 

func (rw RequestWriter) Label(innerHTML any, params ...any) error

Label renders an HTML label element.

func (RequestWriter) Li 

func (rw RequestWriter) Li(innerHTML any, params ...any) error

Li renders an HTML list item.

func (RequestWriter) Number 

func (rw RequestWriter) Number(value any, params ...any) error

Number renders an HTML number input.

func (RequestWriter) Password 

func (rw RequestWriter) Password(value any, params ...any) error

Password renders an HTML password input.

func (RequestWriter) Radio 

func (rw RequestWriter) Radio(value any, params ...any) error

Radio renders an HTML radio input.

func (RequestWriter) RadioGroup 

func (rw RequestWriter) RadioGroup(nba *named.BoolArray) (rel []RadioElement)

RadioGroup creates radio and label elements for each value in nba.

func (RequestWriter) Range 

func (rw RequestWriter) Range(value any, params ...any) error

Range renders an HTML range input.

func (RequestWriter) Register 

func (rw RequestWriter) Register(updater jaws.Updater, params ...any) jid.Jid

Register creates a new Element with the given Updater as a tag for dynamic updates. Additional tags may be provided in params. The updater's jaws.Updater.JawsUpdate method will be called immediately to ensure the initial rendering is correct.

Returns a jid.Jid, suitable for including as an HTML id attribute: 

<div id="{{$.Register .MyUpdater}}">...</div>

func (RequestWriter) Select 

func (rw RequestWriter) Select(sh named.SelectHandler, params ...any) error

Select renders an HTML select element.

func (RequestWriter) Session 

func (rw RequestWriter) Session() *jaws.Session

Session returns the request's jaws.Session, or nil.

func (RequestWriter) Set 

func (rw RequestWriter) Set(key string, value any)

Set calls jaws.Request.Set.

func (RequestWriter) Span 

func (rw RequestWriter) Span(innerHTML any, params ...any) error

Span renders an HTML span element.

func (RequestWriter) TailHTML 

func (rw RequestWriter) TailHTML() error

TailHTML writes optional HTML code at the end of the page's BODY section that will immediately apply updates made during initial rendering.

func (RequestWriter) Tbody 

func (rw RequestWriter) Tbody(c jaws.Container, params ...any) error

Tbody renders an HTML tbody element.

func (RequestWriter) Td 

func (rw RequestWriter) Td(innerHTML any, params ...any) error

Td renders an HTML table cell.

func (RequestWriter) Template 

func (rw RequestWriter) Template(name string, dot any, params ...any) error

Template renders the given template using With as data.

The Dot field in With is set to dot, and name is resolved to a template.Template using jaws.Jaws.LookupTemplate. Template output is wrapped in a generated div that owns the JaWS ID and any HTML attrs passed in params. The template must be a partial, not a full HTML document.

func (RequestWriter) Text 

func (rw RequestWriter) Text(value any, params ...any) error

Text renders an HTML text input.

func (RequestWriter) Textarea 

func (rw RequestWriter) Textarea(value any, params ...any) error

Textarea renders an HTML textarea.

func (RequestWriter) Tr 

func (rw RequestWriter) Tr(innerHTML any, params ...any) error

Tr renders an HTML table row.

func (RequestWriter) UI 

func (rw RequestWriter) UI(ui jaws.UI, params ...any) (err error)

UI creates an element for ui and renders it to the underlying writer.

func (RequestWriter) Write 

func (rw RequestWriter) Write(p []byte) (n int, err error)

Write records that rendering has started, then writes p to the underlying writer.

type Select 

type Select struct {
	ContainerHelper
}

Select renders an HTML select element backed by a named.SelectHandler.

func NewSelect 

func NewSelect(sh named.SelectHandler) *Select

NewSelect returns a select widget backed by sh.

func (*Select) JawsInput added in v0.401.0 

func (u *Select) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput stores a browser-side select value.

func (*Select) JawsRender 

func (u *Select) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML select element.

func (*Select) JawsUpdate 

func (u *Select) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the selected value and child options.

type SetPather 

type SetPather interface {
	// JawsPathSet notifies that a JSON object member identified by jsPath has been set
	// to the given value and the change has been queued for broadcast.
	JawsPathSet(elem *jaws.Element, jsPath string, value any)
}

SetPather is notified after a nested JSON path value has been set and broadcast.

type Span 

type Span struct{ HTMLInner }

Span renders an HTML span element with dynamic inner HTML.

func NewSpan 

func NewSpan(innerHTML any) *Span

NewSpan returns a span widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Span) JawsRender 

func (u *Span) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML span element.

type Tbody 

type Tbody struct {
	ContainerHelper
}

Tbody renders an HTML tbody containing dynamic child rows.

func NewTbody 

func NewTbody(c jaws.Container) *Tbody

NewTbody returns a tbody widget that renders and updates c as table rows.

func (*Tbody) JawsRender 

func (u *Tbody) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML tbody element.

func (*Tbody) JawsUpdate 

func (u *Tbody) JawsUpdate(elem *jaws.Element)

JawsUpdate updates the child rows.

type Td 

type Td struct{ HTMLInner }

Td renders an HTML table cell with dynamic inner HTML.

func NewTd 

func NewTd(innerHTML any) *Td

NewTd returns a table cell widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Td) JawsRender 

func (u *Td) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML table cell.

type Template 

type Template struct {
	Name string // Template name to be looked up using Jaws.LookupTemplate.
	Dot  any    // Dot value to place in With.
}

Template references a Go html/template template to be rendered through JaWS.

The Name field identifies the template to execute and Dot contains the data that will be exposed to the template through the With structure constructed during rendering. Templates are rendered inside a generated wrapper element that receives the JaWS ID and any HTML attributes supplied at render time through the RequestWriter.Template helper. The referenced template must be a partial template, not a full HTML document.

func NewTemplate 

func NewTemplate(name string, dot any) Template

NewTemplate constructs a Template with the provided name and data value.

It is a small helper that makes it convenient to use Template values with other JaWS helpers without having to fill the struct fields manually.

func (Template) JawsClick added in v0.401.0 

func (tmpl Template) JawsClick(elem *jaws.Element, click jaws.Click) (err error)

JawsClick delegates click events to t.Dot when it implements jaws.ClickHandler.

func (Template) JawsContextMenu added in v0.401.0 

func (tmpl Template) JawsContextMenu(elem *jaws.Element, click jaws.Click) (err error)

JawsContextMenu delegates context-menu events to t.Dot when it implements jaws.ContextMenuHandler.

func (Template) JawsInput added in v0.401.0 

func (tmpl Template) JawsInput(elem *jaws.Element, value string) (err error)

JawsInput delegates input events to t.Dot when it implements jaws.InputHandler.

func (Template) JawsRender 

func (tmpl Template) JawsRender(elem *jaws.Element, w io.Writer, params []any) (err error)

JawsRender renders t through the request's configured template lookupers.

func (Template) JawsUpdate 

func (tmpl Template) JawsUpdate(elem *jaws.Element)

JawsUpdate re-renders t into the template wrapper.

Lookup or execution errors are reported through jaws.Request.MustLog, which may panic when no jaws.Jaws.Logger is configured.

func (Template) String 

func (tmpl Template) String() string

String returns a debug representation of t.

type Text 

type Text struct{ InputText }

Text renders an HTML text input bound to a string setter.

func NewText 

func NewText(vp bind.Setter[string]) *Text

NewText returns a text input widget bound to vp.

func (*Text) JawsRender 

func (u *Text) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML text input.

type Textarea 

type Textarea struct{ InputText }

Textarea renders an HTML textarea bound to a string setter.

func NewTextarea 

func NewTextarea(g bind.Setter[string]) *Textarea

NewTextarea returns a textarea widget bound to g.

func (*Textarea) JawsRender 

func (u *Textarea) JawsRender(elem *jaws.Element, w io.Writer, params []any) (err error)

JawsRender renders ui as an HTML textarea.

type Tr 

type Tr struct{ HTMLInner }

Tr renders an HTML table row with dynamic inner HTML.

func NewTr 

func NewTr(innerHTML any) *Tr

NewTr returns a table row widget whose inner HTML is rendered from innerHTML. innerHTML is passed to bind.MakeHTMLGetter; plain strings are trusted HTML.

func (*Tr) JawsRender 

func (u *Tr) JawsRender(elem *jaws.Element, w io.Writer, params []any) error

JawsRender renders ui as an HTML table row.

type With 

type With struct {
	*jaws.Element           // the Element being rendered using a template
	RequestWriter           // the RequestWriter for nested UI helpers
	Dot           any       // user data parameter
	Auth          jaws.Auth // optional authentication information returned by MakeAuthFn
}

With is passed as the data parameter when using RequestWriter.Template, populated with all required members set.

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.