GI.Gtk.Declarative

The declarative layer on top of GTK+ lets you describe your user interface as a declarative hierarchy of objects, using data structures and pure functions. You can leverage the declarative event handling to build reusable widgets. The Patch typeclass, and the instances provided by this library, performs minimal updates to GTK+ widgets using the underlying imperative operations, so that your rendering can always be a pure function your state to a Widget.

Documentation

data EventHandler gtkEventHandler widget (purity :: Purity) event where

Encodes the user event handler in such a way that we can have a Functor instance for arity-polymorphic event handlers.

Constructors

PureEventHandler :: EventHandlerReturn Identity ret e -> EventHandler (IO ret) w Pure e

ImpureEventHandler :: (w -> EventHandlerReturn IO ret e) -> EventHandler (IO ret) w Impure e

EventHandlerFunction :: (a -> EventHandler b w p e) -> EventHandler (a -> b) w p e

Instances

Functor (EventHandler gtkEventHandler widget purity)

Defined in GI.Gtk.Declarative.Attributes.Internal.EventHandler

Methods

fmap :: (a -> b) -> EventHandler gtkEventHandler widget purity a -> EventHandler gtkEventHandler widget purity b

(<$) :: a -> EventHandler gtkEventHandler widget purity b -> EventHandler gtkEventHandler widget purity a

type ClassSet = HashSet Text

A set of CSS classes.

data Attribute widget event where

The attribute GADT represent a supported attribute for a declarative widget. This extends the regular notion of GTK+ attributes to also include event handling and CSS classes.

Constructors

(:=) :: (AttrOpAllowed AttrConstruct info widget, AttrOpAllowed AttrSet info widget, AttrGetC info widget attr getValue, AttrSetTypeConstraint info setValue, KnownSymbol attr, Typeable attr, Eq setValue, Typeable setValue) => AttrLabelProxy (attr :: Symbol) -> setValue -> Attribute widget event

An attribute/value mapping for a declarative widget. The AttrLabelProxy is parameterized by attr, which represents the GTK-defined attribute name. The underlying GI object needs to support the construct, get, and set operations for the given attribute.

Classes :: IsWidget widget => ClassSet -> Attribute widget event

Defines a set of CSS classes for the underlying widget's style context. Use the classes function instead of this constructor directly.

OnSignalPure :: (GObject widget, SignalInfo info, gtkCallback ~ HaskellCallbackType info, ToGtkCallback gtkCallback Pure) => SignalProxy widget info -> EventHandler gtkCallback widget Pure event -> Attribute widget event

Emit events using a pure event handler. Use the on function, instead of this constructor directly.

OnSignalImpure :: (GObject widget, SignalInfo info, gtkCallback ~ HaskellCallbackType info, ToGtkCallback gtkCallback Impure) => SignalProxy widget info -> EventHandler gtkCallback widget Impure event -> Attribute widget event

Emit events using a pure event handler. Use the on function, instead of this constructor directly.

AfterCreated :: (widget -> IO ()) -> Attribute widget event

Provide a callback to modify the widget after it's been created.

Instances

Functor (Attribute widget)

Attributes have a Functor instance that maps events in all event handler.

Defined in GI.Gtk.Declarative.Attributes

Methods

fmap :: (a -> b) -> Attribute widget a -> Attribute widget b

(<$) :: a -> Attribute widget b -> Attribute widget a

classes :: IsWidget widget => [Text] -> Attribute widget event

Define the CSS classes for the underlying widget's style context. For these classes to have any effect, this requires a CssProvider with CSS files loaded, to be added to the GDK screen. You probably want to do this in your entry point when setting up GTK.

on :: (GObject widget, SignalInfo info, gtkCallback ~ HaskellCallbackType info, ToGtkCallback gtkCallback Pure, ToEventHandler gtkCallback widget Pure, userEventHandler ~ UserEventHandler gtkCallback widget Pure event) => SignalProxy widget info -> userEventHandler -> Attribute widget event

