萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

HTML5 可拖曳顯隱導航選單:Canvas 互動與原生 Drag API 實作解析

HTML5 引入原生拖放 API (Drag and Drop API) 與 <canvas> 2D 繪圖環境,讓瀏覽器具備桌面級互動能力。本文解析一個可拖曳、滑鼠懸停展開/收合的導航選單實作,展示 HTML5 事件模型、Canvas 繪圖、CSS 視覺狀態管理的綜合運用。

核心技術棧

  • Drag & Drop API:draggable、ondragstart、ondrag、ondragend、ondragover、ondrop
  • Canvas 2D Context:getContext('2d')、繪製路徑、文字、圖片、動畫幀
  • CSS3 視覺狀態:transition、transform、opacity、pointer-events
  • 請求動畫幀:requestAnimationFrame 實現平滑展開/收合動畫

HTML 結構

<!DOCTYPE html>
<html lang="zh-TW">
<head>
    <meta charset="UTF-8">
    <title>可拖曳導航選單</title>
    <style> /* CSS 見下方 */ </style>
</head>
<body>
    <canvas id="navCanvas" width="200" height="400">
        您的瀏覽器不支援 Canvas,請升級。
    </canvas>
    <nav id="navMenu" class="collapsed">
        <button id="toggleBtn" aria-label="展開選單">☰</button>
        <ul>
            <li><a href="#">選單項目一</a></li>
            <li><a href="#">選單項目二</a></li>
            <li><a href="#">選單項目三</a></li>
            <li><a href="#">選單項目四</a></li>
        </ul>
    </nav>
    <script> /* JS 見下方 */ </script>
</body>
</html>

CSS 視覺與動畫

#navCanvas {
    position: fixed;
    top: 50%; left: 10px;
    transform: translateY(-50%);
    z-index: 1000;
    cursor: grab;
    background: rgba(30, 30, 40, 0.9);
    border-radius: 8px;
    box-shadow: 0 4px 20px rgba(0,0,0,0.3);
    transition: transform 0.2s, box-shadow 0.2s;
}
#navCanvas:active { cursor: grabbing; }

#navMenu {
    position: fixed;
    top: 50%; left: 220px;
    transform: translateY(-50%) translateX(-100%);
    width: 240px;
    background: #fff;
    border-radius: 8px;
    box-shadow: 0 4px 20px rgba(0,0,0,0.15);
    opacity: 0;
    visibility: hidden;
    pointer-events: none;
    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
    z-index: 999;
}
#navMenu.expanded {
    transform: translateY(-50%) translateX(0);
    opacity: 1;
    visibility: visible;
    pointer-events: auto;
}
#navMenu ul { list-style: none; padding: 8px 0; margin: 0; }
#navMenu a { display: block; padding: 12px 20px; color: #333; text-decoration: none; transition: background 0.15s; }
#navMenu a:hover { background: #f0f4f8; color: #0066cc; }
#toggleBtn {
    position: absolute; top: -12px; right: -12px;
    width: 40px; height: 40px;
    border-radius: 50%; border: none;
    background: #0066cc; color: #fff;
    font-size: 18px; cursor: pointer;
    box-shadow: 0 2px 8px rgba(0,102,204,0.3);
}

JavaScript 核心邏輯

// === 狀態管理 ===
const canvas = document.getElementById('navCanvas');
const menu = document.getElementById('navMenu');
const toggleBtn = document.getElementById('toggleBtn');
let isDragging = false;
let dragOffset = { x: 0, y: 0 };
let animFrameId = null;

// === Canvas 繪製邏輯 (示意:繪製圖示/狀態) ===
const ctx = canvas.getContext('2d');
function drawCanvas() {
    ctx.clearRect(0, 0, canvas.width, canvas.height);
    // 繪製導航圖示、通知徽章、動態效果等
    ctx.fillStyle = '#0066cc';
    ctx.beginPath();
    ctx.arc(50, 50, 30, 0, Math.PI * 2);
    ctx.fill();
    ctx.fillStyle = '#fff';
    ctx.font = '24px sans-serif';
    ctx.textAlign = 'center';
    ctx.textBaseline = 'middle';
    ctx.fillText('☰', 50, 52);
    
    // 如果有通知數
    if (window.unreadCount > 0) {
        ctx.fillStyle = '#ff3333';
        ctx.beginPath();
        ctx.arc(70, 30, 12, 0, Math.PI * 2);
        ctx.fill();
        ctx.fillStyle = '#fff';
        ctx.font = 'bold 12px sans-serif';
        ctx.fillText(window.unreadCount, 70, 34);
    }
}
drawCanvas();

// === 拖曳邏輯 (原生 Drag API) ===
canvas.draggable = true;

canvas.addEventListener('dragstart', (e) => {
    isDragging = true;
    dragOffset.x = e.clientX - canvas.offsetLeft;
    dragOffset.y = e.clientY - canvas.offsetTop;
    e.dataTransfer.effectAllowed = 'move';
    canvas.style.opacity = '0.8';
});

canvas.addEventListener('drag', (e) => {
    if (!isDragging) return;
    // 限制在視窗內
    const x = Math.max(0, Math.min(window.innerWidth - canvas.width, e.clientX - dragOffset.x));
    const y = Math.max(0, Math.min(window.innerHeight - canvas.height, e.clientY - dragOffset.y));
    canvas.style.left = x + 'px';
    canvas.style.top = y + 'px';
    // 同步更新選單位置 (若展開中)
    if (menu.classList.contains('expanded')) {
        syncMenuPosition(x, y);
    }
});

