Renders the children of a container. On the canvas, an empty container shows a drop zone.

Attributes

• node (:map) (required)
• ctx (:any) (required)
• placeholder (:string) - Defaults to nil.

@spec class_list(term()) :: String.t()

Joins classes, skipping nil, false and empty strings.

@spec editor?(map()) :: boolean()

Whether the block is being rendered on the editor canvas.

@spec filter_checked?(map(), String.t() | [String.t()], term()) :: boolean()

Whether option is the value (or one of the values) of an entry of the filter form.

@spec filter_field(map(), String.t()) :: ElementorexCms.Source.Field.t() | nil

The field key of the filtered source (ElementorexCms.Source.Field), or nil.

@spec filter_form?(map()) :: boolean()

Whether the block is in a filter form (that targets a loop grid).

@spec filter_name(map(), String.t() | [String.t()]) :: String.t() | nil

The name of an input of the filter form the block is in: filter_name(assigns, "q") → "catalog[q]", filter_name(assigns, [@field, ""]) → "catalog[category][]", filter_name(assigns, [@field, "min"]) → "catalog[price][min]". nil outside a filter form.

@spec filter_options(map(), String.t()) :: [map()]

The options of a field of the filtered source: [%{label:, value:, count:}].

@spec filter_value(map(), String.t() | [String.t()]) :: term()

The value the visitor gave to an entry of the filter form (nil if none).

An icon from Heroicons, inline SVG (works with any icon name chosen in the editor, see ElementorexCms.Heroicons).

Attributes

• name (:string) (required)
• style (:string) - Defaults to "outline".
• class (:any) - Defaults to nil.
• Global attributes are accepted.

@spec inline(map(), atom() | String.t()) :: [{String.t(), String.t()}]

Marks the element that holds an inline-editable prop: on the canvas the user double-clicks it to type. Outside the editor it adds nothing, and neither does it for props bound to dynamic content (their value comes from the data).

<h2 {inline(assigns, :text)}>{@text}</h2>

@spec link_attrs(String.t() | nil, boolean()) :: [{String.t(), String.t()}]

href, target and rel for a link. An empty URL gives no href (on the canvas links never navigate anyway).

@spec rich(String.t() | nil) :: Phoenix.HTML.safe()

Sanitized rich text (:rich policy) as safe HTML.

@spec rich_inline(String.t() | nil) :: Phoenix.HTML.safe()

Sanitized inline HTML (:inline policy) as safe HTML.

@spec root(map(), keyword()) :: [{String.t(), term()}]

Attributes for the root element of a block.

• data-ex-id - the node id; the node's CSS is scoped to it
• id and class from the Advanced tab, merged with :class
• on the canvas, data-ex-type and data-ex-container for the editor, and data-ex-off when its display condition fails for the item

Options:

• :class - classes of the block (string, list, nil/false are skipped)
• :style - inline style string, written as is (build it from validated values only)
• :attrs - extra attributes ([{"role", "alert"}])

@spec style(list()) :: String.t()

Inline style from validated declarations: [{"max-width", "640px"}] → "max-width:640px". Invalid values are dropped (see ElementorexCms.CSS).

@spec t(String.t(), keyword()) :: String.t()

Translates a string of the block (see ElementorexCms.I18n).