Emit events, using a pure event handler, by subcribing to the specified signal.

onM :: (GObject widget, SignalInfo info, gtkCallback ~ HaskellCallbackType info, ToGtkCallback gtkCallback Impure, ToEventHandler gtkCallback widget Impure, userEventHandler ~ UserEventHandler gtkCallback widget Impure event) => SignalProxy widget info -> userEventHandler -> Attribute widget event

Emit events, using an impure event handler receiving the widget and returning an IO action of event, by subcribing to the specified signal.

afterCreated :: (widget -> IO ()) -> Attribute widget event

Provide a EventHandler to modify the widget after it's been created.

class Patchable widget where

A patchable widget is one that can create an underlying GTK widget, or calculate a Patch to be applied to an existing GTK widget that was previously created.

Methods

create :: widget e -> IO SomeState

Given a declarative widget that is Patchable, return an IO action that can create a new corresponding Widget. The created widget should be use in corresponding patch modifications, until it is replaced.

patch :: SomeState -> widget e1 -> widget e2 -> Patch

Given two declarative widgets of the same widget type (but not necessarily of the same event types,) calculate a Patch.

Instances

Patchable Widget

Widget is itself patchable, by delegating to the underlying widget instances.

Defined in GI.Gtk.Declarative.Widget

Methods

create :: Widget e -> IO SomeState

patch :: SomeState -> Widget e1 -> Widget e2 -> Patch

Patchable BoxChild

Defined in GI.Gtk.Declarative.Container.Box

Methods

create :: BoxChild e -> IO SomeState

patch :: SomeState -> BoxChild e1 -> BoxChild e2 -> Patch

Patchable Pane

Defined in GI.Gtk.Declarative.Container.Paned

Methods

create :: Pane e -> IO SomeState

patch :: SomeState -> Pane e1 -> Pane e2 -> Patch

Patchable MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

create :: MenuItem e -> IO SomeState

patch :: SomeState -> MenuItem e1 -> MenuItem e2 -> Patch

Patchable (SingleWidget widget)

Defined in GI.Gtk.Declarative.SingleWidget

Methods

create :: SingleWidget widget e -> IO SomeState

patch :: SomeState -> SingleWidget widget e1 -> SingleWidget widget e2 -> Patch

IsBin parent => Patchable (Bin parent)

Defined in GI.Gtk.Declarative.Bin

Methods

create :: Bin parent e -> IO SomeState

patch :: SomeState -> Bin parent e1 -> Bin parent e2 -> Patch

IsWidget widget => Patchable (CustomWidget widget customData)

Defined in GI.Gtk.Declarative.CustomWidget

Methods

create :: CustomWidget widget customData e -> IO SomeState

patch :: SomeState -> CustomWidget widget customData e1 -> CustomWidget widget customData e2 -> Patch

(Patchable child, Typeable child, IsContainer container child) => Patchable (Container container (Children child))

Defined in GI.Gtk.Declarative.Container

Methods

create :: Container container (Children child) e -> IO SomeState

patch :: SomeState -> Container container (Children child) e1 -> Container container (Children child) e2 -> Patch

data Patch

A possible action to take on an existing Widget, decided by the patch method when comparing declarative widgets.

Constructors

Modify (IO SomeState)

An IO action to apply to a Widget to make it reflect an updated declarative widget. The action to apply is calculated from the difference between the old and the new declarative widget.

Replace (IO SomeState)

Replace the current Widget by the widget returned by the IO action.

Keep

Do nothing, i.e. keep the Widget as it is.

data CustomWidget widget customData event

A custom widget specification, with all functions needed to instantiate Patchable and EventSource. A custom widget is based on a top widget, can use customData as a way of passing parameters, and emits events of type event.

Constructors

CustomWidget

Fields

• customWidget :: ManagedPtr widget -> widget

  The widget constructor

