Documentation
¶
Overview ¶
Package layout builds a simple visual tree from the Growse DOM.
Index ¶
- func ApplyAnimatedStyles(tree *Tree, styles stylemodel.Map)
- func ApplyScrollOffset(tree *Tree, styles stylemodel.Map, scrollX, scrollY float32) []dom.NodeID
- func HitTest(tree *Tree, x, y float32) (dom.NodeID, bool)
- func ReuseStableFragments(previous, current *Tree, dirty map[dom.NodeID]bool) int
- type BorderRadii
- type Box
- type ClipRegion
- type CompositingLayer
- type CornerRadius
- type Decoration
- type Fallback
- type FontRange
- type FontSet
- type Hit
- type ImageResource
- type LayerReason
- type PaintEntry
- type Rect
- type StackingContext
- type TextRun
- type Tree
- func Build(document *dom.Document, computed stylemodel.Map, viewportWidth float32) *Tree
- func BuildAtRevision(document *dom.Document, computed stylemodel.Map, viewportWidth float32, ...) *Tree
- func BuildWithScroll(document *dom.Document, computed stylemodel.Map, ...) *Tree
- func BuildWithScrollAndImages(document *dom.Document, computed stylemodel.Map, ...) *Tree
- func BuildWithScrollAndResources(document *dom.Document, computed stylemodel.Map, ...) *Tree
- func BuildWithScrollAtRevision(document *dom.Document, computed stylemodel.Map, ...) *Tree
- func BuildWithViewport(document *dom.Document, computed stylemodel.Map, ...) *Tree
- func Clone(tree *Tree) *Tree
- type WebFontFace
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ApplyAnimatedStyles ¶
func ApplyAnimatedStyles(tree *Tree, styles stylemodel.Map)
ApplyAnimatedStyles applies paint and hit-test state to an existing layout tree without changing its geometry. Paint.Build and HitTest consequently observe the exact same transform matrix.
func ApplyScrollOffset ¶ added in v0.17.0
ApplyScrollOffset repositions only viewport-attached and sticky subtrees. Normal-flow fragments, glyph runs, and image geometry remain untouched.
Types ¶
type BorderRadii ¶
type BorderRadii struct {
TopLeft, TopRight, BottomRight, BottomLeft CornerRadius
}
BorderRadii contains resolved radii in clockwise order.
type Box ¶
type Box struct {
Order int
StackingID int
NodeID dom.NodeID
FragmentID uint64
Tag string
Text string
Input bool
Multiline bool
Select bool
Options []forms.Option
Selected int
Checkable bool
Checked bool
InputType string
Disabled bool
ReadOnly bool
Button bool
Image bool
ImageURL string
Alt string
ImageRect Rect
ImageClip Rect
ImageFailed bool
ObjectFit stylemodel.ObjectFit
ObjectPos stylemodel.BackgroundPosition
ImageBorder stylemodel.Borders
ImageRadius BorderRadii
Appearance stylemodel.Appearance
AccentColor uint32
Cursor stylemodel.Cursor
X float32
Y float32
Width float32
Height float32
Baseline float32
Clip *Rect
Clips []ClipRegion
Opacity float32
FontSize float32
Bold bool
FontFamilies []string
FontStyle string
FontStretch string
LetterSpacing float32
WordSpacing float32
VerticalOffset float32
Color uint32
Background uint32
Decoration stylemodel.TextDecorationLine
DecorationColor uint32
TextShadows []stylemodel.Shadow
Transform stylemodel.Matrix
Hidden bool
Runs []TextRun
}
Box is one line of visible page content.
type ClipRegion ¶
type ClipRegion struct {
Rect
Radius BorderRadii
}
ClipRegion is one nested rectangular or rounded clipping boundary.
type CompositingLayer ¶ added in v0.17.0
type CompositingLayer struct {
ID int
Parent int
NodeID dom.NodeID
Bounds Rect
Clip *Rect
Reasons LayerReason
Opacity float32
Transform stylemodel.Matrix
Damage []Rect
}
CompositingLayer is bounded page-owned compositor metadata. It contains no raster payload; Damage holds CSS-pixel rectangles for the next frame.
type CornerRadius ¶
type CornerRadius struct{ X, Y float32 }
CornerRadius is one resolved elliptical radius in CSS pixels.
type Decoration ¶
type Decoration struct {
Order int
StackingID int
NodeID dom.NodeID
FragmentID uint64
Rect
Background uint32
Image stylemodel.BackgroundImage
Layers []stylemodel.BackgroundLayer
Repeat stylemodel.BackgroundRepeat
Position stylemodel.BackgroundPosition
Size stylemodel.BackgroundSize
Border stylemodel.Borders
Padding stylemodel.Edges
Radius BorderRadii
Opacity float32
Clip *Rect
Clips []ClipRegion
BoxShadows []stylemodel.Shadow
Outline stylemodel.BorderSide
OutlineOffset float32
Filters []stylemodel.Filter
BackdropFilters []stylemodel.Filter
BlendMode stylemodel.BlendMode
Cursor stylemodel.Cursor
Transform stylemodel.Matrix
Hidden bool
}
Decoration is the border-box visual of one element. It is kept separately from line boxes so backgrounds can be painted before descendant content.
type Fallback ¶ added in v0.17.0
Fallback records a bounded, payload-free layout/paint safety decision.
type FontRange ¶ added in v0.15.0
type FontRange struct{ Start, End rune }
FontRange is one inclusive unicode-range interval for a web font face.
type FontSet ¶ added in v0.15.0
type FontSet struct {
// contains filtered or unexported fields
}
FontSet is an immutable page-scoped collection of decoded web fonts. Shaping is serialized because HarfbuzzShaper retains reusable buffers.
func NewFontSet ¶ added in v0.15.0
func NewFontSet(faces []WebFontFace) *FontSet
NewFontSet creates a page-scoped font collection. Invalid faces are omitted.
func NewFontSetWithSystemFallback ¶ added in v0.16.0
func NewFontSetWithSystemFallback(faces []WebFontFace) *FontSet
NewFontSetWithSystemFallback creates a page-scoped font set whose shaping falls back from decoded Web Fonts and bundled Go fonts to operating-system glyph coverage. The set remains usable when system discovery fails.
type ImageResource ¶ added in v0.15.0
type ImageResource struct {
URL string
IntrinsicWidth, IntrinsicHeight float32
Alt string
Loaded bool
Deferred bool
Error string
}
ImageResource is browser-decoded metadata for one replaced image element. Layout never fetches or decodes network content.
type LayerReason ¶ added in v0.17.0
type LayerReason uint16
LayerReason records why a node owns a compositor surface.
const ( LayerTransform LayerReason = 1 << iota LayerOpacity LayerClip LayerScroll LayerFixed LayerSticky LayerFilter )
type PaintEntry ¶
PaintEntry references one visual in final forward paint order.
type Rect ¶
type Rect struct {
X, Y, Width, Height float32
}
Rect is a document-coordinate clipping rectangle.
func UpdateCompositingLayers ¶ added in v0.17.0
func UpdateCompositingLayers(tree *Tree, styles stylemodel.Map) []Rect
UpdateCompositingLayers computes bounded damage for changed composite properties without rebuilding layout or the display list.
type StackingContext ¶
type StackingContext struct {
Parent int
NodeID dom.NodeID
ZIndex int
Order int
Opacity float32
Offscreen bool
}
StackingContext records atomic paint-order ownership.
type TextRun ¶
type TextRun struct {
NodeID dom.NodeID
Tag string
Text string
Width float32
FontSize float32
Bold bool
FontFamilies []string
FontStyle string
FontStretch string
LetterSpacing float32
WordSpacing float32
VerticalOffset float32
Color uint32
Background uint32
Baseline float32
Decoration stylemodel.TextDecorationLine
DecorationColor uint32
Opacity float32
TextShadows []stylemodel.Shadow
}
TextRun is a continuously styled fragment inside one line box.
type Tree ¶
type Tree struct {
Revision uint64
Width float32
Height float32
Background uint32
Decorations []Decoration
Boxes []Box
ScrollWidth float32
ScrollHeight float32
ScrollX float32
ScrollY float32
StackingContexts []StackingContext
CompositingLayers []CompositingLayer
Parents map[dom.NodeID]dom.NodeID
Bounds map[dom.NodeID]Rect
Fallbacks []Fallback
}
Tree is the result of laying out one document at a specific viewport width.
func BuildAtRevision ¶ added in v0.14.0
func BuildAtRevision(document *dom.Document, computed stylemodel.Map, viewportWidth float32, revision uint64) *Tree
BuildAtRevision lays out one immutable DOM/style revision.
func BuildWithScroll ¶
func BuildWithScroll(document *dom.Document, computed stylemodel.Map, viewportWidth, viewportHeight, scrollX, scrollY float32) *Tree
BuildWithScroll lays out viewport-attached and sticky elements at a scroll offset.
func BuildWithScrollAndImages ¶ added in v0.15.0
func BuildWithScrollAndImages(document *dom.Document, computed stylemodel.Map, images map[dom.NodeID]ImageResource, viewportWidth, viewportHeight, scrollX, scrollY float32) *Tree
BuildWithScrollAndImages lays out browser-decoded replaced image metadata.
func BuildWithScrollAndResources ¶ added in v0.15.0
func BuildWithScrollAndResources(document *dom.Document, computed stylemodel.Map, images map[dom.NodeID]ImageResource, fonts *FontSet, viewportWidth, viewportHeight, scrollX, scrollY float32) *Tree
BuildWithScrollAndResources lays out decoded images and page-scoped web fonts.
func BuildWithScrollAtRevision ¶ added in v0.14.0
func BuildWithScrollAtRevision(document *dom.Document, computed stylemodel.Map, viewportWidth, viewportHeight, scrollX, scrollY float32, revision uint64) *Tree
BuildWithScrollAtRevision lays out one immutable DOM/style revision at a scroll offset.
func BuildWithViewport ¶
func BuildWithViewport(document *dom.Document, computed stylemodel.Map, viewportWidth, viewportHeight float32) *Tree
BuildWithViewport lays out a document with definite viewport dimensions.
func Clone ¶
Clone returns a frame-local copy of a layout tree. Geometry can be cached while ApplyAnimatedStyles mutates paint and hit-test state on the copy.
func (*Tree) OrderedPaintEntries ¶
func (t *Tree) OrderedPaintEntries() []PaintEntry
OrderedPaintEntries returns the shared paint and hit-test ordering.