drawer element

A panel that slides in from an edge: filters, a cart, a mobile menu.

Syntax

{ "type": "drawer" }

An element lives in a screen's sections, another element's elements, a layout slot or a component root.

Properties

Plus the properties every element accepts: id, className, style, responsive, states, animation, visible, ariaLabel, attributes and more.

Events & actions

Same as modal.

Example

{
  "type": "column",
  "elements": [
    { "type": "button", "label": "Filters", "action": "toggle", "target": "filters" },
    {
      "id": "filters",
      "type": "drawer",
      "side": "right",
      "elements": [
        { "type": "text", "variant": "h3", "content": "Filters" },
        { "type": "link", "label": "Lighting", "target": "/products?category=lighting" }
      ]
    }
  ]
}

Expected output

The HTML IWC rendered for the example above (inside the page's content wrapper). Class names such as i807b63fc are generated per element for its scoped CSS.

<div class="iwc-page ipage" id="iwc-content">
  <div class="iwc-column ia075770a">
    <button class="iwc-button i6e85c614 iwc-button-primary" type="button" data-iwc-action="toggle" data-target="filters">
      Filters
    </button>
    <dialog class="iwc-drawer i39d8852c" id="filters" data-side="right">
      <button type="button" class="iwc-dialog-close" data-iwc-action="close-dialog" aria-label="Close">
        ×
      </button>
      <h3 class="iwc-text i79ddb10e iwc-text-h3">
        Filters
      </h3>
      <a class="iwc-link if74dcf49" href="/products?category=lighting">Lighting</a>
    </dialog>
  </div>
</div>

Data, conditions & styling

• Conditional rendering: "visible": {"auth": "signed-in"}, {"roles": ["admin"]} or an expression such as "=product.stock > 0". Decided on the server: hidden elements are never sent.
• Data binding: bind takes text from data (name, user.name, props.title, params.slug, state.cart.count); binds binds attributes. Containers become data-driven with data + item. See data binding.
• Styling: className for your stylesheets, style for CSS in JSON, states for hover/focus/active, animation for entrance motion. See the style property reference.
• Responsive behaviour: responsive applies CSS at or below a breakpoint ({"mobile": {"padding": "12px"}}); grids also take responsiveColumns.