• customCreate :: customData -> IO SomeState

  Action that creates the initial widget

• customPatch :: SomeState -> customData -> customData -> CustomPatch widget customData

  Patch function, calculating a CustomPatch based on the state, old custom data, and new custom data.

• customSubscribe :: customData -> widget -> (event -> IO ()) -> IO Subscription

  Action that creates an event subscription for the custom widget

• customData :: customData

  The custom data (e.g. parameters) of the custom widget

Instances

Functor (CustomWidget widget customData)

Defined in GI.Gtk.Declarative.CustomWidget

Methods

fmap :: (a -> b) -> CustomWidget widget customData a -> CustomWidget widget customData b

(<$) :: a -> CustomWidget widget customData b -> CustomWidget widget customData a

IsWidget widget => Patchable (CustomWidget widget customData)

Defined in GI.Gtk.Declarative.CustomWidget

Methods

create :: CustomWidget widget customData e -> IO SomeState

patch :: SomeState -> CustomWidget widget customData e1 -> CustomWidget widget customData e2 -> Patch

GObject widget => EventSource (CustomWidget widget customData)

Defined in GI.Gtk.Declarative.CustomWidget

Methods

subscribe :: CustomWidget widget customData event -> SomeState -> (event -> IO ()) -> IO Subscription

data CustomPatch widget customData

Similar to Patch, describing a possible action to perform on a Widget, decided by customPatch.

Constructors

CustomReplace

CustomModify (widget -> IO SomeState)

CustomKeep

class FromWidget widget target where

Convert a widget to a target type. This is deliberately unconstrained in it's types, and is used by smart constructors to implement return type polymorphism, so that a smart contructor can return either a Widget, or some specifically typed widget, depending on the context in which it's used.

Methods

fromWidget :: (Typeable widget, Typeable event) => widget event -> target event

Instances

FromWidget widget Widget => FromWidget widget BoxChild

Any widget that can be converted to a Widget can be wrapped as a BoxChild with the default properties.

Defined in GI.Gtk.Declarative.Widget.Conversions

Methods

fromWidget :: (Typeable widget, Typeable event) => widget event -> BoxChild event

(Patchable (parent child), Functor (parent child), EventSource (parent child)) => FromWidget (parent child) Widget

Defined in GI.Gtk.Declarative.Widget

Methods

fromWidget :: (Typeable (parent child), Typeable event) => parent child event -> Widget event

a ~ b => FromWidget (Bin a) (Bin b)

Defined in GI.Gtk.Declarative.Bin

Methods

fromWidget :: (Typeable (Bin a), Typeable event) => Bin a event -> Bin b event

(Typeable widget, Typeable children, Patchable (Container widget children), EventSource (Container widget children), Functor (Container widget children)) => FromWidget (Container widget children) Widget

Defined in GI.Gtk.Declarative.Container

Methods

fromWidget :: (Typeable (Container widget children), Typeable event) => Container widget children event -> Widget event

a ~ b => FromWidget (Container a children) (Container b children)

Defined in GI.Gtk.Declarative.Container

Methods

fromWidget :: (Typeable (Container a children), Typeable event) => Container a children event -> Container b children event

data Widget event where

A Widget value wraps a Patchable and EventSource widget, providing a constrained equivalent of a Dynamic value. It is used to support heterogeneous containers of widgets, and to support equality checks on different types of widgets when calculating patches.

Constructors

Widget :: (Typeable widget, Patchable widget, Functor widget, EventSource widget) => widget event -> Widget event

Instances

Functor Widget

Defined in GI.Gtk.Declarative.Widget

Methods

fmap :: (a -> b) -> Widget a -> Widget b

(<$) :: a -> Widget b -> Widget a

Patchable Widget

Widget is itself patchable, by delegating to the underlying widget instances.

Defined in GI.Gtk.Declarative.Widget

Methods

create :: Widget e -> IO SomeState

patch :: SomeState -> Widget e1 -> Widget e2 -> Patch

