Htmx/templates/components/sheets.html

{% extends "base.html" %}
{% import "components/macros.html" as ui %}

{% block title %}Slide-over Drawers (Sheets) - Design System Wiki{% endblock %}

{% block content %}
<div class="grow max-w-7xl mx-auto w-full px-4 sm:px-6 lg:px-8 py-10 flex flex-col lg:flex-row gap-8">
    
    <!-- Left Navigation Sidebar -->
    {% include "components/sidebar.html" %}

    <!-- Main Content -->
    <div class="flex-1 space-y-8">
        
        <!-- Header -->
        <div class="pb-6 border-b border-border">
            <span class="text-xs font-semibold text-indigo-400">Overlays</span>
            <h1 class="text-3xl font-extrabold text-slate-100 tracking-tight mt-1">Slide-over Drawers (Sheets)</h1>
            <p class="text-muted-foreground text-sm mt-2 leading-relaxed">
                Right-anchored slide-out sheets designed for detail inspections, metadata lists, settings panels, and form workflows.
            </p>
        </div>

        <!-- Section Sheets -->
        <section class="space-y-4">
            <h2 class="text-lg font-bold text-slate-200">Drawer Showcase & Integration</h2>
            
            <div class="border border-border rounded-3xl p-5 bg-secondary/10 space-y-4">
                <!-- Tab Headers -->
                <div class="flex border-b border-border/60 pb-1.5">
                    <button class="px-3 py-1.5 text-xs font-semibold border-b-2 border-sky-500 text-sky-400" onclick="toggleWikiTabs(this, 'sheet-sandbox')">Interactive Demo</button>
                    <button class="px-3 py-1.5 text-xs font-semibold border-b-2 border-transparent text-muted-foreground hover:text-muted-foreground" onclick="toggleWikiTabs(this, 'sheet-code')">HTML Markup</button>
                </div>
                
                <!-- Demo Viewport -->
                <div id="sheet-sandbox" class="wiki-pane py-2">
                    {{ ui::sheet_trigger(target_id="wiki-demo-sheet", label="Open Right Drawer", variant="indigo") }}
                </div>
                
                <!-- Code Snippet Area -->
                <div id="sheet-code" class="wiki-pane hidden space-y-4">
                    <div class="relative group">
                        <button class="absolute top-2 right-2 p-1.5 rounded-lg border border-border bg-popover/80 backdrop-blur text-[10px] font-semibold text-slate-455 hover:text-white hover:bg-secondary opacity-0 group-hover:opacity-100 transition-opacity duration-200 flex items-center gap-1.5" onclick="copyCodeSnippet(this)">
                            <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 002 2h2a2 2 0 002-2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3"/></svg>
                            Copy Code
                        </button>
                        <pre class="bg-popover p-4 rounded-xl border border-border overflow-x-auto text-[10px] text-sky-400 font-mono"><code>{{ "{%" }} import "components/macros.html" as ui {{ "%}" }}

&lt;!-- Trigger Button (points to sheet element ID) --&gt;
{{ "{{" }} ui::sheet_trigger(target_id="my-sheet-id", label="Open Drawer", variant="indigo") {{ "}}" }}

