Hylograph.Render

runD3 :: D3M ~> Effect

Run a D3 computation (alias for runD3v2M)

type D3M = D3v2M

Type alias for the D3 monad

type D3Selection = D3v2Selection_

Type alias for D3 selections

selectChildInheriting :: forall parent datum. String -> D3v2Selection_ SBoundOwns parent datum -> D3v2M (D3v2Selection_ SBoundOwns Element datum)

Select child elements, inheriting parent's data Alias for selectChildInheritingD3v2 for convenient import

clear :: forall sel m. SelectionM sel m => String -> m Unit

Clear all children from an element

Selects the element and removes all its children. Useful for clearing a container before rendering new content.

Example:

clear "#viz"
svg <- appendChild SVG [...] container

renderData :: forall sel m f parent datum. SelectionM sel m => Foldable f => Ord datum => ElementType -> f datum -> String -> sel SEmpty parent datum -> Maybe (datum -> Array (Attribute datum)) -> Maybe (datum -> Array (Attribute datum)) -> Maybe (datum -> Array (Attribute datum)) -> m (sel SBoundOwns Element datum)

High-level data rendering (recommended for most use cases)

Manages the entire enter-update-exit cycle automatically. Users provide Maybe callbacks for each phase.

This is the user-friendly API that prevents sequencing errors by handling enter/update/exit internally.

Example:

circles <- renderData Circle [1, 2, 3] "circle" svg
  (Just \d -> [fill "green", cx (\_ -> d * 100.0)])  -- Enter
  (Just \d -> [fill "orange"])                        -- Update
  Nothing                                             -- Exit (just remove)

renderTree :: forall sel m parent parentDatum datum. SelectionM sel m => Ord datum => sel SEmpty parent parentDatum -> Tree datum -> m (Map String (sel SBoundOwns Element datum))

Declarative tree rendering (high-level API)

Renders an entire tree structure at once, returning a map of named selections. This is the declarative alternative to imperative appendChild chains.

Example:

import Hylograph.AST as T

tree =
  T.named "svg" SVG [width 800] `T.withChildren`
    [ T.named "zoom" Group [class_ "zoom"] `T.withChild`
        T.named "nodes" Group [class_ "nodes"]
    ]

container <- select "#viz"
selections <- renderTree container tree

-- Access named selections
case Map.lookup "svg" selections of
  Just svg -> ...
  Nothing -> ...

select :: forall sel m datum. SelectionM sel m => String -> m (sel SEmpty Element datum)

Select a single element by CSS selector

Returns an empty selection (no data bound). The datum type is polymorphic and will be inferred from usage. This is typically the starting point for data binding.

selectAll :: forall sel m state parent parentDatum datum. SelectionM sel m => String -> sel state parent parentDatum -> m (sel SEmpty Element datum)

Select all elements matching selector within a parent selection

Returns an empty selection of the matched elements. The datum type is polymorphic and will be inferred from usage.

selectAllWithData :: forall sel m state parent parentDatum datum. SelectionM sel m => String -> sel state parent parentDatum -> m (sel SBoundOwns Element datum)

Select all elements matching selector and extract their bound data

Use this when selecting child elements that have inherited data from their parent. This is necessary when you want to use the selection with transitions that need access to the bound data (like withTransitionStaggered).

Example:

groups <- selectSimulationGroups
circles <- selectAllWithData "circle" groups.nodes
withTransitionStaggered config delayFn circles [fill colorByDepth]

setAttrs :: forall sel m datum. SelectionM sel m => Array (Attribute datum) -> sel SBoundOwns Element datum -> m (sel SBoundOwns Element datum)

Set attributes on a bound selection

Updates existing elements with new attribute values. Returns the updated selection.

newtype D3v2Selection_ (state :: Type) (parent :: Type) (datum :: Type)

Selection type for D3v2 interpreter

This is just a newtype wrapper around Hylograph.Internal.Selection.Types.Selection to distinguish it from other interpreter's selection types.

Instances

• SelectionM D3v2Selection_ D3v2M

  SelectionM instance for D3v2 interpreter

  Delegates all operations to Hylograph.Internal.Selection.Operations, which uses the phantom types with unsafePartial for safe pattern matching.

• TransitionM D3v2Selection_ D3v2M

  TransitionM instance for D3v2 interpreter

  Implements animated transitions using D3's transition engine. Applies transitions to each element in the bound selection.

newtype D3v2M a

The D3v2 interpreter monad (without simulation state)

Wraps Effect to allow for DOM manipulation.

Instances

• Functor D3v2M
• Apply D3v2M
• Applicative D3v2M
• Bind D3v2M
• Monad D3v2M
• MonadEffect D3v2M
• SelectionM D3v2Selection_ D3v2M

  SelectionM instance for D3v2 interpreter

  Delegates all operations to Hylograph.Internal.Selection.Operations, which uses the phantom types with unsafePartial for safe pattern matching.

• TransitionM D3v2Selection_ D3v2M

  TransitionM instance for D3v2 interpreter

  Implements animated transitions using D3's transition engine. Applies transitions to each element in the bound selection.

selectChildInheritingD3v2 :: forall parent datum. String -> D3v2Selection_ SBoundOwns parent datum -> D3v2M (D3v2Selection_ SBoundOwns Element datum)

Select child elements, inheriting parent's data (D3v2 version)

Wrapper around Operations.selectChildInheriting that works with D3v2Selection_.

runD3v2M :: D3v2M ~> Effect

Run the D3v2 interpreter

reselectD3v2 :: forall datum datumOut. String -> Map String (D3v2Selection_ SBoundOwns Element datum) -> Effect (D3v2Selection_ SEmpty Element datumOut)

Helper function for reselecting from D3v2 renderTree results

This wraps the reselect function from Operations to work with D3v2Selection_ newtype.