EventSource Widget

Defined in GI.Gtk.Declarative.Widget

Methods

subscribe :: Widget event -> SomeState -> (event -> IO ()) -> IO Subscription

(Patchable (parent child), Functor (parent child), EventSource (parent child)) => FromWidget (parent child) Widget

Defined in GI.Gtk.Declarative.Widget

Methods

fromWidget :: (Typeable (parent child), Typeable event) => parent child event -> Widget event

(Typeable widget, Typeable children, Patchable (Container widget children), EventSource (Container widget children), Functor (Container widget children)) => FromWidget (Container widget children) Widget

Defined in GI.Gtk.Declarative.Container

Methods

fromWidget :: (Typeable (Container widget children), Typeable event) => Container widget children event -> Widget event

data SingleWidget widget event

Declarative version of a leaf widget, i.e. a widget without any children.

Instances

Functor (SingleWidget widget)

Defined in GI.Gtk.Declarative.SingleWidget

Methods

fmap :: (a -> b) -> SingleWidget widget a -> SingleWidget widget b

(<$) :: a -> SingleWidget widget b -> SingleWidget widget a

Patchable (SingleWidget widget)

Defined in GI.Gtk.Declarative.SingleWidget

Methods

create :: SingleWidget widget e -> IO SomeState

patch :: SomeState -> SingleWidget widget e1 -> SingleWidget widget e2 -> Patch

EventSource (SingleWidget widget)

Defined in GI.Gtk.Declarative.SingleWidget

Methods

subscribe :: SingleWidget widget event -> SomeState -> (event -> IO ()) -> IO Subscription

widget

Arguments

:: (Typeable widget, Typeable event, Functor (Attribute widget), IsWidget widget, FromWidget (SingleWidget widget) target)

=> (ManagedPtr widget -> widget)

A widget constructor from the underlying gi-gtk library.

-> Vector (Attribute widget event)

List of Attributes.

-> target event

The target, whose type is decided by FromWidget.

Construct a leaf widget, i.e. one without any children.

data BoxChildProperties

Values used when packing child widgets into boxes.

Constructors

BoxChildProperties

Fields

• expand :: Bool
• fill :: Bool
• padding :: Word32

data BoxChild event

Describes a child widget to be added with boxAppend to a Box.

Constructors

BoxChild

Fields

• properties :: BoxChildProperties
• child :: Widget event

Instances

Functor BoxChild

Defined in GI.Gtk.Declarative.Container.Box

Methods

fmap :: (a -> b) -> BoxChild a -> BoxChild b

(<$) :: a -> BoxChild b -> BoxChild a

Patchable BoxChild

Defined in GI.Gtk.Declarative.Container.Box

Methods

create :: BoxChild e -> IO SomeState

patch :: SomeState -> BoxChild e1 -> BoxChild e2 -> Patch

EventSource BoxChild

Defined in GI.Gtk.Declarative.Container.Box

Methods

subscribe :: BoxChild event -> SomeState -> (event -> IO ()) -> IO Subscription

IsContainer Box BoxChild

Defined in GI.Gtk.Declarative.Container.Patch

Methods

appendChild :: Box -> BoxChild event -> Widget -> IO ()

replaceChild :: Box -> BoxChild event -> Int32 -> Widget -> Widget -> IO ()

FromWidget widget Widget => FromWidget widget BoxChild

Any widget that can be converted to a Widget can be wrapped as a BoxChild with the default properties.

Defined in GI.Gtk.Declarative.Widget.Conversions

Methods

fromWidget :: (Typeable widget, Typeable event) => widget event -> BoxChild event

ToChildren Box Vector BoxChild

Defined in GI.Gtk.Declarative.Container.Box

Methods

toChildren :: (ManagedPtr Box -> Box) -> Vector (BoxChild event) -> Children BoxChild event

defaultBoxChildProperties :: BoxChildProperties

