Monomer.Widgets.Containers.Dropdown

Dropdown widget, allowing selection of a single item from a collapsable list. Both header and list content are customizable, and so is their styling.

In case only Text content is needed, Monomer.Widgets.Singles.TextDropdown is easier to use.

makeSelected username = hstack [
    label "Selected: ",
    spacer,
    label username
  ]
makeRow username = label username

customDropdown = dropdown userLens usernames makeSelected makeRow

Configuration

data DropdownCfg s e a

Configuration options for dropdown:

• onFocus: event to raise when focus is received.
• onFocusReq: WidgetRequest to generate when focus is received.
• onBlur: event to raise when focus is lost.
• onBlurReq: WidgetRequest to generate when focus is lost.
• onChange: event to raise when selected item changes.
• onChangeReq: WidgetRequest to generate when selected item changes.
• onChangeIdx: event to raise when selected item changes. Includes index,
• onChangeIdxReq: WidgetRequest to generate when selected item changes. Includes index.
• maxHeight: maximum height of the list when dropdown is expanded.
• itemBasicStyle: Style of an item in the list when not selected.
• itemSelectedStyle: Style of the selected item in the list.

Instances

Semigroup (DropdownCfg s e a)

Defined in Monomer.Widgets.Containers.Dropdown

Methods

(<>) :: DropdownCfg s e a -> DropdownCfg s e a -> DropdownCfg s e a

sconcat :: NonEmpty (DropdownCfg s e a) -> DropdownCfg s e a

stimes :: Integral b => b -> DropdownCfg s e a -> DropdownCfg s e a

Monoid (DropdownCfg s e a)

Defined in Monomer.Widgets.Containers.Dropdown

Methods

mempty :: DropdownCfg s e a

mappend :: DropdownCfg s e a -> DropdownCfg s e a -> DropdownCfg s e a

mconcat :: [DropdownCfg s e a] -> DropdownCfg s e a

Default (DropdownCfg s e a)

Defined in Monomer.Widgets.Containers.Dropdown

Methods

def :: DropdownCfg s e a

CmbMaxHeight (DropdownCfg s e a)

Defined in Monomer.Widgets.Containers.Dropdown

Methods

maxHeight :: Double -> DropdownCfg s e a

CmbItemSelectedStyle (DropdownCfg s e a) Style

Defined in Monomer.Widgets.Containers.Dropdown

Methods

itemSelectedStyle :: Style -> DropdownCfg s e a

CmbItemBasicStyle (DropdownCfg s e a) Style

Defined in Monomer.Widgets.Containers.Dropdown

Methods

itemBasicStyle :: Style -> DropdownCfg s e a

WidgetEvent e => CmbOnChangeIdx (DropdownCfg s e a) e a

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onChangeIdx :: (Int -> a -> e) -> DropdownCfg s e a

WidgetEvent e => CmbOnChange (DropdownCfg s e a) a e

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onChange :: (a -> e) -> DropdownCfg s e a

WidgetEvent e => CmbOnBlur (DropdownCfg s e a) e Path

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onBlur :: (Path -> e) -> DropdownCfg s e a

WidgetEvent e => CmbOnFocus (DropdownCfg s e a) e Path

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onFocus :: (Path -> e) -> DropdownCfg s e a

CmbOnChangeIdxReq (DropdownCfg s e a) s e a

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onChangeIdxReq :: (Int -> a -> WidgetRequest s e) -> DropdownCfg s e a

CmbOnChangeReq (DropdownCfg s e a) s e a

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onChangeReq :: (a -> WidgetRequest s e) -> DropdownCfg s e a

CmbOnBlurReq (DropdownCfg s e a) s e Path

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onBlurReq :: (Path -> WidgetRequest s e) -> DropdownCfg s e a

CmbOnFocusReq (DropdownCfg s e a) s e Path

Defined in Monomer.Widgets.Containers.Dropdown

Methods

onFocusReq :: (Path -> WidgetRequest s e) -> DropdownCfg s e a

type DropdownItem a = SelectListItem a

Constraints for an item handled by dropdown.

Constructors

dropdown

Arguments

:: (WidgetModel s, WidgetEvent e, Traversable t, DropdownItem a)

=> ALens' s a

The lens into the model.

-> t a

The list of selectable items.

-> (a -> WidgetNode s e)

Function to create the header (always visible).

-> (a -> WidgetNode s e)

Function to create the list (collapsable).

-> WidgetNode s e

The created dropdown.

Creates a dropdown using the given lens.

dropdown_

Arguments

:: (WidgetModel s, WidgetEvent e, Traversable t, DropdownItem a)

=> ALens' s a

The lens into the model.

-> t a

The list of selectable items.

-> (a -> WidgetNode s e)

Function to create the header (always visible).

-> (a -> WidgetNode s e)

Function to create the list (collapsable).

-> [DropdownCfg s e a]

The config options.

-> WidgetNode s e

The created dropdown.

Creates a dropdown using the given lens. Accepts config.

dropdownV

Arguments

:: (WidgetModel s, WidgetEvent e, Traversable t, DropdownItem a)

=> a

The current value.

-> (Int -> a -> e)

The event to raise on change.

-> t a

The list of selectable items.

-> (a -> WidgetNode s e)

Function to create the header (always visible).

-> (a -> WidgetNode s e)

Function to create the list (collapsable).

-> WidgetNode s e

The created dropdown.

Creates a dropdown using the given value and onChange event handler.

dropdownV_

Arguments

:: (WidgetModel s, WidgetEvent e, Traversable t, DropdownItem a)

=> a

The current value.

-> (Int -> a -> e)

The event to raise on change.

-> t a

The list of selectable items.

-> (a -> WidgetNode s e)

Function to create the header (always visible).

-> (a -> WidgetNode s e)

Function to create the list (collapsable).

-> [DropdownCfg s e a]

The config options.

-> WidgetNode s e

The created dropdown.

Creates a dropdown using the given value and onChange event handler. | Accepts config.

dropdownD_

Arguments

:: forall s e t a. (WidgetModel s, WidgetEvent e, Traversable t, DropdownItem a)

=> WidgetData s a

The WidgetData to retrieve the value from.

-> t a

The list of selectable items.

-> (a -> WidgetNode s e)

Function to create the header (always visible).

-> (a -> WidgetNode s e)

Function to create the list (collapsable).

-> [DropdownCfg s e a]

The config options.

-> WidgetNode s e

The created dropdown.

Creates a dropdown providing a WidgetData instance and config.