Lily Design System™

Grail Layout Left Aside

GrailLayoutLeftAside is a headless container for the left aside section of a GrailLayout. It typically contains navigation menus, filters, or supplementary content.

Example

Show demo markup 
<aside class="grail-layout-left-aside">Left sidebar</aside>
Usage example 
<script lang="ts">
    import GrailLayoutLeftAside from "./GrailLayoutLeftAside.svelte";
</script>

<GrailLayoutLeftAside>
    <nav aria-label="Primary navigation">
        <a href="/">Home</a>
        <a href="/about">About</a>
    </nav>
</GrailLayoutLeftAside>
Show Svelte source 
// In your Svelte component:
import GrailLayoutLeftAside from "lily-design-system-svelte-headless/components/GrailLayoutLeftAside/GrailLayoutLeftAside.svelte";

<GrailLayoutLeftAside>
  <!-- content -->
</GrailLayoutLeftAside>

Usage

<GrailLayout>
  <GrailLayoutTopHeader>...</GrailLayoutTopHeader>
  <GrailLayoutLeftAside>
    <TreeNav label="Sections">
      <TreeList>
        <TreeListItem><TreeLink href="/patients">Patients</TreeLink></TreeListItem>
        <TreeListItem><TreeLink href="/appointments">Appointments</TreeLink></TreeListItem>
      </TreeList>
    </TreeNav>
  </GrailLayoutLeftAside>
  <GrailLayoutCenterMain>...</GrailLayoutCenterMain>
  <GrailLayoutRightAside>...</GrailLayoutRightAside>
  <GrailLayoutBottomFooter>...</GrailLayoutBottomFooter>
</GrailLayout>

Props

  • children: slot (required) -- content to render inside the left aside
  • ...restProps: unknown -- additional attributes spread onto the <div> element

When to Use

  • Use inside GrailLayout as the left sidebar for navigation or supplementary content.
  • Use to contain a TreeNav, AccordionNav, or other navigation components.
  • Use when the page layout needs a persistent left-hand panel for wayfinding.

When Not to Use

  • Do not use outside GrailLayout -- use Sidebar for standalone side panels.
  • Do not use for right-hand supplementary content -- use GrailLayoutRightAside instead.

Keyboard Interactions

  • No keyboard interactions — this is a passive landmark container
  • Focusable descendants follow native tab order

ARIA

  • Native <aside> exposes a complementary landmark — give it an aria-label if a page has more than one aside so screen readers can distinguish them
  • Implicit complementary role from the <aside> element when used as a top-level landmark

Headless

This headless component renders semantic HTML. The consumer provides all visual styling — no CSS, animations, or layout assumptions are baked in.

Styles

The consumer provides all CSS styling. The component renders with a .grail-layout-left-aside class for targeting. No default styles are included — this is a fully headless component.

Testing

  • Verify the component renders a <aside> element with class grail-layout-left-aside
  • Verify pass-through attributes are applied

Composition

GrailLayoutLeftAside is used as a child of GrailLayout. Place semantic <nav> or <aside> elements inside for proper accessibility.

Related components

  • grail-layout — a responsive web design structure with header, left aside, center main, right aside, footer
  • grail-layout-bottom-footer — grail layout bottom footer full width with <footer> tag
  • grail-layout-center-main — grail layout center main content with <main> tag
  • grail-layout-right-aside — grail layout right aside sidebar with <aside> tag
  • grail-layout-top-header — grail layout top header full width with <header> tag

References

  • CSS Grid Layout: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout

Implementation Notes

  • Renders a <aside> element for the left aside section
  • Spreads restProps onto the div for consumer customization
  • No styles applied; consumer provides all styling

Canonical contract

Generated from this component's canonical metadata — the machine-checked source the implementations are held to.

Metadata

  • Component: grail-layout-left-aside
  • PascalCase: GrailLayoutLeftAside
  • Description: grail layout left aside sidebar with <aside> tag
  • Status: beta — implemented and unit-tested in all seven frameworks with an axe-clean demo page; not yet exercised in composed flows
  • HTML tag: <aside>
  • CSS class: .grail-layout-left-aside
  • Interactive: no

ARIA

  • Native <aside> element exposes a complementary landmark
  • Consumers should add aria-label (or aria-labelledby) to distinguish from other asides on the page

Keyboard

  • No keyboard interactions — this is a passive element

Props

  • children: slot (required) -- content to render inside the left aside
  • ...restProps: unknown -- additional attributes spread onto the <div> element

### Grail layout pattern: GrailLayout → GrailLayoutTop, GrailLayoutLeft, GrailLayoutCenter, GrailLayoutRight, GrailLayoutBottom

```tsx

<GrailLayout>

<GrailLayoutTopHeader>…</GrailLayoutTopHeader>

<GrailLayoutLeftAside>…</GrailLayoutLeftAside>

<GrailLayoutCenterMain>…</GrailLayoutCenterMain>

<GrailLayoutRightAside>…</GrailLayoutRightAside>

<GrailLayoutBottomFooter>…</GrailLayoutBottomFooter>

</GrailLayout>

```