Defaults for BoxChildProperties. Use these and override specific fields.

data Bin widget event

Declarative version of a bin widget, i.e. a widget with exactly one child.

Instances

ToChildren ListBox Vector (Bin ListBoxRow)

Defined in GI.Gtk.Declarative.Container.ListBox

Methods

toChildren :: (ManagedPtr ListBox -> ListBox) -> Vector (Bin ListBoxRow event) -> Children (Bin ListBoxRow) event

IsContainer ListBox (Bin ListBoxRow)

Defined in GI.Gtk.Declarative.Container.Patch

Methods

appendChild :: ListBox -> Bin ListBoxRow event -> Widget -> IO ()

replaceChild :: ListBox -> Bin ListBoxRow event -> Int32 -> Widget -> Widget -> IO ()

Functor (Bin widget)

Defined in GI.Gtk.Declarative.Bin

Methods

fmap :: (a -> b) -> Bin widget a -> Bin widget b

(<$) :: a -> Bin widget b -> Bin widget a

IsBin parent => Patchable (Bin parent)

Defined in GI.Gtk.Declarative.Bin

Methods

create :: Bin parent e -> IO SomeState

patch :: SomeState -> Bin parent e1 -> Bin parent e2 -> Patch

IsBin parent => EventSource (Bin parent)

Defined in GI.Gtk.Declarative.Bin

Methods

subscribe :: Bin parent event -> SomeState -> (event -> IO ()) -> IO Subscription

a ~ b => FromWidget (Bin a) (Bin b)

Defined in GI.Gtk.Declarative.Bin

Methods

fromWidget :: (Typeable (Bin a), Typeable event) => Bin a event -> Bin b event

bin

Arguments

:: (Patchable (Bin widget), Typeable widget, Typeable event, IsContainer widget, IsBin widget, IsWidget widget, FromWidget (Bin widget) target)

=> (ManagedPtr widget -> widget)

A bin widget constructor from the underlying gi-gtk library.

-> Vector (Attribute widget event)

List of Attributes.

-> Widget event

The bin's child widget

-> target event

The target, whose type is decided by FromWidget.

Construct a bin widget, i.e. a widget with exactly one child.

data Container widget children event

Declarative version of a container widget, i.e. a widget with zero or more child widgets. The type of children is parameterized, and differs across the supported container widgets, as some containers require specific types of child widgets. These type relations are decided by IsContainer, and instances can found in GI.Gtk.Declarative.Container.Patch.

Instances

Functor (Container widget children)

Defined in GI.Gtk.Declarative.Container

Methods

fmap :: (a -> b) -> Container widget children a -> Container widget children b

(<$) :: a -> Container widget children b -> Container widget children a

(Patchable child, Typeable child, IsContainer container child) => Patchable (Container container (Children child))

Defined in GI.Gtk.Declarative.Container

Methods

create :: Container container (Children child) e -> IO SomeState

patch :: SomeState -> Container container (Children child) e1 -> Container container (Children child) e2 -> Patch

(Typeable child, EventSource child) => EventSource (Container widget (Children child))

Defined in GI.Gtk.Declarative.Container

Methods

subscribe :: Container widget (Children child) event -> SomeState -> (event -> IO ()) -> IO Subscription

(Typeable widget, Typeable children, Patchable (Container widget children), EventSource (Container widget children), Functor (Container widget children)) => FromWidget (Container widget children) Widget

Defined in GI.Gtk.Declarative.Container

Methods

fromWidget :: (Typeable (Container widget children), Typeable event) => Container widget children event -> Widget event

a ~ b => FromWidget (Container a children) (Container b children)

Defined in GI.Gtk.Declarative.Container

Methods

fromWidget :: (Typeable (Container a children), Typeable event) => Container a children event -> Container b children event

container

Arguments

:: (Patchable (Container widget (Children child)), Typeable widget, Typeable child, Typeable event, Functor child, IsWidget widget, IsContainer widget, FromWidget (Container widget (Children child)) target, ToChildren widget parent child)

