mirror of
https://github.com/mum4k/termdash.git
synced 2025-04-27 13:48:49 +08:00
114 lines
3.0 KiB
Go
114 lines
3.0 KiB
Go
/*
|
|
Package container defines a type that wraps other containers or widgets.
|
|
|
|
The container supports splitting container into sub containers, defining
|
|
container styles and placing widgets. The container also creates and manages
|
|
canvases assigned to the placed widgets.
|
|
*/
|
|
package container
|
|
|
|
import (
|
|
"github.com/mum4k/termdash/terminalapi"
|
|
"github.com/mum4k/termdash/widget"
|
|
)
|
|
|
|
// Container wraps either sub containers or widgets and positions them on the
|
|
// terminal.
|
|
type Container struct {
|
|
// parent is the parent container, nil if this is the root container.
|
|
parent *Container
|
|
// The sub containers, if these aren't nil, the widget must be.
|
|
first *Container
|
|
second *Container
|
|
|
|
// term is the terminal this container is placed on.
|
|
term terminalapi.Terminal
|
|
|
|
// split identifies how is this container split.
|
|
split splitType
|
|
|
|
// widget is the widget in the container.
|
|
// A container can have either two sub containers (left and right) or a
|
|
// widget. But not both.
|
|
widget widget.Widget
|
|
|
|
// Alignment of the widget if present.
|
|
hAlign hAlignType
|
|
vAlign vAlignType
|
|
}
|
|
|
|
// New returns a new root container that will use the provided terminal and
|
|
// applies the provided options.
|
|
func New(t terminalapi.Terminal, opts ...Option) *Container {
|
|
c := &Container{
|
|
term: t,
|
|
}
|
|
|
|
for _, opt := range opts {
|
|
opt.set(c)
|
|
}
|
|
return c
|
|
}
|
|
|
|
// Returns the parent container of this container.
|
|
// Returns nil if this container is the root of the container tree.
|
|
func (c *Container) Parent(opts ...Option) *Container {
|
|
if c == nil || c.parent == nil {
|
|
return nil
|
|
}
|
|
|
|
p := c.parent
|
|
for _, opt := range opts {
|
|
opt.set(p)
|
|
}
|
|
return p
|
|
}
|
|
|
|
// First returns the first sub container of this container.
|
|
// This is the left sub container when using SplitVertical() or the top sub
|
|
// container when using SplitHorizontal().
|
|
// If this container doesn't have the first sub container yet, it will be
|
|
// created. Applies the provided options to the first sub container.
|
|
// Returns nil if this container contains a widget, containers with widgets
|
|
// cannot have sub containers.
|
|
func (c *Container) First(opts ...Option) *Container {
|
|
if c == nil || c.widget != nil {
|
|
return nil
|
|
}
|
|
|
|
if child := c.first; child != nil {
|
|
for _, opt := range opts {
|
|
opt.set(child)
|
|
}
|
|
return child
|
|
}
|
|
|
|
c.first = New(c.term, opts...)
|
|
c.first.parent = c
|
|
return c.first
|
|
}
|
|
|
|
// Second returns the second sub container of this container.
|
|
// This is the left sub container when using SplitVertical() or the top sub
|
|
// container when using SplitHorizontal().
|
|
// If this container doesn't have the second sub container yet, it will be
|
|
// created. Applies the provided options to the second sub container.
|
|
// Returns nil if this container contains a widget, containers with widgets
|
|
// cannot have sub containers.
|
|
func (c *Container) Second(opts ...Option) *Container {
|
|
if c == nil || c.widget != nil {
|
|
return nil
|
|
}
|
|
|
|
if child := c.second; child != nil {
|
|
for _, opt := range opts {
|
|
opt.set(child)
|
|
}
|
|
return child
|
|
}
|
|
|
|
c.second = New(c.term, opts...)
|
|
c.second.parent = c
|
|
return c.second
|
|
}
|