Select: dropdown selection

Build dropdowns with Select. This page includes a runnable example, all props, and behavior constraints.

Complete example

Complete environment setup first. Copy this complete main.go and run go run ..

package main

import (
	"github.com/dxui-org/dxui"
	"log"
)

func main() {
	value := "go"
	app := dxui.NewApp(dxui.AppOptions{
		Title:      "Select",
		Width:      640,
		Height:     480,
		Background: dxui.RGBA(248, 250, 252, 255),
	})
	if err := app.Run(func() dxui.View {
		return dxui.Box(
			dxui.BoxProps{
				Gap: 16,
				Style: dxui.Style{
					Padding: dxui.Padding(24),
				},
			},
			dxui.Select(dxui.SelectProps{
				Value:       value,
				OnChange:    dxui.Assign(&value),
				Placeholder: "Choose",
				Options: []dxui.SelectOption{
					{
						Value: "go",
						Label: "Go",
					},
					{
						Value: "rust",
						Label: "Rust",
					},
					{
						Value:    "later",
						Label:    "Later",
						Disabled: true,
					},
				},
			}),
		)
	}); err != nil {

		log.Fatal(err)
	}
}

Parameters and API

func Select(props SelectProps) View

Field	Type	Purpose, defaults, and constraints
Key	string	Stable unique identity within one parent; empty by default. Use business IDs in dynamic lists, not changing indices.
Style	Style	Local layout, paint, and text styling; zero uses intrinsic sizes and theme defaults.
Token	ComponentToken	Component theme entry; empty selects its default.
States	StateStyles	Paint patches for actual interaction states; cannot fabricate state or change layout.
Pointer	PointerBehavior	Defaults to PointerAuto; PointerNone excludes the entire subtree from pointer participation, unlike Disabled.
Value	string	Current application-owned value; see this page for behavior and zero-value semantics.
Options	[]SelectOption	Copied option list; nonempty unique values, at most 4096 items.
Placeholder	string	Displayed for an empty Value; defaults to empty.
Disabled	bool	Defaults to false; true removes focus and cancels interaction on interactive components.
OnChange	func(string)	Proposes the complete new value; write it to state for the next build. See behavior for nil callbacks.

Behavior and limitations

Option Value must be nonempty and unique for reorder identity. Empty lists and unmatched Value are supported. Nil OnChange still permits opening, browsing, and closing without accepting a selection. Enter/Space, arrows, Home/End, Escape, and Tab are supported; disabled options are skipped. The overlay escapes ancestor Scroll clipping and flips/clamps at window edges. Not a native system selector or virtualized list; at most 4096 items.

All components share identity, style, and pointer rules. See full declarations for referenced enums, structs, and comments. Running examples explains build verification.