=> (ManagedPtr widget -> widget)

A container widget constructor from the underlying gi-gtk library.

-> Vector (Attribute widget event)

Attributes.

-> parent (child event)

The container's child widgets, in a MarkupOf builder.

-> target event

The target, whose type is decided by FromWidget.

Construct a container widget, i.e. a widget with zero or more children.

data PaneProperties

Values used when packing a pane into a Paned.

Constructors

PaneProperties

Fields

• resize :: Bool
• shrink :: Bool

data Pane event

Describes a pane to be packed with 'Gtk.panePack1'/'Gtk.panePack2' in a Paned.

Instances

Functor Pane

Defined in GI.Gtk.Declarative.Container.Paned

Methods

fmap :: (a -> b) -> Pane a -> Pane b

(<$) :: a -> Pane b -> Pane a

Patchable Pane

Defined in GI.Gtk.Declarative.Container.Paned

Methods

create :: Pane e -> IO SomeState

patch :: SomeState -> Pane e1 -> Pane e2 -> Patch

EventSource Pane

Defined in GI.Gtk.Declarative.Container.Paned

Methods

subscribe :: Pane event -> SomeState -> (event -> IO ()) -> IO Subscription

IsContainer Paned Pane

Defined in GI.Gtk.Declarative.Container.Paned

Methods

appendChild :: Paned -> Pane event -> Widget -> IO ()

replaceChild :: Paned -> Pane event -> Int32 -> Widget -> Widget -> IO ()

defaultPaneProperties :: PaneProperties

Defaults for PaneProperties. Use these and override specific fields.

pane :: PaneProperties -> Widget event -> Pane event

Construct a pane to be packed with 'Gtk.panePack1'/'Gtk.panePack2' in a Paned.

paned :: Typeable event => Vector (Attribute Paned event) -> Pane event -> Pane event -> Widget event

Construct a Paned based on attributes and two child Panes.

data MenuItem event

A menu item widget used for Menu children.

Instances

Functor MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

fmap :: (a -> b) -> MenuItem a -> MenuItem b

(<$) :: a -> MenuItem b -> MenuItem a

Patchable MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

create :: MenuItem e -> IO SomeState

patch :: SomeState -> MenuItem e1 -> MenuItem e2 -> Patch

EventSource MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

subscribe :: MenuItem event -> SomeState -> (event -> IO ()) -> IO Subscription

IsContainer Menu MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

appendChild :: Menu -> MenuItem event -> Widget -> IO ()

replaceChild :: Menu -> MenuItem event -> Int32 -> Widget -> Widget -> IO ()

IsContainer MenuBar MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

appendChild :: MenuBar -> MenuItem event -> Widget -> IO ()

replaceChild :: MenuBar -> MenuItem event -> Int32 -> Widget -> Widget -> IO ()

IsContainer MenuShell MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

appendChild :: MenuShell -> MenuItem event -> Widget -> IO ()

replaceChild :: MenuShell -> MenuItem event -> Int32 -> Widget -> Widget -> IO ()

ToChildren Menu Vector MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

toChildren :: (ManagedPtr Menu -> Menu) -> Vector (MenuItem event) -> Children MenuItem event

ToChildren MenuBar Vector MenuItem

Defined in GI.Gtk.Declarative.Container.MenuItem

Methods

toChildren :: (ManagedPtr MenuBar -> MenuBar) -> Vector (MenuItem event) -> Children MenuItem event

menuItem :: (IsMenuItem item, Typeable event, Typeable item, IsContainer item, IsBin item, IsWidget item) => (ManagedPtr item -> item) -> Vector (Attribute item event) -> Widget event -> MenuItem event

Construct a single menu item for a Menu.

subMenu :: Typeable event => Text -> Vector (MenuItem event) -> MenuItem event

Construct a sub menu for a Menu, wit a text label and the child menu items.