nebula/pkg/wa/drawer.templ

// Code generated by wa-generator. DO NOT EDIT.
// Source: Web Awesome wa-drawer

package wa

import (
	"github.com/a-h/templ"
)

// Drawers slide in from a container to expose additional options and information.
//
// Web Awesome component: <wa-drawer>

// DrawerProps holds all properties for the wa-drawer component
type DrawerProps struct {
	// Indicates whether or not the drawer is open. Toggle this attribute to show and hide the drawer.
	Open bool `attr:"open"`
	// The drawer's label as displayed in the header. You should always include a relevant label, as it is required for
	Label string `attr:"label"`
	// The direction from which the drawer will open.
	// Valid values: "top", "end", "bottom", "start"
	Placement string `attr:"placement"`
	// Disables the header. This will also remove the default close button.
	WithoutHeader bool `attr:"without-header"`
	// When enabled, the drawer will be closed when the user clicks outside of it.
	LightDismiss bool `attr:"light-dismiss"`

	// Events
	// Emitted when the drawer opens.
	OnShow string `attr:"x-on:wa-show"`
	// Emitted after the drawer opens and all animations are complete.
	OnAfterShow string `attr:"x-on:wa-after-show"`
	// Emitted when the drawer is requesting to close. Calling event.preventDefault() will prevent the drawer from closing. ...
	OnHide string `attr:"x-on:wa-hide"`
	// Emitted after the drawer closes and all animations are complete.
	OnAfterHide string `attr:"x-on:wa-after-hide"`

	// Slots contains named slot content
	Slots DrawerSlots

	// Attrs contains additional HTML attributes
	Attrs templ.Attributes
}

// DrawerSlots holds named slot content for the component
type DrawerSlots struct {
	// The drawer's label. Alternatively, you can use the label attribute.
	Label templ.Component
	// Optional actions to add to the header. Works best with <wa-button>.
	HeaderActions templ.Component
	// The drawer's footer, usually one or more buttons representing various options.
	Footer templ.Component
}

// DrawerBuilder provides a fluent API for constructing DrawerProps
type DrawerBuilder struct {
	props DrawerProps
}

// NewDrawer creates a new builder for wa-drawer
func NewDrawer() *DrawerBuilder {
	return &DrawerBuilder{}
}

// Open sets the open attribute
// Indicates whether or not the drawer is open. Toggle this attribute to show and hide the drawer.
func (b *DrawerBuilder) Open(v bool) *DrawerBuilder {
	b.props.Open = v
	return b
}

// Label sets the label attribute
// The drawer's label as displayed in the header. You should always include a relevant label, as it is required for
func (b *DrawerBuilder) Label(v string) *DrawerBuilder {
	b.props.Label = v
	return b
}

// Placement sets the placement attribute
// The direction from which the drawer will open.
func (b *DrawerBuilder) Placement(v string) *DrawerBuilder {
	b.props.Placement = v
	return b
}

// WithoutHeader sets the without-header attribute
// Disables the header. This will also remove the default close button.
func (b *DrawerBuilder) WithoutHeader(v bool) *DrawerBuilder {
	b.props.WithoutHeader = v
	return b
}

// LightDismiss sets the light-dismiss attribute
// When enabled, the drawer will be closed when the user clicks outside of it.
func (b *DrawerBuilder) LightDismiss(v bool) *DrawerBuilder {
	b.props.LightDismiss = v
	return b
}

// OnShow sets the handler for wa-show event
// Emitted when the drawer opens.
func (b *DrawerBuilder) OnShow(handler string) *DrawerBuilder {
	b.props.OnShow = handler
	return b
}

// OnAfterShow sets the handler for wa-after-show event
// Emitted after the drawer opens and all animations are complete.
func (b *DrawerBuilder) OnAfterShow(handler string) *DrawerBuilder {
	b.props.OnAfterShow = handler
	return b
}

// OnHide sets the handler for wa-hide event
// Emitted when the drawer is requesting to close. Calling event.preventDefault() will prevent the drawer from closing. ...
func (b *DrawerBuilder) OnHide(handler string) *DrawerBuilder {
	b.props.OnHide = handler
	return b
}

// OnAfterHide sets the handler for wa-after-hide event
// Emitted after the drawer closes and all animations are complete.
func (b *DrawerBuilder) OnAfterHide(handler string) *DrawerBuilder {
	b.props.OnAfterHide = handler
	return b
}

// LabelSlot sets the label slot content
// The drawer's label. Alternatively, you can use the label attribute.
func (b *DrawerBuilder) LabelSlot(c templ.Component) *DrawerBuilder {
	b.props.Slots.Label = c
	return b
}

// HeaderActionsSlot sets the header-actions slot content
// Optional actions to add to the header. Works best with <wa-button>.
func (b *DrawerBuilder) HeaderActionsSlot(c templ.Component) *DrawerBuilder {
	b.props.Slots.HeaderActions = c
	return b
}

// FooterSlot sets the footer slot content
// The drawer's footer, usually one or more buttons representing various options.
func (b *DrawerBuilder) FooterSlot(c templ.Component) *DrawerBuilder {
	b.props.Slots.Footer = c
	return b
}

// Attr adds a custom HTML attribute
func (b *DrawerBuilder) Attr(name, value string) *DrawerBuilder {
	if b.props.Attrs == nil {
		b.props.Attrs = templ.Attributes{}
	}
	b.props.Attrs[name] = value
	return b
}

// Attrs merges multiple attributes
func (b *DrawerBuilder) Attrs(attrs templ.Attributes) *DrawerBuilder {
	if b.props.Attrs == nil {
		b.props.Attrs = templ.Attributes{}
	}
	for k, v := range attrs {
		b.props.Attrs[k] = v
	}
	return b
}

// Props returns the built properties
func (b *DrawerBuilder) Props() DrawerProps {
	return b.props
}

// Build returns the props (alias for Props for semantic clarity)
func (b *DrawerBuilder) Build() DrawerProps {
	return b.props
}

// Drawer renders the wa-drawer component
templ Drawer(props DrawerProps) {
	<wa-drawer
		if props.Open {
			open
		}
		if props.Label != "" {
			label={ props.Label }
		}
		if props.Placement != "" {
			placement={ props.Placement }
		}
		if props.WithoutHeader {
			without-header
		}
		if props.LightDismiss {
			light-dismiss
		}
		if props.OnShow != "" {
			x-on:wa-show={ props.OnShow }
		}
		if props.OnAfterShow != "" {
			x-on:wa-after-show={ props.OnAfterShow }
		}
		if props.OnHide != "" {
			x-on:wa-hide={ props.OnHide }
		}
		if props.OnAfterHide != "" {
			x-on:wa-after-hide={ props.OnAfterHide }
		}
		{ props.Attrs... }
	>
		if props.Slots.Label != nil {
			<div slot="label">
				@props.Slots.Label
			</div>
		}
		if props.Slots.HeaderActions != nil {
			<div slot="header-actions">
				@props.Slots.HeaderActions
			</div>
		}
		if props.Slots.Footer != nil {
			<div slot="footer">
				@props.Slots.Footer
			</div>
		}
		{ children... }
	</wa-drawer>
}

// DrawerFunc renders with a builder function for inline configuration
templ DrawerFunc(fn func(*DrawerBuilder)) {
	{{ b := NewDrawer(); fn(b) }}
	@Drawer(b.Props()) {
		{ children... }
	}
}