&lt;!-- Slide Drawer Sheet Element using paired macros --&gt;
{{ "{{" }} ui::sheet_open(id="my-sheet-id", title="Settings", max_width_class="max-w-sm") {{ "}}" }}
    &lt;p class="text-xs text-muted-foreground"&gt;Drawer Body Content&lt;/p&gt;
{{ "{{" }} ui::sheet_close(save_label="Save") {{ "}}" }}</code></pre>
                    </div>
                </div>
            </div>
        </section>

        <!-- Global JS Bindings Documentation -->
        <section class="space-y-4 border-t border-border/60 pt-6">
            <h2 class="text-lg font-bold text-slate-200">How the Global Sheet JS Works</h2>
            <p class="text-xs text-muted-foreground leading-relaxed">
                The global script <code>components.js</code> monitors specific attributes and classes on page load. Here is the operational contract for sheets:
            </p>
            <div class="border border-border bg-card/40 rounded-2xl p-5 overflow-x-auto">
                <table class="w-full border-collapse text-left text-xs">
                    <thead>
                        <tr class="border-b border-border text-muted-foreground font-bold">
                            <th class="pb-2.5 w-1/4">Selector / Class</th>
                            <th class="pb-2.5 w-1/4">Type</th>
                            <th class="pb-2.5">Behavior & Purpose</th>
                        </tr>
                    </thead>
                    <tbody class="divide-y divide-border/40 text-muted-foreground leading-relaxed text-[11px] font-sans">
                        <tr>
                            <td class="py-3 font-mono text-indigo-400 font-semibold">[data-sheet-target]</td>
                            <td class="py-3 font-semibold text-slate-300 text-[10px] uppercase">Attribute</td>
                            <td class="py-3 text-slate-400">
                                Applied to buttons or triggers. The value must match the ID of the sheet container (e.g., <code>data-sheet-target="my-sheet"</code>). Clicking it triggers <code>openSheet("my-sheet")</code>.
                            </td>
                        </tr>
                        <tr>
                            <td class="py-3 font-mono text-indigo-400 font-semibold">.sheet-dialog</td>
                            <td class="py-3 font-semibold text-slate-300 text-[10px] uppercase">Class</td>
                            <td class="py-3 text-slate-400">
                                The outer wrapper sheet container. Starts with the class <code>hidden</code>. Toggled by the script.
                            </td>
                        </tr>
                        <tr>
                            <td class="py-3 font-mono text-indigo-400 font-semibold">.sheet-content</td>
                            <td class="py-3 font-semibold text-slate-300 text-[10px] uppercase">Class</td>
                            <td class="py-3 text-slate-400">
                                The inner slide-over panel card. The JS toggles transition translation classes (removes <code>translate-x-full</code> and adds <code>translate-x-0</code> on show).
                            </td>
                        </tr>
                        <tr>
                            <td class="py-3 font-mono text-indigo-400 font-semibold">.sheet-backdrop</td>
                            <td class="py-3 font-semibold text-slate-300 text-[10px] uppercase">Class</td>
                            <td class="py-3 text-slate-400">
                                The backdrop overlay. The JS toggles its opacity and registers clicks on it to automatically close the sheet.
                            </td>
                        </tr>
                        <tr>
                            <td class="py-3 font-mono text-indigo-400 font-semibold">.sheet-close</td>
                            <td class="py-3 font-semibold text-slate-300 text-[10px] uppercase">Class</td>
                            <td class="py-3 text-slate-400">
                                Applied to close trigger buttons. Clicking any element with this class closes the sheet.
                            </td>
                        </tr>
                    </tbody>
                </table>
            </div>
            <div class="rounded-xl border border-indigo-500/20 bg-indigo-500/5 p-4 text-xs space-y-1">
                <span class="font-bold text-indigo-400 block">💡 What is customizable?</span>
                <p class="text-slate-400 leading-normal">
                    You can freely style the placement, width, colors, borders, and contents of the <code>.sheet-content</code> slide-out panel. The functional slide classes (<code>translate-x-full</code> and <code>translate-x-0</code>) and semantic structure class names must be preserved so the script can locate and slide the sheets dynamically.
                </p>
            </div>
        </section>

        <!-- Confirmation Action Pattern -->
        <section class="space-y-4 border-t border-border/60 pt-6">
            <h2 class="text-lg font-bold text-slate-200">Confirmation Actions (e.g., Deletes)</h2>
            <p class="text-xs text-muted-foreground leading-relaxed">
                Slide-over sheets are highly effective for confirmation dialogs when you want to provide more context, metadata details, or descriptive warnings about the entity being impacted before executing the action.
            </p>

            <div class="border border-border rounded-3xl p-5 bg-secondary/10 space-y-4">
                <!-- Tab Headers -->
                <div class="flex border-b border-border/60 pb-1.5">
                    <button class="px-3 py-1.5 text-xs font-semibold border-b-2 border-sky-500 text-sky-400" onclick="toggleWikiTabs(this, 'confirm-sheet-demo-pane')">Interactive Demo</button>
                    <button class="px-3 py-1.5 text-xs font-semibold border-b-2 border-transparent text-muted-foreground hover:text-muted-foreground" onclick="toggleWikiTabs(this, 'confirm-sheet-markup-form')">Form POST (Standard)</button>
                    <button class="px-3 py-1.5 text-xs font-semibold border-b-2 border-transparent text-muted-foreground hover:text-muted-foreground" onclick="toggleWikiTabs(this, 'confirm-sheet-markup-htmx')">HTMX Delete (AJAX)</button>
                </div>

                <!-- Interactive Demo Pane -->
                <div id="confirm-sheet-demo-pane" class="wiki-pane py-2">
                    <div class="flex items-center gap-4">
                        <span class="text-xs text-slate-400 font-medium">Demo Database Entity:</span>
                        <div class="flex items-center gap-3 px-3 py-2 bg-secondary/20 border border-border rounded-xl">
                            <span class="text-xs font-semibold text-slate-200">User Account: ahmed_shaamil</span>
                            {{ ui::sheet_trigger(target_id="wiki-confirm-delete-sheet", label="Delete User", variant="destructive", extra_class="!px-2.5 !py-1 text-[10px]") }}
                        </div>
                    </div>
                </div>

                <!-- Form POST Code Markup -->
                <div id="confirm-sheet-markup-form" class="wiki-pane hidden space-y-4">
                    <div class="relative group">
                        <button class="absolute top-2 right-2 p-1.5 rounded-lg border border-border bg-popover/80 backdrop-blur text-[10px] font-semibold text-slate-455 hover:text-white hover:bg-secondary opacity-0 group-hover:opacity-100 transition-opacity duration-200 flex items-center gap-1.5" onclick="copyCodeSnippet(this)">
                            <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3"/></svg>
                            Copy Code
                        </button>
                        <pre class="bg-popover p-4 rounded-xl border border-border overflow-x-auto text-[10px] text-sky-400 font-mono"><code>{{ "{%" }} import "components/macros.html" as ui {{ "%}" }}

