engine

package
v0.0.0-...-ba0b20d Latest Latest
Warning

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

Go to latest
Published: Feb 27, 2026 License: GPL-3.0 Imports: 16 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Element

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

Element is the universal DOM-like node. Every UI element is an Element. It implements widget.Widget and renders entirely from attributes. Based on its attributes, it can behave as any widget: button, text input, checkbox, slider, container, etc.

func BuildMenuPopup

func BuildMenuPopup(menu *Element, closeFn func()) (*Element, int, int, bool)

BuildMenuPopup clones a menu subtree and returns popup content plus dimensions.

func NewElement

func NewElement(tag string) *Element

NewElement creates a new Element with the given tag.

func (*Element) AddChild

func (e *Element) AddChild(child *Element)

AddChild adds a child element.

func (*Element) Attr

func (e *Element) Attr(name, def string) string

Attr returns the string attribute or default.

func (*Element) AttrBool

func (e *Element) AttrBool(name string, def bool) bool

AttrBool returns a boolean attribute or default.

func (*Element) AttrColor

func (e *Element) AttrColor(name string, def graphics.Color) graphics.Color

AttrColor returns a color attribute or default.

func (*Element) AttrFloat

func (e *Element) AttrFloat(name string, def float64) float64

AttrFloat returns a float attribute or default.

func (*Element) AttrInt

func (e *Element) AttrInt(name string, def int) int

AttrInt returns an integer attribute or default.

func (*Element) BindSignal

func (e *Element) BindSignal(name string, fn interface{}) bool

BindSignal binds a runtime signal handler (for example "clicked").

func (*Element) Bounds

func (e *Element) Bounds() graphics.Rect

func (*Element) ChildElements

func (e *Element) ChildElements() []*Element

ChildElements returns child elements.

func (*Element) Children

func (e *Element) Children() []gapp.Widget

Children returns child widgets (for app.App damage tracking).

func (*Element) ClearChildren

func (e *Element) ClearChildren()

ClearChildren removes all child elements.

func (*Element) DirtyRects

func (e *Element) DirtyRects() []graphics.Rect

DirtyRects returns optional subregions that should be redrawn for this widget. Nil means repaint the full widget bounds.

func (*Element) Draw

func (e *Element) Draw(buf *graphics.Buffer)

func (*Element) EmitSignal

func (e *Element) EmitSignal(name string, args ...interface{})

EmitSignal emits a signal by name with optional args.

func (*Element) FindChild

func (e *Element) FindChild(id string) *Element

FindChild finds a descendant by id (depth-first).

func (*Element) GetAttribute

func (e *Element) GetAttribute(name string) string

GetAttribute returns an attribute value.

func (*Element) HandleEvent

func (e *Element) HandleEvent(ev graphics.Event) bool

func (*Element) HasAttribute

func (e *Element) HasAttribute(name string) bool

HasAttribute reports whether the attribute key exists.

func (*Element) ID

func (e *Element) ID() string

ID returns the element's id.

func (*Element) IsDirty

func (e *Element) IsDirty() bool

func (*Element) IsFocused

func (e *Element) IsFocused() bool

func (*Element) IsVisible

func (e *Element) IsVisible() bool

func (*Element) MarkClean

func (e *Element) MarkClean()

func (*Element) MarkDirty

func (e *Element) MarkDirty()

func (*Element) MinSize

func (e *Element) MinSize() graphics.Point

func (*Element) ScrollTextAreaToBottom

func (e *Element) ScrollTextAreaToBottom()

ScrollTextAreaToBottom moves the multiline viewport to the newest lines.

func (*Element) SelfDirty

func (e *Element) SelfDirty() bool

func (*Element) SetAttribute

func (e *Element) SetAttribute(name string, value interface{})

SetAttribute sets an attribute value and marks dirty.

func (*Element) SetBounds

func (e *Element) SetBounds(r graphics.Rect)

func (*Element) SetFocused

func (e *Element) SetFocused(focused bool)

func (*Element) SetID

func (e *Element) SetID(id string)

SetID updates the element id.

func (*Element) SetTerminalBuffer

func (e *Element) SetTerminalBuffer(lines [][]TerminalCell, cursorCol, cursorRow int, showCursor bool)

SetTerminalBuffer updates a multiline element with terminal-styled cells. It keeps the text-area scroll state while replacing its backing lines.

func (*Element) SetVisible

func (e *Element) SetVisible(visible bool)

func (*Element) Tag

func (e *Element) Tag() string

Tag returns the element's tag name.

func (*Element) TextAreaAtBottom

func (e *Element) TextAreaAtBottom(threshold int) bool

TextAreaAtBottom reports whether the current multiline viewport is at the end.

type TerminalCell

type TerminalCell struct {
	Char      rune
	Fg        graphics.Color
	Bg        graphics.Color
	Underline bool
}

TerminalCell holds one terminal glyph with resolved foreground/background colors.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL