<!-- Source: https://scoped.svelte.page/examples/dynamic-class-value -->

# Dynamic ClassValue

> A dynamic ClassValue example using arrays, object maps, derived values, and a toggle.

**Source:** [https://scoped.svelte.page/examples/dynamic-class-value](https://scoped.svelte.page/examples/dynamic-class-value)

**Markdown mirror:** [https://scoped.svelte.page/examples/dynamic-class-value.md](https://scoped.svelte.page/examples/dynamic-class-value.md)

---

This mirror preserves the prose, implementation notes, and runnable Svelte source behind the live example page.

## FIG-001: dynamic ClassValue.

The stateful case: arrays and object maps can change after hydration, and the runtime helper keeps the parent hash attached to the computed class string.

**Metadata:** tag: `CLASSVALUE` | syntax: `scoped:class` | value: `ClassValue` | status: `passing`

### Source

#### DynamicClassValue.svelte

Source file: [src/lib/examples/scoped-props/demos/DynamicClassValue.svelte](https://github.com/humanspeak/svelte-scoped-props/blob/main/docs/src/lib/examples/scoped-props/demos/DynamicClassValue.svelte)

```svelte
<script lang="ts">
    import type { ClassValue } from '@humanspeak/svelte-scoped-props/runtime'
    import ChildCard from './components/ChildCard.svelte'

    let dynamicDimmed = $state(true)
    let dynamicClass: ClassValue = $derived(['parent-owned', { dimmed: dynamicDimmed }])
    let dynamicClassMap: ClassValue = $derived({
        'parent-owned': true,
        dimmed: dynamicDimmed
    })
</script>

<article class="scoped-proof passed dk-demo-shell">
    <label class="toggle-row">
        <input type="checkbox" bind:checked={dynamicDimmed} />
        <span>include <code>dimmed</code> from state</span>
    </label>

    <div class="render-grid">
        <div class="render-example">
            <span class="example-label">Native element</span>
            <div class={['demo-card', dynamicClass]}>This div receives a dynamic ClassValue.</div>
        </div>
        <div class="render-example">
            <span class="example-label">Child component</span>
            <ChildCard scoped:class={dynamicClass} />
        </div>
        <div class="render-example">
            <span class="example-label">Object class map</span>
            <ChildCard scoped:class={dynamicClassMap} />
        </div>
    </div>

    <div class="comparison-grid">
        <div class="comparison-head">
            <span class="example-label">Source</span>
            <span class="example-label">Current result</span>
        </div>

        <div class="comparison-row">
            <div class="comparison-cell comparison-source">
                <span>Native element</span>
                <code>dynamicClass = ['parent-owned', &#123; dimmed: dynamicDimmed &#125;]</code>
                <code>&lt;div class=&#123;['demo-card', dynamicClass]&#125;&gt;</code>
            </div>
            <div class="comparison-cell comparison-result">
                <span>Native element</span>
                <code>demo-card parent-owned{dynamicDimmed ? ' dimmed' : ''} svelte-parent</code>
                <strong>{dynamicDimmed ? 'pink and faded' : 'pink'}</strong>
            </div>
        </div>

        <div class="comparison-row">
            <div class="comparison-cell comparison-source">
                <span>Child component</span>
                <code>dynamicClass = ['parent-owned', &#123; dimmed: dynamicDimmed &#125;]</code>
                <code>&lt;ChildCard scoped:class=&#123;dynamicClass&#125; /&gt;</code>
            </div>
            <div class="comparison-cell comparison-result">
                <span>Child component</span>
                <code
                    >child-card parent-owned{dynamicDimmed ? ' dimmed' : ''} svelte-parent svelte-child</code
                >
                <strong>has parent hash</strong>
            </div>
        </div>

        <div class="comparison-row">
            <div class="comparison-cell comparison-source">
                <span>Object class map</span>
                <code
                    >dynamicClassMap = &#123; 'parent-owned': true, dimmed: dynamicDimmed &#125;</code
                >
                <code>&lt;ChildCard scoped:class=&#123;dynamicClassMap&#125; /&gt;</code>
            </div>
            <div class="comparison-cell comparison-result">
                <span>Object class map</span>
                <code
                    >child-card parent-owned{dynamicDimmed ? ' dimmed' : ''} svelte-parent svelte-child</code
                >
                <strong>has parent hash</strong>
            </div>
        </div>
    </div>
</article>

<style>
    .parent-owned {
        border-color: var(--proof-parent-border, purple);
        color: var(--proof-parent-ink, purple);
        background: var(--proof-parent-bg, pink);
    }

    .dimmed {
        opacity: 0.35;
    }
</style>
```

#### ChildCard.svelte

Source file: [src/lib/examples/scoped-props/demos/components/ChildCard.svelte](https://github.com/humanspeak/svelte-scoped-props/blob/main/docs/src/lib/examples/scoped-props/demos/components/ChildCard.svelte)

```svelte
<script lang="ts">
    import type { ClassValue } from '@humanspeak/svelte-scoped-props/runtime'
    import { describeClass } from './classValue'

    type Props = {
        class?: ClassValue
        'scoped:class'?: ClassValue
    }

    let { class: className }: Props = $props()
    let classText = $derived(describeClass(className))
</script>

<div class={['child-card', className]}>
    Child receives <code>class="{classText}"</code>.
</div>

<style>
    .child-card {
        min-height: 116px;
        display: grid;
        place-items: center;
        padding: 18px;
        border: 2px dashed var(--proof-card-border, gray);
        border-radius: 6px;
        color: var(--proof-card-ink, black);
        text-align: center;
        background: var(--proof-card-bg, white);
    }

    code {
        padding: 2px 5px;
        border-radius: 4px;
        overflow-wrap: anywhere;
        background: var(--proof-code-bg, #eef2f7);
        color: var(--proof-code-ink, #111111);
        font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
        font-size: 0.95em;
    }
</style>
```