canvas.addEventListener('dragend', () => {
    isDragging = false;
    canvas.style.opacity = '1';
});

// === 選單展開/收合 ===
toggleBtn.addEventListener('click', (e) => {
    e.stopPropagation();
    toggleMenu();
});

function toggleMenu() {
    const expanded = menu.classList.toggle('expanded');
    toggleBtn.textContent = expanded ? '✕' : '☰';
    toggleBtn.setAttribute('aria-label', expanded ? '收合選單' : '展開選單');
    
    if (expanded) {
        syncMenuPosition(canvas.offsetLeft, canvas.offsetTop);
    }
}

function syncMenuPosition(canvasX, canvasY) {
    menu.style.left = (canvasX + canvas.width + 10) + 'px';
    menu.style.top = canvasY + 'px';
}

// 點擊外部收合
document.addEventListener('click', (e) => {
    if (menu.classList.contains('expanded') && !menu.contains(e.target) && e.target !== toggleBtn) {
        menu.classList.remove('expanded');
        toggleBtn.textContent = '☰';
    }
});

// === 鍵盤無障礙 ===
document.addEventListener('keydown', (e) => {
    if (e.key === 'Escape' && menu.classList.contains('expanded')) {
        menu.classList.remove('expanded');
        toggleBtn.textContent = '☰';
        toggleBtn.focus();
    }
});

關鍵技術點深度解析

1. 原生 Drag API vs 模擬拖曳 (mousedown/mousemove/mouseup)

特性原生 Drag API模擬拖曳
瀏覽器原生支援完整 (含桌面/行動裝置差異)需自行處理觸控事件
預設視覺回饋半透明拖曳影像 (可自訂)無,需自行實現
跨視窗/標籤拖放支援不支援
行動裝置支援部分 (iOS Safari 需額外處理)完整控制 (觸控事件)
適用場景檔案上傳、元素排序、跨應用拖放UI 組件拖曳 (Modal、Slider、面板)

建議:UI 組件拖曳 (如本例導航面板) 採用 模擬拖曳 (Pointer Events) 體驗更佳、控制更精確;檔案/資料拖放才用原生 API。

2. Pointer Events 統一滑鼠/觸控/筆輸入

canvas.addEventListener('pointerdown', (e) => {
    canvas.setPointerCapture(e.pointerId);
    isDragging = true;
    dragOffset.x = e.clientX - canvas.offsetLeft;
    dragOffset.y = e.clientY - canvas.offsetTop;
    canvas.style.opacity = '0.8';
});

canvas.addEventListener('pointermove', (e) => {
    if (!isDragging) return;
    const x = Math.max(0, Math.min(window.innerWidth - canvas.width, e.clientX - dragOffset.x));
    const y = Math.max(0, Math.min(window.innerHeight - canvas.height, e.clientY - dragOffset.y));
    canvas.style.left = x + 'px';
    canvas.style.top = y + 'px';
    if (menu.classList.contains('expanded')) syncMenuPosition(x, y);
});

canvas.addEventListener('pointerup', (e) => {
    canvas.releasePointerCapture(e.pointerId);
    isDragging = false;
    canvas.style.opacity = '1';
});

3. Canvas 高效能動畫技巧

  • 使用 requestAnimationFrame 替代 setInterval
  • 離屏 Canvas (OffscreenCanvas) 移至 Worker 執行緒 (支援瀏覽器)
  • 脏矩形清理:ctx.clearRect(dirtyX, dirtyY, dirtyW, dirtyH)
  • 圖層分離:靜態背景用一個 Canvas,動態前景用另一個

無障礙 (a11y) 強化清單

  • [ ] role="navigation"、aria-label="主導航"
  • [ ] 展開狀態 aria-expanded="true/false"
  • [ ] 鍵盤可聚焦:tabindex="0"、Enter/Space 切換、Esc 關閉
  • [ ] 焦點陷阱:展開時 Tab 循環在選單內
  • [ ] 螢幕閱讀器宣告狀態變化 (aria-live="polite")
  • [ ] 高對比度模式下可見、縮放 200% 不遺失功能

響應式適配

@media (max-width: 768px) {
    #navCanvas { top: auto; bottom: 10px; left: 50%; transform: translateX(-50%); }
    #navMenu { left: 50%; top: auto; bottom: 70px; transform: translateX(-50%) translateY(100%); }
    #navMenu.expanded { transform: translateX(-50%) translateY(0); }
}

總結

HTML5 賦予 Web 原生拖放與圖形繪圖能力,配合 CSS3 動畫、現代事件模型,可構建媲美原生應用的互動體驗。本範例展示了 Canvas 繪製動態圖示、Pointer Events 統一拖曳邏輯、CSS 狀態驅動動畫、無障礙鍵盤操作的完整整合。實務專案中,建議優先採用成熟 UI 庫 (Headless UI、Radix UI、Floating UI) 處理複雜浮層定位與無障礙,Canvas 專注於資料視覺化、遊戲、編輯器等高性能繪圖場景。

copyright © 萬盛學電腦網 all rights reserved