mirror of
https://github.com/pacnpal/thrillwiki_django_no_react.git
synced 2025-12-20 12:31:22 -05:00
Update activeContext.md and productContext.md with new project information and context
This commit is contained in:
pacnpal
995
memory-bank/design-system/component-library.md
Normal file
995
memory-bank/design-system/component-library.md
Normal file
@@ -0,0 +1,995 @@
|
||||
|
||||
# ThrillWiki Design System - Component Library
|
||||
|
||||
## Overview
|
||||
Comprehensive component library for ThrillWiki's frontend redesign, providing reusable UI patterns that implement the design token system consistently across all templates.
|
||||
|
||||
## Component Categories
|
||||
|
||||
### 1. Layout Components
|
||||
|
||||
#### Container
|
||||
```html
|
||||
<!-- Base container with responsive padding -->
|
||||
<div class="container">
|
||||
<!-- Content -->
|
||||
</div>
|
||||
|
||||
<!-- Fluid container (full width) -->
|
||||
<div class="container-fluid">
|
||||
<!-- Content -->
|
||||
</div>
|
||||
|
||||
<!-- Constrained container (max-width) -->
|
||||
<div class="container-constrained">
|
||||
<!-- Content -->
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.container {
|
||||
width: 100%;
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
padding-left: var(--spacing-container-sm);
|
||||
padding-right: var(--spacing-container-sm);
|
||||
}
|
||||
|
||||
@media (min-width: 640px) {
|
||||
.container {
|
||||
padding-left: var(--spacing-container-md);
|
||||
padding-right: var(--spacing-container-md);
|
||||
}
|
||||
}
|
||||
|
||||
@media (min-width: 1024px) {
|
||||
.container {
|
||||
padding-left: var(--spacing-container-lg);
|
||||
padding-right: var(--spacing-container-lg);
|
||||
}
|
||||
}
|
||||
|
||||
.container-constrained {
|
||||
max-width: 1280px;
|
||||
}
|
||||
|
||||
.container-fluid {
|
||||
width: 100%;
|
||||
padding-left: var(--spacing-container-xs);
|
||||
padding-right: var(--spacing-container-xs);
|
||||
}
|
||||
```
|
||||
|
||||
#### Grid System
|
||||
```html
|
||||
<!-- Responsive grid -->
|
||||
<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
|
||||
<div class="grid-item">Item 1</div>
|
||||
<div class="grid-item">Item 2</div>
|
||||
<div class="grid-item">Item 3</div>
|
||||
</div>
|
||||
|
||||
<!-- Auto-fit grid -->
|
||||
<div class="grid-auto-fit">
|
||||
<div class="grid-item">Item 1</div>
|
||||
<div class="grid-item">Item 2</div>
|
||||
<div class="grid-item">Item 3</div>
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.grid-auto-fit {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
|
||||
gap: var(--spacing-layout-md);
|
||||
}
|
||||
|
||||
.grid-item {
|
||||
min-width: 0; /* Prevent grid blowout */
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Navigation Components
|
||||
|
||||
#### Primary Navigation
|
||||
```html
|
||||
<nav class="nav-primary" x-data="{ mobileOpen: false }">
|
||||
<div class="nav-container">
|
||||
<!-- Logo -->
|
||||
<div class="nav-brand">
|
||||
<a href="/" class="nav-logo">
|
||||
<img src="/static/images/logo.svg" alt="ThrillWiki" class="nav-logo-img">
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<!-- Desktop Navigation -->
|
||||
<div class="nav-links hidden lg:flex">
|
||||
<a href="/parks/" class="nav-link">Parks</a>
|
||||
<a href="/rides/" class="nav-link">Rides</a>
|
||||
<a href="/search/" class="nav-link">Search</a>
|
||||
</div>
|
||||
|
||||
<!-- User Actions -->
|
||||
<div class="nav-actions">
|
||||
<!-- Theme Toggle -->
|
||||
<button class="btn-icon" x-data="themeToggle()" @click="toggle()">
|
||||
<svg x-show="!isDark" class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Sun icon -->
|
||||
</svg>
|
||||
<svg x-show="isDark" class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Moon icon -->
|
||||
</svg>
|
||||
</button>
|
||||
|
||||
<!-- User Menu -->
|
||||
<div class="dropdown" x-data="{ open: false }">
|
||||
<button @click="open = !open" class="btn-icon">
|
||||
<img src="{{ user.avatar.url }}" alt="{{ user.username }}" class="avatar-sm">
|
||||
</button>
|
||||
<div x-show="open" @click.away="open = false" class="dropdown-menu">
|
||||
<a href="/profile/" class="dropdown-item">Profile</a>
|
||||
<a href="/settings/" class="dropdown-item">Settings</a>
|
||||
<hr class="dropdown-divider">
|
||||
<a href="/logout/" class="dropdown-item">Logout</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Mobile Menu Toggle -->
|
||||
<button @click="mobileOpen = !mobileOpen" class="btn-icon lg:hidden">
|
||||
<svg class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Hamburger icon -->
|
||||
</svg>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Mobile Navigation -->
|
||||
<div x-show="mobileOpen" x-transition class="nav-mobile lg:hidden">
|
||||
<div class="nav-mobile-links">
|
||||
<a href="/parks/" class="nav-mobile-link">Parks</a>
|
||||
<a href="/rides/" class="nav-mobile-link">Rides</a>
|
||||
<a href="/search/" class="nav-mobile-link">Search</a>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
```
|
||||
|
||||
```css
|
||||
.nav-primary {
|
||||
background: var(--bg-elevated);
|
||||
border-bottom: 1px solid var(--border-primary);
|
||||
position: sticky;
|
||||
top: 0;
|
||||
z-index: var(--z-sticky);
|
||||
backdrop-filter: blur(8px);
|
||||
}
|
||||
|
||||
.nav-container {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
padding: var(--spacing-component-md) var(--spacing-container-md);
|
||||
max-width: 1280px;
|
||||
margin: 0 auto;
|
||||
}
|
||||
|
||||
.nav-brand {
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.nav-logo-img {
|
||||
height: 2rem;
|
||||
width: auto;
|
||||
}
|
||||
|
||||
.nav-links {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: var(--spacing-component-lg);
|
||||
}
|
||||
|
||||
.nav-link {
|
||||
color: var(--text-secondary);
|
||||
text-decoration: none;
|
||||
font-weight: 500;
|
||||
padding: var(--spacing-component-sm) var(--spacing-component-md);
|
||||
border-radius: var(--radius-md);
|
||||
transition: all var(--transition-fast);
|
||||
}
|
||||
|
||||
.nav-link:hover {
|
||||
color: var(--text-primary);
|
||||
background: var(--interactive-secondary);
|
||||
}
|
||||
|
||||
.nav-link.active {
|
||||
color: var(--text-brand);
|
||||
background: var(--color-primary-50);
|
||||
}
|
||||
|
||||
.dark .nav-link.active {
|
||||
background: var(--color-primary-900);
|
||||
}
|
||||
|
||||
.nav-actions {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: var(--spacing-component-sm);
|
||||
}
|
||||
|
||||
.nav-mobile {
|
||||
border-top: 1px solid var(--border-primary);
|
||||
background: var(--bg-elevated);
|
||||
}
|
||||
|
||||
.nav-mobile-links {
|
||||
padding: var(--spacing-component-md);
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--spacing-component-xs);
|
||||
}
|
||||
|
||||
.nav-mobile-link {
|
||||
color: var(--text-secondary);
|
||||
text-decoration: none;
|
||||
padding: var(--spacing-component-md);
|
||||
border-radius: var(--radius-md);
|
||||
transition: all var(--transition-fast);
|
||||
}
|
||||
|
||||
.nav-mobile-link:hover {
|
||||
color: var(--text-primary);
|
||||
background: var(--interactive-secondary);
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Button Components
|
||||
|
||||
#### Button Variants
|
||||
```html
|
||||
<!-- Primary Button -->
|
||||
<button class="btn btn-primary">Primary Action</button>
|
||||
|
||||
<!-- Secondary Button -->
|
||||
<button class="btn btn-secondary">Secondary Action</button>
|
||||
|
||||
<!-- Outline Button -->
|
||||
<button class="btn btn-outline">Outline Button</button>
|
||||
|
||||
<!-- Ghost Button -->
|
||||
<button class="btn btn-ghost">Ghost Button</button>
|
||||
|
||||
<!-- Icon Button -->
|
||||
<button class="btn-icon">
|
||||
<svg class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Icon -->
|
||||
</svg>
|
||||
</button>
|
||||
|
||||
<!-- Button with Icon -->
|
||||
<button class="btn btn-primary">
|
||||
<svg class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Icon -->
|
||||
</svg>
|
||||
Button Text
|
||||
</button>
|
||||
|
||||
<!-- Loading Button -->
|
||||
<button class="btn btn-primary" :disabled="loading">
|
||||
<svg x-show="loading" class="icon-sm animate-spin" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Spinner icon -->
|
||||
</svg>
|
||||
<span x-show="!loading">Submit</span>
|
||||
<span x-show="loading">Loading...</span>
|
||||
</button>
|
||||
```
|
||||
|
||||
```css
|
||||
.btn {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: var(--spacing-component-xs);
|
||||
padding: var(--spacing-component-sm) var(--spacing-component-md);
|
||||
border: 1px solid transparent;
|
||||
border-radius: var(--radius-button);
|
||||
font-size: var(--text-sm);
|
||||
font-weight: 500;
|
||||
line-height: 1.5;
|
||||
text-decoration: none;
|
||||
cursor: pointer;
|
||||
transition: all var(--transition-fast);
|
||||
user-select: none;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.btn:disabled {
|
||||
opacity: 0.6;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
.btn-primary {
|
||||
background: var(--interactive-primary);
|
||||
color: var(--text-inverse);
|
||||
box-shadow: var(--shadow-button);
|
||||
}
|
||||
|
||||
.btn-primary:hover:not(:disabled) {
|
||||
background: var(--interactive-primary-hover);
|
||||
box-shadow: var(--shadow-button-hover);
|
||||
}
|
||||
|
||||
.btn-primary:active {
|
||||
background: var(--interactive-primary-active);
|
||||
}
|
||||
|
||||
.btn-secondary {
|
||||
background: var(--interactive-secondary);
|
||||
color: var(--text-primary);
|
||||
border-color: var(--border-primary);
|
||||
}
|
||||
|
||||
.btn-secondary:hover:not(:disabled) {
|
||||
background: var(--interactive-secondary-hover);
|
||||
border-color: var(--border-secondary);
|
||||
}
|
||||
|
||||
.btn-outline {
|
||||
background: transparent;
|
||||
color: var(--interactive-primary);
|
||||
border-color: var(--interactive-primary);
|
||||
}
|
||||
|
||||
.btn-outline:hover:not(:disabled) {
|
||||
background: var(--interactive-primary);
|
||||
color: var(--text-inverse);
|
||||
}
|
||||
|
||||
.btn-ghost {
|
||||
background: transparent;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.btn-ghost:hover:not(:disabled) {
|
||||
background: var(--interactive-secondary);
|
||||
color: var(--text-primary);
|
||||
}
|
||||
|
||||
.btn-icon {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
width: 2.5rem;
|
||||
height: 2.5rem;
|
||||
padding: 0;
|
||||
border: none;
|
||||
border-radius: var(--radius-button);
|
||||
background: transparent;
|
||||
color: var(--text-secondary);
|
||||
cursor: pointer;
|
||||
transition: all var(--transition-fast);
|
||||
}
|
||||
|
||||
.btn-icon:hover {
|
||||
background: var(--interactive-secondary);
|
||||
color: var(--text-primary);
|
||||
}
|
||||
|
||||
/* Button Sizes */
|
||||
.btn-sm {
|
||||
padding: var(--spacing-component-xs) var(--spacing-component-sm);
|
||||
font-size: var(--text-xs);
|
||||
}
|
||||
|
||||
.btn-lg {
|
||||
padding: var(--spacing-component-md) var(--spacing-component-lg);
|
||||
font-size: var(--text-base);
|
||||
}
|
||||
|
||||
.btn-xl {
|
||||
padding: var(--spacing-component-lg) var(--spacing-component-xl);
|
||||
font-size: var(--text-lg);
|
||||
}
|
||||
```
|
||||
|
||||
### 4. Form Components
|
||||
|
||||
#### Input Fields
|
||||
```html
|
||||
<!-- Text Input -->
|
||||
<div class="form-group">
|
||||
<label for="park-name" class="form-label">Park Name</label>
|
||||
<input type="text" id="park-name" name="name" class="form-input" placeholder="Enter park name">
|
||||
<div class="form-error" x-show="errors.name" x-text="errors.name"></div>
|
||||
</div>
|
||||
|
||||
<!-- Textarea -->
|
||||
<div class="form-group">
|
||||
<label for="description" class="form-label">Description</label>
|
||||
<textarea id="description" name="description" class="form-textarea" rows="4" placeholder="Enter description"></textarea>
|
||||
</div>
|
||||
|
||||
<!-- Select -->
|
||||
<div class="form-group">
|
||||
<label for="status" class="form-label">Status</label>
|
||||
<select id="status" name="status" class="form-select">
|
||||
<option value="">Select status</option>
|
||||
<option value="operating">Operating</option>
|
||||
<option value="closed">Closed</option>
|
||||
<option value="seasonal">Seasonal</option>
|
||||
</select>
|
||||
</div>
|
||||
|
||||
<!-- Checkbox -->
|
||||
<div class="form-group">
|
||||
<label class="form-checkbox">
|
||||
<input type="checkbox" name="featured" class="form-checkbox-input">
|
||||
<span class="form-checkbox-label">Featured Park</span>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
<!-- Radio Group -->
|
||||
<div class="form-group">
|
||||
<fieldset class="form-fieldset">
|
||||
<legend class="form-legend">Park Type</legend>
|
||||
<div class="form-radio-group">
|
||||
<label class="form-radio">
|
||||
<input type="radio" name="park_type" value="theme" class="form-radio-input">
|
||||
<span class="form-radio-label">Theme Park</span>
|
||||
</label>
|
||||
<label class="form-radio">
|
||||
<input type="radio" name="park_type" value="water" class="form-radio-input">
|
||||
<span class="form-radio-label">Water Park</span>
|
||||
</label>
|
||||
</div>
|
||||
</fieldset>
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.form-group {
|
||||
margin-bottom: var(--spacing-component-lg);
|
||||
}
|
||||
|
||||
.form-label {
|
||||
display: block;
|
||||
font-size: var(--text-sm);
|
||||
font-weight: 500;
|
||||
color: var(--text-primary);
|
||||
margin-bottom: var(--spacing-component-xs);
|
||||
}
|
||||
|
||||
.form-input,
|
||||
.form-textarea,
|
||||
.form-select {
|
||||
width: 100%;
|
||||
padding: var(--spacing-component-sm) var(--spacing-component-md);
|
||||
border: 1px solid var(--border-primary);
|
||||
border-radius: var(--radius-input);
|
||||
background: var(--bg-elevated);
|
||||
color: var(--text-primary);
|
||||
font-size: var(--text-sm);
|
||||
line-height: 1.5;
|
||||
transition: all var(--transition-fast);
|
||||
}
|
||||
|
||||
.form-input:focus,
|
||||
.form-textarea:focus,
|
||||
.form-select:focus {
|
||||
outline: none;
|
||||
border-color: var(--border-focus);
|
||||
box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
|
||||
}
|
||||
|
||||
.form-input.error,
|
||||
.form-textarea.error,
|
||||
.form-select.error {
|
||||
border-color: var(--border-error);
|
||||
}
|
||||
|
||||
.form-error {
|
||||
margin-top: var(--spacing-component-xs);
|
||||
font-size: var(--text-xs);
|
||||
color: var(--color-error-600);
|
||||
}
|
||||
|
||||
.form-textarea {
|
||||
resize: vertical;
|
||||
min-height: 100px;
|
||||
}
|
||||
|
||||
.form-checkbox,
|
||||
.form-radio {
|
||||
display: flex;
|
||||
align-items: flex-start;
|
||||
gap: var(--spacing-component-sm);
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.form-checkbox-input,
|
||||
.form-radio-input {
|
||||
margin: 0;
|
||||
width: 1rem;
|
||||
height: 1rem;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.form-checkbox-label,
|
||||
.form-radio-label {
|
||||
font-size: var(--text-sm);
|
||||
color: var(--text-primary);
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.form-fieldset {
|
||||
border: none;
|
||||
padding: 0;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.form-legend {
|
||||
font-size: var(--text-sm);
|
||||
font-weight: 500;
|
||||
color: var(--text-primary);
|
||||
margin-bottom: var(--spacing-component-sm);
|
||||
}
|
||||
|
||||
.form-radio-group {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--spacing-component-sm);
|
||||
}
|
||||
|
||||
@media (min-width: 640px) {
|
||||
.form-radio-group {
|
||||
flex-direction: row;
|
||||
gap: var(--spacing-component-lg);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 5. Card Components
|
||||
|
||||
#### Basic Card
|
||||
```html
|
||||
<!-- Basic Card -->
|
||||
<div class="card">
|
||||
<div class="card-header">
|
||||
<h3 class="card-title">Card Title</h3>
|
||||
<p class="card-subtitle">Card subtitle</p>
|
||||
</div>
|
||||
<div class="card-body">
|
||||
<p>Card content goes here.</p>
|
||||
</div>
|
||||
<div class="card-footer">
|
||||
<button class="btn btn-primary">Action</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Park Card -->
|
||||
<div class="card card-hover">
|
||||
<div class="card-image">
|
||||
<img src="{{ park.image.url }}" alt="{{ park.name }}" class="card-image-img">
|
||||
<div class="card-image-overlay">
|
||||
<span class="badge badge-{{ park.status }}">{{ park.get_status_display }}</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card-body">
|
||||
<h3 class="card-title">
|
||||
<a href="{{ park.get_absolute_url }}" class="card-title-link">{{ park.name }}</a>
|
||||
</h3>
|
||||
<p class="card-text">{{ park.description|truncatewords:20 }}</p>
|
||||
<div class="card-meta">
|
||||
<span class="card-meta-item">
|
||||
<svg class="icon-xs" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Location icon -->
|
||||
</svg>
|
||||
{{ park.location }}
|
||||
</span>
|
||||
<span class="card-meta-item">
|
||||
<svg class="icon-xs" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Rides icon -->
|
||||
</svg>
|
||||
{{ park.rides.count }} rides
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.card {
|
||||
background: var(--bg-elevated);
|
||||
border: 1px solid var(--border-primary);
|
||||
border-radius: var(--radius-card);
|
||||
box-shadow: var(--shadow-card);
|
||||
overflow: hidden;
|
||||
transition: all var(--transition-fast);
|
||||
}
|
||||
|
||||
.card-hover:hover {
|
||||
box-shadow: var(--shadow-card-hover);
|
||||
transform: translateY(-2px);
|
||||
}
|
||||
|
||||
.card-header {
|
||||
padding: var(--spacing-component-lg);
|
||||
border-bottom: 1px solid var(--border-primary);
|
||||
}
|
||||
|
||||
.card-title {
|
||||
font-size: var(--text-lg);
|
||||
font-weight: 600;
|
||||
color: var(--text-primary);
|
||||
margin: 0 0 var(--spacing-component-xs) 0;
|
||||
}
|
||||
|
||||
.card-subtitle {
|
||||
font-size: var(--text-sm);
|
||||
color: var(--text-secondary);
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.card-title-link {
|
||||
color: inherit;
|
||||
text-decoration: none;
|
||||
transition: color var(--transition-fast);
|
||||
}
|
||||
|
||||
.card-title-link:hover {
|
||||
color: var(--text-brand);
|
||||
}
|
||||
|
||||
.card-body {
|
||||
padding: var(--spacing-component-lg);
|
||||
}
|
||||
|
||||
.card-text {
|
||||
color: var(--text-secondary);
|
||||
line-height: var(--leading-relaxed);
|
||||
margin: 0 0 var(--spacing-component-md) 0;
|
||||
}
|
||||
|
||||
.card-footer {
|
||||
padding: var(--spacing-component-lg);
|
||||
border-top: 1px solid var(--border-primary);
|
||||
background: var(--bg-secondary);
|
||||
}
|
||||
|
||||
.card-image {
|
||||
position: relative;
|
||||
aspect-ratio: 16 / 9;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.card-image-img {
|
||||
width: 100%;
|
||||
height: 100%;
|
||||
object-fit: cover;
|
||||
transition: transform var(--transition-slow);
|
||||
}
|
||||
|
||||
.card-hover:hover .card-image-img {
|
||||
transform: scale(1.05);
|
||||
}
|
||||
|
||||
.card-image-overlay {
|
||||
position: absolute;
|
||||
top: var(--spacing-component-sm);
|
||||
right: var(--spacing-component-sm);
|
||||
}
|
||||
|
||||
.card-meta {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: var(--spacing-component-md);
|
||||
margin-top: var(--spacing-component-md);
|
||||
}
|
||||
|
||||
.card-meta-item {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: var(--spacing-component-xs);
|
||||
font-size: var(--text-xs);
|
||||
color: var(--text-tertiary);
|
||||
}
|
||||
```
|
||||
|
||||
### 6. Modal Components
|
||||
|
||||
#### Modal Structure
|
||||
```html
|
||||
<!-- Modal Trigger -->
|
||||
<button class="btn btn-primary" @click="$dispatch('modal-open', { id: 'park-modal' })">
|
||||
Open Modal
|
||||
</button>
|
||||
|
||||
<!-- Modal -->
|
||||
<div x-data="modal()"
|
||||
x-show="isOpen"
|
||||
x-on:modal-open.window="handleOpen($event.detail)"
|
||||
x-on:modal-close.window="handleClose($event.detail)"
|
||||
class="modal-overlay"
|
||||
x-transition:enter="transition ease-out duration-300"
|
||||
x-transition:enter-start="opacity-0"
|
||||
x-transition:enter-end="opacity-100"
|
||||
x-transition:leave="transition ease-in duration-200"
|
||||
x-transition:leave-start="opacity-100"
|
||||
x-transition:leave-end="opacity-0">
|
||||
|
||||
<div class="modal-container" @click.away="close()">
|
||||
<div class="modal-content"
|
||||
x-transition:enter="transition ease-out duration-300"
|
||||
x-transition:enter-start="opacity-0 transform scale-95"
|
||||
x-transition:enter-end="opacity-100 transform scale-100"
|
||||
x-transition:leave="transition ease-in duration-200"
|
||||
x-transition:leave-start="opacity-100 transform scale-100"
|
||||
x-transition:leave-end="opacity-0 transform scale-95">
|
||||
|
||||
<!-- Modal Header -->
|
||||
<div class="modal-header">
|
||||
<h2 class="modal-title">Modal Title</h2>
|
||||
<button @click="close()" class="btn-icon">
|
||||
<svg class="icon-sm" fill="currentColor" viewBox="0 0 20 20">
|
||||
<!-- Close icon -->
|
||||
</svg>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<!-- Modal Body -->
|
||||
<div class="modal-body">
|
||||
<p>Modal content goes here.</p>
|
||||
</div>
|
||||
|
||||
<!-- Modal Footer -->
|
||||
<div class="modal-footer">
|
||||
<button @click="close()" class="btn btn-secondary">Cancel</button>
|
||||
<button class="btn btn-primary">Confirm</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.modal-overlay {
|
||||
position: fixed;
|
||||
inset: 0;
|
||||
background: var(--bg-overlay);
|
||||
z-index: var(--z-modal);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: var(--spacing-component-md);
|
||||
}
|
||||
|
||||
.modal-container {
|
||||
width: 100%;
|
||||
max-width: 32rem;
|
||||
max-height: 90vh;
|
||||
overflow-y: auto;
|
||||
}
|
||||
|
||||
.modal-content {
|
||||
background: var(--bg-elevated);
|
||||
border-radius: var(--radius-modal);
|
||||
box-shadow: var(--shadow-modal);
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.modal-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
padding: var(--spacing-component-lg);
|
||||
border-bottom: 1px solid var(--border-primary);
|
||||
}
|
||||
|
||||
.modal-title {
|
||||
font-size: var(--text-xl);
|
||||
font-weight: 600;
|
||||
color: var(--text-primary);
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.modal-body {
|
||||
padding: var(--spacing-component-lg);
|
||||
}
|
||||
|
||||
.modal-footer {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
gap: var(--spacing-component-sm);
|
||||
padding: var(--spacing-component-lg);
|
||||
border-top: 1px solid var(--border-primary);
|
||||
background: var(--bg-secondary);
|
||||
}
|
||||
```
|
||||
|
||||
### 7. Utility Components
|
||||
|
||||
#### Icons
|
||||
```html
|
||||
<!-- Icon Sizes -->
|
||||
<svg class="icon-xs" fill="currentColor" viewBox="0 0 20 20"><!-- Icon --></svg>
|
||||
<svg class="icon-sm" fill="currentColor" viewBox="0 0 20 20"><!-- Icon --></svg>
|
||||
<svg class="icon-md" fill="currentColor" viewBox="0 0 20 20"><!-- Icon --></svg>
|
||||
<svg class="icon-lg" fill="currentColor" viewBox="0 0 20 20"><!-- Icon --></svg>
|
||||
<svg class="icon-xl" fill="currentColor" viewBox="0 0 20 20"><!-- Icon --></svg>
|
||||
```
|
||||
|
||||
```css
|
||||
.icon-xs { width: 0.75rem; height: 0.75rem; }
|
||||
.icon-sm { width: 1rem; height: 1rem; }
|
||||
.icon-md { width: 1.25rem; height: 1.25rem; }
|
||||
.icon-lg { width: 1.5rem; height: 1.5rem; }
|
||||
.icon-xl { width: 2rem; height: 2rem; }
|
||||
```
|
||||
|
||||
#### Badges
|
||||
```html
|
||||
<!-- Status Badges -->
|
||||
<span class="badge badge-success">Operating</span>
|
||||
<span class="badge badge-warning">Seasonal</span>
|
||||
<span class="badge badge-error">Closed</span>
|
||||
<span class="badge badge-info">Under Construction</span>
|
||||
|
||||
<!-- Size Variants -->
|
||||
<span class="badge badge-sm badge-primary">Small</span>
|
||||
<span class="badge badge-primary">Default</span>
|
||||
<span class="badge badge-lg badge-primary">Large</span>
|
||||
```
|
||||
|
||||
```css
|
||||
.badge {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
padding: var(--spacing-component-xs) var(--spacing-component-sm);
|
||||
font-size: var(--text-xs);
|
||||
font-weight: 500;
|
||||
border-radius: var(--radius-badge);
|
||||
text-transform: uppercase;
|
||||
letter-spacing: var(--tracking-wide);
|
||||
}
|
||||
|
||||
.badge-sm {
|
||||
padding: 0.125rem var(--spacing-component-xs);
|
||||
font-size: 0.625rem;
|
||||
}
|
||||
|
||||
.badge-lg {
|
||||
padding: var(--spacing-component-sm) var(--spacing-component-md);
|
||||
font-size: var(--text-sm);
|
||||
}
|
||||
|
||||
.badge-primary {
|
||||
background: var(--color-primary-100);
|
||||
color: var(--color-primary-800);
|
||||
}
|
||||
|
||||
.badge-success {
|
||||
background: var(--color-success-100);
|
||||
color: var(--color-success-800);
|
||||
}
|
||||
|
||||
.badge-warning {
|
||||
background: var(--color-warning-100);
|
||||
color: var(--color-warning-800);
|
||||
}
|
||||
|
||||
.badge-error {
|
||||
background: var(--color-error-100);
|
||||
color: var(--color-error-800);
|
||||
}
|
||||
|
||||
.badge-info {
|
||||
background: var(--color-info-100);
|
||||
color: var(--color-info-800);
|
||||
}
|
||||
|
||||
.dark .badge-primary {
|
||||
background: var(--color-primary-900);
|
||||
color: var(--color-primary-200);
|
||||
}
|
||||
|
||||
.dark .badge-success {
|
||||
background: var(--color-success-900);
|
||||
color: var(--color-success-200);
|
||||
}
|
||||
|
||||
.dark .badge-warning {
|
||||
background: var(--color-warning-900);
|
||||
color: var(--color-warning-200);
|
||||
}
|
||||
|
||||
.dark .badge-error {
|
||||
background: var(--color-error-900);
|
||||
color: var(--color-error-200);
|
||||
}
|
||||
|
||||
.dark .badge-info {
|
||||
background: var(--color-info-900);
|
||||
color: var(--color-info-200);
|
||||
}
|
||||
```
|
||||
|
||||
#### Avatars
|
||||
```html
|
||||
<!-- Avatar Sizes -->
|
||||
<img src="/path/to/avatar.jpg" alt="User" class="avatar-xs">
|
||||
<img src="/path/to/avatar.jpg" alt="User" class="avatar-sm">
|
||||
<img src="/path/to/avatar.jpg" alt="User" class="avatar-md">
|
||||
<img src="/path/to/avatar.jpg" alt="User" class="avatar-lg">
|
||||
<img src="/path/to/avatar.jpg" alt="User" class="avatar-xl">
|
||||
|
||||
<!-- Avatar with Fallback -->
|
||||
<div class="avatar-md avatar-fallback">
|
||||
<span>JD</span>
|
||||
</div>
|
||||
```
|
||||
|
||||
```css
|
||||
.avatar-xs,
|
||||
.avatar-sm,
|
||||
.avatar-md,
|
||||
.avatar-lg,
|
||||
.avatar-xl {
|
||||
border-radius: var(--radius-full);
|
||||
object-fit: cover;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.avatar-xs { width: 1.5rem; height: 1.5rem; }
|
||||
.avatar-sm { width: 2rem; height: 2rem; }
|
||||
.avatar-md { width: 2.5rem; height: 2.5rem; }
|
||||
.avatar-lg { width: 3rem; height: 3rem; }
|
||||
.avatar-xl { width: 4rem; height: 4rem; }
|
||||
|
||||
.avatar-fallback {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
background: var(--color-primary-100);
|
||||
color: var(--color-primary-700);
|
||||
font-weight: 500;
|
||||
font-size: 0.875rem;
|
||||
}
|
||||
|
||||
.dark .avatar-fallback {
|
||||
background: var(--color-primary-800);
|
||||
color: var(--color-primary-200);
|
||||
}
|
||||
```
|
||||
|
||||
## Alpine.js Component Patterns
|
||||
|
||||
### Theme Toggle Component
|
||||
```javascript
|
||||
Alpine.data('themeToggle', () => ({
|
||||
isDark: localStorage.getItem('theme') === 'dark' ||
|
||||
(!localStorage.getItem('theme') && window.matchMedia('(prefers-color-scheme: dark)').matches),
|
||||
|
||||
init() {
|
||||
this.updateTheme();
|
||||
},
|
||||
|
||||
toggle() {
|
||||
this.isDark = !this.isDark;
|
||||
this.updateTheme();
|
||||
},
|
||||
|
||||
updateTheme() {
|
||||
if (this.isDark) {
|
||||
document.documentElement.classList.add('dark');
|
||||
localStorage.setItem('theme', 'dark');
|
||||
} else {
|
||||
document.documentElement.classList.remove('dark');
|
||||
localStorage.setItem('theme', 'light');
|
||||
}
|
||||
}
|
||||
}));
|
||||
```
|
||||
|
||||
### Modal Component
|
||||
```javascript
|
||||
Alpine.data
|
||||
Reference in New Issue
Block a user