Monomer.Widgets.Singles.NumericField

Input field for numeric types, with support for valid ranges and decimal places.

numericField numericLens

With configuration options:

numericField_ numericLens [minValue 0, maxValue 100, decimals 2]

Supports instances of the FromFractional typeclass. Several basic types are implemented, both for integer and floating point types.

Handles mouse wheel and shift + vertical drag to increase/decrease the number.

Configuration

data NumericFieldCfg s e a

Configuration options for numericField:

• validInput: field indicating if the current input is valid. Useful to show warnings in the UI, or disable buttons if needed.
• resizeOnChange: Whether input causes ResizeWidgets requests.
• selectOnFocus: Whether all input should be selected when focus is received.
• readOnly: Whether to prevent the user changing the input text.
• minValue: Minimum valid number.
• maxValue: Maximum valid number.
• wheelRate: The rate at which wheel movement affects the number.
• dragRate: The rate at which drag movement affects the number.
• 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 the value changes.
• onChangeReq: WidgetRequest to generate when the value changes.
• decimals: the maximum number of digits after the decimal separator. Defaults to zero for integers and two for floating point types.

Instances

Semigroup (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

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

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

Monoid (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

mempty :: NumericFieldCfg s e a

mappend :: NumericFieldCfg s e a -> NumericFieldCfg s e a -> NumericFieldCfg s e a

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

Default (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

def :: NumericFieldCfg s e a

CmbDecimals (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

decimals :: Int -> NumericFieldCfg s e a

CmbResizeOnChange (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

resizeOnChange :: NumericFieldCfg s e a

resizeOnChange_ :: Bool -> NumericFieldCfg s e a

CmbReadOnly (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

readOnly :: NumericFieldCfg s e a

readOnly_ :: Bool -> NumericFieldCfg s e a

CmbSelectOnFocus (NumericFieldCfg s e a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

selectOnFocus :: NumericFieldCfg s e a

selectOnFocus_ :: Bool -> NumericFieldCfg s e a

CmbCaretMs (NumericFieldCfg s e a) Millisecond

Defined in Monomer.Widgets.Singles.NumericField

Methods

caretMs :: Millisecond -> NumericFieldCfg s e a

CmbCaretWidth (NumericFieldCfg s e a) Double

Defined in Monomer.Widgets.Singles.NumericField

Methods

caretWidth :: Double -> NumericFieldCfg s e a

CmbWheelRate (NumericFieldCfg s e a) Double

Defined in Monomer.Widgets.Singles.NumericField

Methods

wheelRate :: Double -> NumericFieldCfg s e a

CmbDragRate (NumericFieldCfg s e a) Double

Defined in Monomer.Widgets.Singles.NumericField

Methods

dragRate :: Double -> NumericFieldCfg s e a

FormattableNumber a => CmbMaxValue (NumericFieldCfg s e a) a

Defined in Monomer.Widgets.Singles.NumericField

Methods

maxValue :: a -> NumericFieldCfg s e a

FormattableNumber a => CmbMinValue (NumericFieldCfg s e a) a

Defined in Monomer.Widgets.Singles.NumericField

Methods

minValue :: a -> NumericFieldCfg s e a

CmbValidInputV (NumericFieldCfg s e a) e

Defined in Monomer.Widgets.Singles.NumericField

Methods

validInputV :: (Bool -> e) -> NumericFieldCfg s e a

CmbValidInput (NumericFieldCfg s e a) s

Defined in Monomer.Widgets.Singles.NumericField

Methods

validInput :: ALens' s Bool -> NumericFieldCfg s e a

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

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

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

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

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

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

CmbOnChangeReq (NumericFieldCfg s e a) s e a

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

CmbOnBlurReq (NumericFieldCfg s e a) s e Path

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

CmbOnFocusReq (NumericFieldCfg s e a) s e Path

Defined in Monomer.Widgets.Singles.NumericField

Methods

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

type FormattableNumber a = (Eq a, Ord a, Show a, NumericTextConverter a, Typeable a)

Constraints for numeric types accepted by numericField.

class NumericTextConverter a where

Converts a numeric instance to and from Text. Implementing this typeclass is not necessary for instances of FromFractional.

Methods

numericAcceptText :: Maybe a -> Maybe a -> Int -> Text -> (Bool, Bool, Maybe a)

numericFromText :: Text -> Maybe a

numericToText :: Int -> a -> Text

numericToFractional :: Fractional b => a -> Maybe b

numericFromFractional :: (Real b, Fractional b) => b -> a

Instances

FromFractional a => NumericTextConverter a

Defined in Monomer.Widgets.Singles.NumericField

Methods

numericAcceptText :: Maybe a -> Maybe a -> Int -> Text -> (Bool, Bool, Maybe a)

numericFromText :: Text -> Maybe a

numericToText :: Int -> a -> Text

numericToFractional :: Fractional b => a -> Maybe b

numericFromFractional :: (Real b, Fractional b) => b -> a

(FromFractional a, NumericTextConverter a) => NumericTextConverter (Maybe a)

Defined in Monomer.Widgets.Singles.NumericField

Methods

numericAcceptText :: Maybe (Maybe a) -> Maybe (Maybe a) -> Int -> Text -> (Bool, Bool, Maybe (Maybe a))

numericFromText :: Text -> Maybe (Maybe a)

numericToText :: Int -> Maybe a -> Text

numericToFractional :: Fractional b => Maybe a -> Maybe b

numericFromFractional :: (Real b, Fractional b) => b -> Maybe a

Constructors

numericField :: (FormattableNumber a, WidgetEvent e) => ALens' s a -> WidgetNode s e

Creates a numeric field using the given lens.

numericField_ :: (FormattableNumber a, WidgetEvent e) => ALens' s a -> [NumericFieldCfg s e a] -> WidgetNode s e

Creates a numeric field using the given lens. Accepts config.

numericFieldV :: (FormattableNumber a, WidgetEvent e) => a -> (a -> e) -> WidgetNode s e

Creates a numeric field using the given value and onChange event handler.

numericFieldV_ :: (FormattableNumber a, WidgetEvent e) => a -> (a -> e) -> [NumericFieldCfg s e a] -> WidgetNode s e

Creates a numeric field using the given value and onChange event handler. Accepts config.

numericFieldD_ :: forall s e a. (FormattableNumber a, WidgetEvent e) => WidgetData s a -> [NumericFieldCfg s e a] -> WidgetNode s e

Creates a numeric field providing a WidgetData instance and config.