&lt;!-- 1. Trigger Button --&gt;
{{ "{{" }} ui::sheet_trigger(target_id="delete-sheet-confirm-123", label="Delete Account", variant="destructive") {{ "}}" }}

&lt;!-- 2. Slide Drawer with Form --&gt;
{{ "{%" }} call ui::sheet_open(id="delete-sheet-confirm-123", title="Confirm Account Deletion", max_width_class="max-w-md") {{ "%}" }}
    &lt;form action="/accounts/123/delete" method="POST" class="flex flex-col justify-between h-full space-y-6"&gt;
        &lt;div class="space-y-4 mt-2"&gt;
            &lt;p class="text-xs text-muted-foreground leading-relaxed"&gt;
                You are about to delete this account. This will invalidate all associated access tokens and permanently purge database profiles.
            &lt;/p&gt;
            &lt;div class="p-3.5 rounded-2xl bg-destructive/10 border border-destructive/20 text-[11px] text-destructive-foreground leading-normal"&gt;
                Warning: This action is irreversible. Enter confirmation parameters if required.
            &lt;/div&gt;
        &lt;/div&gt;

        &lt;div class="flex gap-3 pt-4 border-t border-border mt-auto"&gt;
            &lt;button type="button" class="sheet-close flex-1 py-2.5 rounded-xl bg-secondary border border-border hover:bg-secondary/80 transition text-xs font-semibold text-slate-200"&gt;
                Cancel
            &lt;/button&gt;
            &lt;button type="submit" class="flex-1 py-2.5 rounded-xl bg-destructive text-destructive-foreground hover:opacity-90 shadow-md transition text-xs font-bold"&gt;
                Confirm Delete
            &lt;/button&gt;
        &lt;/div&gt;
    &lt;/form&gt;
{{ "{%" }} call ui::sheet_close(save_label="") {{ "%}" }}</code></pre>
                    </div>
                </div>

                <!-- HTMX AJAX Code Markup -->
                <div id="confirm-sheet-markup-htmx" class="wiki-pane hidden space-y-4">
                    <div class="relative group">
                        <button class="absolute top-2 right-2 p-1.5 rounded-lg border border-border bg-popover/80 backdrop-blur text-[10px] font-semibold text-slate-455 hover:text-white hover:bg-secondary opacity-0 group-hover:opacity-100 transition-opacity duration-200 flex items-center gap-1.5" onclick="copyCodeSnippet(this)">
                            <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3"/></svg>
                            Copy Code
                        </button>
                        <pre class="bg-popover p-4 rounded-xl border border-border overflow-x-auto text-[10px] text-sky-400 font-mono"><code>{{ "{%" }} import "components/macros.html" as ui {{ "%}" }}

