mirror of
https://github.com/jaandrle/deka-dom-el
synced 2025-04-02 04:05:52 +02:00
716 lines
17 KiB
JavaScript
716 lines
17 KiB
JavaScript
/**
|
|
* Case Study: Task Manager Application
|
|
*
|
|
* This example demonstrates:
|
|
* - Complex state management with signals
|
|
* - Drag and drop functionality
|
|
* - Local storage persistence
|
|
* - Responsive design for different devices
|
|
*/
|
|
|
|
import { el, on, dispatchEvent, scope } from "deka-dom-el";
|
|
import { S } from "deka-dom-el/signals";
|
|
|
|
/** @typedef {{ id: number, title: string, description: string, priority: string, status: string }} Task */
|
|
/**
|
|
* Task Manager Component
|
|
* @returns {HTMLElement} Task manager UI
|
|
*/
|
|
export function TaskManager() {
|
|
// <Tasks store>
|
|
const STORAGE_KEY = 'dde-task-manager';
|
|
const STATUSES = {
|
|
TODO: 'todo',
|
|
IN_PROGRESS: 'in-progress',
|
|
DONE: 'done'
|
|
};
|
|
/** @type {Task[]} */
|
|
let initialTasks = [];
|
|
try {
|
|
const saved = localStorage.getItem(STORAGE_KEY);
|
|
if (saved) {
|
|
initialTasks = JSON.parse(saved);
|
|
}
|
|
} catch (e) {
|
|
console.error('Failed to load tasks from localStorage', e);
|
|
}
|
|
if (!initialTasks.length) {
|
|
initialTasks = [
|
|
{ id: 1, title: 'Create project structure', description: 'Set up folders and initial files',
|
|
status: STATUSES.DONE, priority: 'high' },
|
|
{ id: 2, title: 'Design UI components', description: 'Create mockups for main views',
|
|
status: STATUSES.IN_PROGRESS, priority: 'medium' },
|
|
{ id: 3, title: 'Implement authentication', description: 'Set up user login and registration',
|
|
status: STATUSES.TODO, priority: 'high' },
|
|
{ id: 4, title: 'Write documentation', description: 'Document API endpoints and usage examples',
|
|
status: STATUSES.TODO, priority: 'low' },
|
|
];
|
|
}
|
|
const tasks = S(initialTasks, {
|
|
add(task) { this.value.push(task); },
|
|
remove(id) { this.value = this.value.filter(task => task.id !== id); },
|
|
update(id, task) {
|
|
const current= this.value.find(t => t.id === id);
|
|
if (current) Object.assign(current, task);
|
|
}
|
|
});
|
|
S.on(tasks, value => {
|
|
try {
|
|
localStorage.setItem(STORAGE_KEY, JSON.stringify(value));
|
|
} catch (e) {
|
|
console.error('Failed to save tasks to localStorage', e);
|
|
}
|
|
});
|
|
// </Tasks store>
|
|
|
|
const filterPriority = S('all');
|
|
const searchQuery = S('');
|
|
// Filtered tasks based on priority and search query
|
|
const filteredTasks = S(() => {
|
|
let filtered = tasks.get();
|
|
|
|
// Filter by priority
|
|
if (filterPriority.get() !== 'all') {
|
|
filtered = filtered.filter(task => task.priority === filterPriority.get());
|
|
}
|
|
|
|
// Filter by search query
|
|
const query = searchQuery.get().toLowerCase();
|
|
if (query) {
|
|
filtered = filtered.filter(task =>
|
|
task.title.toLowerCase().includes(query) ||
|
|
task.description.toLowerCase().includes(query)
|
|
);
|
|
}
|
|
|
|
return filtered;
|
|
});
|
|
/** Tasks grouped by status for display in columns */
|
|
const tasksByStatus = S(() => {
|
|
const filtered = filteredTasks.get();
|
|
return {
|
|
[STATUSES.TODO]: filtered.filter(t => t.status === STATUSES.TODO),
|
|
[STATUSES.IN_PROGRESS]: filtered.filter(t => t.status === STATUSES.IN_PROGRESS),
|
|
[STATUSES.DONE]: filtered.filter(t => t.status === STATUSES.DONE)
|
|
};
|
|
});
|
|
|
|
// <Add> signals and handlers for adding new tasks
|
|
const newTask = { title: '', description: '', priority: 'medium' };
|
|
const onAddTask = e => {
|
|
e.preventDefault();
|
|
if (!newTask.title) return;
|
|
|
|
S.action(tasks, "add", {
|
|
id: Date.now(),
|
|
status: STATUSES.TODO,
|
|
...newTask
|
|
});
|
|
e.target.reset();
|
|
};
|
|
// </Add>
|
|
const onCardEdit= on("card:edit", /** @param {CardEditEvent} ev */({ detail: [ id, task ] })=>
|
|
S.action(tasks, "update", id, task));
|
|
const onCardDelete= on("card:delete", /** @param {CardDeleteEvent} ev */({ detail: id })=>
|
|
S.action(tasks, "remove", id));
|
|
|
|
const { onDragable, onDragArea }= moveElementAddon(
|
|
(id, status) => S.action(tasks, "update", id, { status })
|
|
);
|
|
|
|
// Build the task manager UI
|
|
return el("div", { className: "task-manager" }).append(
|
|
el("header", { className: "app-header" }).append(
|
|
el("h1", "DDE Task Manager"),
|
|
el("div", { className: "app-controls" }).append(
|
|
el("input", {
|
|
type: "text",
|
|
placeholder: "Search tasks...",
|
|
value: searchQuery.get()
|
|
}, on("input", e => searchQuery.set(e.target.value))),
|
|
el("select", null,
|
|
on.defer(el=> el.value= filterPriority.get()),
|
|
on("change", e => filterPriority.set(e.target.value))
|
|
).append(
|
|
el("option", { value: "all", textContent: "All Priorities" }),
|
|
el("option", { value: "low", textContent: "Low Priority" }),
|
|
el("option", { value: "medium", textContent: "Medium Priority" }),
|
|
el("option", { value: "high", textContent: "High Priority" })
|
|
)
|
|
)
|
|
),
|
|
|
|
// Add new task form
|
|
el("form", { className: "new-task-form" }, on("submit", onAddTask)).append(
|
|
el("div", { className: "form-row" }).append(
|
|
el("input", {
|
|
type: "text",
|
|
placeholder: "New task title",
|
|
value: newTask.title,
|
|
required: true
|
|
}, on("input", e => newTask.title= e.target.value.trim())),
|
|
el("select", null,
|
|
on.defer(el=> el.value= newTask.priority),
|
|
on("change", e => newTask.priority= e.target.value)
|
|
).append(
|
|
el("option", { value: "low", textContent: "Low" }),
|
|
el("option", { value: "medium", textContent: "Medium" }),
|
|
el("option", { value: "high", textContent: "High" })
|
|
),
|
|
el("button", { type: "submit", className: "add-btn" }).append("Add Task")
|
|
),
|
|
el("textarea", {
|
|
placeholder: "Task description (optional)",
|
|
value: newTask.description
|
|
}, on("input", e => newTask.description= e.target.value.trim()))
|
|
),
|
|
|
|
// Task board with columns
|
|
el("div", { className: "task-board" }).append(
|
|
// Todo column
|
|
el("div", {
|
|
id: `column-${STATUSES.TODO}`,
|
|
className: "task-column"
|
|
}, onDragArea(STATUSES.TODO)).append(
|
|
el("h2", { className: "column-header" }).append(
|
|
"To Do ",
|
|
el("span", {
|
|
textContent: S(() => tasksByStatus.get()[STATUSES.TODO].length),
|
|
className: "task-count"
|
|
}),
|
|
),
|
|
S.el(S(() => tasksByStatus.get()[STATUSES.TODO]), tasks =>
|
|
el("div", { className: "column-tasks" }).append(
|
|
...tasks.map(task=> el(TaskCard, { task, onDragable }, onCardEdit, onCardDelete))
|
|
)
|
|
)
|
|
),
|
|
|
|
// In Progress column
|
|
el("div", {
|
|
id: `column-${STATUSES.IN_PROGRESS}`,
|
|
className: "task-column"
|
|
}, onDragArea(STATUSES.IN_PROGRESS)).append(
|
|
el("h2", { className: "column-header" }).append(
|
|
"In Progress ",
|
|
el("span", {
|
|
textContent: S(() => tasksByStatus.get()[STATUSES.IN_PROGRESS].length),
|
|
className: "task-count",
|
|
}),
|
|
),
|
|
S.el(S(() => tasksByStatus.get()[STATUSES.IN_PROGRESS]), tasks =>
|
|
el("div", { className: "column-tasks" }).append(
|
|
...tasks.map(task=> el(TaskCard, { task, onDragable }, onCardEdit, onCardDelete))
|
|
)
|
|
)
|
|
),
|
|
|
|
// Done column
|
|
el("div", {
|
|
id: `column-${STATUSES.DONE}`,
|
|
className: "task-column"
|
|
}, onDragArea(STATUSES.DONE)).append(
|
|
el("h2", { className: "column-header" }).append(
|
|
"Done ",
|
|
el("span", {
|
|
textContent: S(() => tasksByStatus.get()[STATUSES.DONE].length),
|
|
className: "task-count",
|
|
}),
|
|
),
|
|
S.el(S(() => tasksByStatus.get()[STATUSES.DONE]), tasks =>
|
|
el("div", { className: "column-tasks" }).append(
|
|
...tasks.map(task=> el(TaskCard, { task, onDragable }, onCardEdit, onCardDelete))
|
|
)
|
|
)
|
|
)
|
|
),
|
|
);
|
|
}
|
|
/** @typedef {CustomEvent<[ string, Task ]>} CardEditEvent */
|
|
/** @typedef {CustomEvent<string>} CardDeleteEvent */
|
|
/**
|
|
* Task Card Component
|
|
* @type {(props: { task: Task, onDragable: (id: number) => ddeElementAddon<HTMLDivElement> }) => HTMLElement}
|
|
* @fires {CardEditEvent} card:edit
|
|
* @fires {CardDeleteEvent} card:delete
|
|
* */
|
|
function TaskCard({ task, onDragable }){
|
|
const { host }= scope;
|
|
const isEditing = S(false);
|
|
const onEditStart = () => isEditing.set(true);
|
|
|
|
const dispatchEdit= dispatchEvent("card:edit", host);
|
|
const dispatchDelete= dispatchEvent("card:delete", host).bind(null, task.id);
|
|
|
|
return el("div", {
|
|
id: `task-${task.id}`,
|
|
className: `task-card priority-${task.priority}`,
|
|
draggable: true
|
|
}, onDragable(task.id)).append(
|
|
S.el(isEditing, editing => editing
|
|
? el(EditMode)
|
|
: el().append(
|
|
el("div", { className: "task-header" }).append(
|
|
el("h3", { className: "task-title", textContent: task.title }),
|
|
el("div", { className: "task-actions" }).append(
|
|
el("button", {
|
|
textContent: "✎",
|
|
className: "edit-btn",
|
|
ariaLabel: "Edit task"
|
|
}, on("click", onEditStart)),
|
|
el("button", {
|
|
textContent: "✕",
|
|
className: "delete-btn",
|
|
ariaLabel: "Delete task"
|
|
}, on("click", dispatchDelete))
|
|
)
|
|
),
|
|
!task.description
|
|
? el()
|
|
: el("p", { className: "task-description", textContent: task.description }),
|
|
el("div", { className: "task-meta" }).append(
|
|
el("span", {
|
|
className: `priority-badge priority-${task.priority}`,
|
|
textContent: task.priority.charAt(0).toUpperCase() + task.priority.slice(1)
|
|
})
|
|
)
|
|
)
|
|
)
|
|
);
|
|
function EditMode(){
|
|
const onSubmit = on("submit", e => {
|
|
e.preventDefault();
|
|
const formData = new FormData(/** @type {HTMLFormElement} */(e.target));
|
|
const title = formData.get("title");
|
|
const description = formData.get("description");
|
|
const priority = formData.get("priority");
|
|
isEditing.set(false);
|
|
dispatchEdit([ task.id, { title, description, priority } ]);
|
|
})
|
|
const onEditCancel = () => isEditing.set(false);
|
|
|
|
return el("form", { className: "task-edit-form" }, onSubmit).append(
|
|
el("input", {
|
|
name: "title",
|
|
className: "task-title-input",
|
|
defaultValue: task.title,
|
|
placeholder: "Task title",
|
|
required: true,
|
|
autoFocus: true
|
|
}),
|
|
el("textarea", {
|
|
name: "description",
|
|
className: "task-desc-input",
|
|
defaultValue: task.description,
|
|
placeholder: "Description (optional)"
|
|
}),
|
|
el("select", {
|
|
name: "priority",
|
|
}, on.defer(el=> el.value = task.priority)).append(
|
|
el("option", { value: "low", textContent: "Low Priority" }),
|
|
el("option", { value: "medium", textContent: "Medium Priority" }),
|
|
el("option", { value: "high", textContent: "High Priority" })
|
|
),
|
|
el("div", { className: "task-edit-actions" }).append(
|
|
el("button", {
|
|
textContent: "Cancel",
|
|
type: "button",
|
|
className: "cancel-btn"
|
|
}, on("click", onEditCancel)),
|
|
el("button", {
|
|
textContent: "Save",
|
|
type: "submit",
|
|
className: "save-btn"
|
|
})
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Helper function to handle move an element
|
|
* @param {(id: string, status: string) => void} onMoved
|
|
* */
|
|
function moveElementAddon(onMoved){
|
|
let draggedTaskId = null;
|
|
function onDragable(id) {
|
|
return element => {
|
|
on("dragstart", e => {
|
|
draggedTaskId= id;
|
|
e.dataTransfer.effectAllowed = 'move';
|
|
|
|
// Add some styling to the element being dragged
|
|
setTimeout(() => {
|
|
const el = document.getElementById(`task-${id}`);
|
|
if (el) el.classList.add('dragging');
|
|
}, 0);
|
|
})(element);
|
|
|
|
on("dragend", () => {
|
|
draggedTaskId= null;
|
|
|
|
// Remove the styling
|
|
const el = document.getElementById(`task-${id}`);
|
|
if (el) el.classList.remove('dragging');
|
|
})(element);
|
|
};
|
|
}
|
|
function onDragArea(status) {
|
|
return element => {
|
|
on("dragover", e => {
|
|
e.preventDefault();
|
|
e.dataTransfer.dropEffect = 'move';
|
|
|
|
// Add a visual indicator for the drop target
|
|
const column = document.getElementById(`column-${status}`);
|
|
if (column) column.classList.add('drag-over');
|
|
})(element);
|
|
|
|
on("dragleave", () => {
|
|
// Remove the visual indicator
|
|
const column = document.getElementById(`column-${status}`);
|
|
if (column) column.classList.remove('drag-over');
|
|
})(element);
|
|
|
|
on("drop", e => {
|
|
e.preventDefault();
|
|
const id = draggedTaskId;
|
|
if (id) onMoved(id, status);
|
|
// Remove the visual indicator
|
|
const column = document.getElementById(`column-${status}`);
|
|
if (column) column.classList.remove('drag-over');
|
|
})(element);
|
|
};
|
|
}
|
|
return { onDragable, onDragArea };
|
|
}
|
|
|
|
// Render the component
|
|
document.body.append(
|
|
el("div", { style: "padding: 20px; background: #f5f5f5; min-height: 100vh;" }).append(
|
|
el(TaskManager)
|
|
),
|
|
el("style", `
|
|
.task-manager {
|
|
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
|
max-width: 1200px;
|
|
margin: 0 auto;
|
|
padding: 1rem;
|
|
color: #333;
|
|
}
|
|
|
|
.app-header {
|
|
display: flex;
|
|
justify-content: space-between;
|
|
align-items: center;
|
|
margin-bottom: 1.5rem;
|
|
flex-wrap: wrap;
|
|
gap: 1rem;
|
|
}
|
|
|
|
.app-header h1 {
|
|
margin: 0;
|
|
color: #2d3748;
|
|
}
|
|
|
|
.app-controls {
|
|
display: flex;
|
|
gap: 1rem;
|
|
}
|
|
|
|
.app-controls input,
|
|
.app-controls select {
|
|
padding: 0.5rem;
|
|
border: 1px solid #e2e8f0;
|
|
border-radius: 4px;
|
|
font-size: 0.9rem;
|
|
}
|
|
|
|
.new-task-form {
|
|
background: white;
|
|
padding: 1.5rem;
|
|
border-radius: 8px;
|
|
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.05);
|
|
margin-bottom: 2rem;
|
|
}
|
|
|
|
.form-row {
|
|
display: flex;
|
|
gap: 1rem;
|
|
margin-bottom: 1rem;
|
|
}
|
|
|
|
.form-row input {
|
|
flex-grow: 1;
|
|
padding: 0.75rem;
|
|
border: 1px solid #e2e8f0;
|
|
border-radius: 4px;
|
|
font-size: 1rem;
|
|
}
|
|
|
|
.form-row select {
|
|
width: 100px;
|
|
padding: 0.75rem;
|
|
border: 1px solid #e2e8f0;
|
|
border-radius: 4px;
|
|
font-size: 1rem;
|
|
}
|
|
|
|
.add-btn {
|
|
background: #4a90e2;
|
|
color: white;
|
|
border: none;
|
|
border-radius: 4px;
|
|
padding: 0.75rem 1.5rem;
|
|
font-size: 1rem;
|
|
cursor: pointer;
|
|
transition: background 0.2s ease;
|
|
}
|
|
|
|
.add-btn:hover {
|
|
background: #3a7bc8;
|
|
}
|
|
|
|
.new-task-form textarea {
|
|
width: 100%;
|
|
padding: 0.75rem;
|
|
border: 1px solid #e2e8f0;
|
|
border-radius: 4px;
|
|
font-size: 1rem;
|
|
resize: vertical;
|
|
min-height: 80px;
|
|
}
|
|
|
|
.task-board {
|
|
display: grid;
|
|
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
|
|
gap: 1.5rem;
|
|
}
|
|
|
|
.task-column {
|
|
background: #f7fafc;
|
|
border-radius: 8px;
|
|
padding: 1rem;
|
|
min-height: 400px;
|
|
transition: background 0.2s ease;
|
|
}
|
|
|
|
.column-header {
|
|
margin-top: 0;
|
|
padding-bottom: 0.75rem;
|
|
border-bottom: 2px solid #e2e8f0;
|
|
font-size: 1.25rem;
|
|
color: #2d3748;
|
|
display: flex;
|
|
align-items: center;
|
|
}
|
|
|
|
.task-count {
|
|
display: inline-flex;
|
|
justify-content: center;
|
|
align-items: center;
|
|
background: #e2e8f0;
|
|
color: #4a5568;
|
|
border-radius: 50%;
|
|
width: 25px;
|
|
height: 25px;
|
|
font-size: 0.875rem;
|
|
margin-left: 0.5rem;
|
|
}
|
|
|
|
.column-tasks {
|
|
margin-top: 1rem;
|
|
display: flex;
|
|
flex-direction: column;
|
|
gap: 1rem;
|
|
min-height: 200px;
|
|
}
|
|
|
|
.task-card {
|
|
background: white;
|
|
border-radius: 6px;
|
|
padding: 1rem;
|
|
box-shadow: 0 2px 5px rgba(0, 0, 0, 0.05);
|
|
cursor: grab;
|
|
transition: transform 0.2s ease, box-shadow 0.2s ease;
|
|
position: relative;
|
|
border-left: 4px solid #ccc;
|
|
}
|
|
|
|
.task-card:hover {
|
|
transform: translateY(-3px);
|
|
box-shadow: 0 5px 10px rgba(0, 0, 0, 0.1);
|
|
}
|
|
|
|
.task-card.dragging {
|
|
opacity: 0.5;
|
|
cursor: grabbing;
|
|
}
|
|
|
|
.task-card.priority-low {
|
|
border-left-color: #38b2ac;
|
|
}
|
|
|
|
.task-card.priority-medium {
|
|
border-left-color: #ecc94b;
|
|
}
|
|
|
|
.task-card.priority-high {
|
|
border-left-color: #e53e3e;
|
|
}
|
|
|
|
.task-header {
|
|
display: flex;
|
|
justify-content: space-between;
|
|
align-items: flex-start;
|
|
margin-bottom: 0.5rem;
|
|
}
|
|
|
|
.task-title {
|
|
margin: 0;
|
|
font-size: 1.1rem;
|
|
color: #2d3748;
|
|
word-break: break-word;
|
|
}
|
|
|
|
.task-description {
|
|
margin: 0.5rem 0;
|
|
font-size: 0.9rem;
|
|
color: #4a5568;
|
|
word-break: break-word;
|
|
}
|
|
|
|
.task-actions {
|
|
display: flex;
|
|
gap: 0.5rem;
|
|
}
|
|
|
|
.edit-btn,
|
|
.delete-btn {
|
|
background: none;
|
|
border: none;
|
|
font-size: 1rem;
|
|
cursor: pointer;
|
|
width: 24px;
|
|
height: 24px;
|
|
display: inline-flex;
|
|
justify-content: center;
|
|
align-items: center;
|
|
border-radius: 50%;
|
|
color: #718096;
|
|
transition: background 0.2s ease, color 0.2s ease;
|
|
}
|
|
|
|
.edit-btn:hover {
|
|
background: #edf2f7;
|
|
color: #4a5568;
|
|
}
|
|
|
|
.delete-btn:hover {
|
|
background: #fed7d7;
|
|
color: #e53e3e;
|
|
}
|
|
|
|
.task-meta {
|
|
display: flex;
|
|
justify-content: space-between;
|
|
align-items: center;
|
|
margin-top: 0.75rem;
|
|
}
|
|
|
|
.priority-badge {
|
|
font-size: 0.75rem;
|
|
padding: 0.2rem 0.5rem;
|
|
border-radius: 4px;
|
|
font-weight: 500;
|
|
}
|
|
|
|
.priority-badge.priority-low {
|
|
background: #e6fffa;
|
|
color: #2c7a7b;
|
|
}
|
|
|
|
.priority-badge.priority-medium {
|
|
background: #fefcbf;
|
|
color: #975a16;
|
|
}
|
|
|
|
.priority-badge.priority-high {
|
|
background: #fed7d7;
|
|
color: #c53030;
|
|
}
|
|
|
|
.drag-over {
|
|
background: #f0f9ff;
|
|
border: 2px dashed #4a90e2;
|
|
}
|
|
|
|
.task-edit-form {
|
|
display: flex;
|
|
flex-direction: column;
|
|
gap: 0.75rem;
|
|
}
|
|
|
|
.task-title-input,
|
|
.task-desc-input {
|
|
width: 100%;
|
|
padding: 0.5rem;
|
|
border: 1px solid #e2e8f0;
|
|
border-radius: 4px;
|
|
font-size: 0.9rem;
|
|
}
|
|
|
|
.task-desc-input {
|
|
min-height: 60px;
|
|
resize: vertical;
|
|
}
|
|
|
|
.task-edit-actions {
|
|
display: flex;
|
|
justify-content: flex-end;
|
|
gap: 0.5rem;
|
|
margin-top: 0.5rem;
|
|
}
|
|
|
|
.cancel-btn,
|
|
.save-btn {
|
|
padding: 0.4rem 0.75rem;
|
|
border-radius: 4px;
|
|
font-size: 0.9rem;
|
|
cursor: pointer;
|
|
}
|
|
|
|
.cancel-btn {
|
|
background: #edf2f7;
|
|
color: #4a5568;
|
|
border: 1px solid #e2e8f0;
|
|
}
|
|
|
|
.save-btn {
|
|
background: #4a90e2;
|
|
color: white;
|
|
border: none;
|
|
}
|
|
|
|
@media (max-width: 768px) {
|
|
.app-header {
|
|
flex-direction: column;
|
|
align-items: flex-start;
|
|
}
|
|
|
|
.app-controls {
|
|
width: 100%;
|
|
flex-direction: column;
|
|
}
|
|
|
|
.form-row {
|
|
flex-direction: column;
|
|
}
|
|
|
|
.task-board {
|
|
grid-template-columns: 1fr;
|
|
}
|
|
}
|
|
`)
|
|
);
|