tomo-old/elements/container.go

package elements

import "git.tebibyte.media/sashakoshka/tomo/input"

// Parent represents a type capable of containing child elements.
type Parent interface {
	// NotifyMinimumSizeChange notifies the container that a child element's
	// minimum size has changed. This method is expected to be called by
	// child elements when their minimum size changes.
	NotifyMinimumSizeChange (child Element)
}

// FocusableParent represents a parent with keyboard navigation support.
type FocusableParent interface {
	Parent
	
	// RequestFocus notifies the parent that a child element is requesting
	// keyboard focus. If the parent grants the request, the method will
	// return true and the child element should behave as if a HandleFocus
	// call was made.
	RequestFocus (child Focusable, direction input.KeynavDirection) (granted bool)
}

// FlexibleParent represents a parent that accounts for elements with
// flexible height.
type FlexibleParent interface {
	Parent

	// NotifyFlexibleHeightChange notifies the parent that the parameters
	// affecting a child's flexible height have changed. This method is
	// expected to be called by flexible child element when their content
	// changes.
	NotifyFlexibleHeightChange (child Flexible)
}

// ScrollableParent represents a parent that can change the scroll
// position of its child element(s).
type ScrollableParent interface {
	Parent
	
	// NotifyScrollBoundsChange notifies the parent that a child's scroll
	// content bounds or viewport bounds have changed. This is expected to
	// be called by child elements when they change their supported scroll
	// axes, their scroll position (either autonomously or as a result of a
	// call to ScrollTo()), or their content size.
	NotifyScrollBoundsChange (child Scrollable)
}