&lt;!-- 1. Trigger Button --&gt;
{{ "{{" }} ui::sheet_trigger(target_id="delete-sheet-htmx-123", label="Delete Account", variant="destructive") {{ "}}" }}

&lt;!-- 2. Slide Drawer with HTMX --&gt;
{{ "{%" }} call ui::sheet_open(id="delete-sheet-htmx-123", title="Confirm Account Deletion", max_width_class="max-w-md") {{ "%}" }}
    &lt;div class="flex flex-col justify-between h-full space-y-6"&gt;
        &lt;div class="space-y-4 mt-2"&gt;
            &lt;p class="text-xs text-muted-foreground leading-relaxed"&gt;
                Are you sure you want to delete this account? This triggers an async HTMX request and removes the element.
            &lt;/p&gt;
        &lt;/div&gt;

        &lt;div class="flex gap-3 pt-4 border-t border-border mt-auto"&gt;
            &lt;button type="button" class="sheet-close flex-1 py-2.5 rounded-xl bg-secondary border border-border hover:bg-secondary/80 transition text-xs font-semibold text-slate-200"&gt;
                Cancel
            &lt;/button&gt;
            &lt;button type="button" 
                    hx-delete="/accounts/123" 
                    hx-target="#account-row-123" 
                    hx-swap="outerHTML"
                    class="sheet-close flex-1 py-2.5 rounded-xl bg-destructive text-destructive-foreground hover:opacity-90 shadow-md transition text-xs font-bold"&gt;
                Confirm Delete
            &lt;/button&gt;
        &lt;/div&gt;
    &lt;/div&gt;
{{ "{%" }} call ui::sheet_close(save_label="") {{ "%}" }}</code></pre>
                    </div>
                </div>
            </div>
        </section>



    </div>
</div>

<!-- Interactive Sheet Sandbox Element using paired macros -->
{{ ui::sheet_open(id="wiki-demo-sheet", title="Drawer Panel Properties", max_width_class="max-w-sm") }}
    <p class="text-xs text-slate-405 leading-relaxed">This slide-over panel demonstrates real-time sidebar parameter adjustments, sliding in from the right edge with hardware transitions.</p>
{{ ui::sheet_close(save_label="Save Properties") }}

<!-- Interactive Confirm Delete Sheet Element -->
{{ ui::sheet_open(id="wiki-confirm-delete-sheet", title="Confirm Account Deletion", max_width_class="max-w-sm") }}
    <p class="text-xs text-slate-400 leading-relaxed mt-2">
        Are you sure you want to permanently delete user <strong class="text-slate-200">ahmed_shaamil</strong>? All database records and linked files will be removed.
    </p>
    </div> <!-- Closes .space-y-4 -->

    <!-- Custom Footer Buttons -->
    <div class="flex gap-3 pt-4 border-t border-border mt-auto">
        <button class="sheet-close flex-1 py-2.5 rounded-xl bg-secondary border border-border hover:bg-secondary/80 transition text-xs font-semibold text-slate-200">
            Cancel
        </button>
        <button class="sheet-close flex-1 py-2.5 rounded-xl bg-rose-600 hover:bg-rose-500 text-white transition text-xs font-bold shadow-lg shadow-rose-650/10" onclick="showToast('User account ahmed_shaamil deleted successfully!')">
            Confirm Delete
        </button>
    </div>
</div> <!-- Closes .sheet-content -->
</div> <!-- Closes .absolute -->
</div> <!-- Closes .sheet-dialog -->


<script>
    function toggleWikiTabs(btn, paneId) {
        const card = btn.closest('.border-border');
        if (!card) return;
        card.querySelectorAll('button').forEach(b => {
            b.classList.remove('border-sky-500', 'text-sky-400');
            b.classList.add('border-transparent', 'text-muted-foreground', 'hover:text-muted-foreground');
        });
        btn.classList.remove('border-transparent', 'text-muted-foreground', 'hover:text-muted-foreground');
        btn.classList.add('border-sky-500', 'text-sky-400');
        card.querySelectorAll('.wiki-pane').forEach(p => p.classList.add('hidden'));
        const target = card.querySelector('#' + paneId);
        if (target) target.classList.remove('hidden');
    }
</script>
{% endblock %}