萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 動態圖片切換:單選/多選圖片狀態切換完整實作

應用場景

  • 單選圖片庫 (點擊切換選中狀態)
  • 評分星星、表情符號選擇
  • 商品規格圖片選擇 (顏色/尺寸)
  • 步驟指引器、向導式介面

完整程式碼 (現代化重構 + 無障礙)

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery 動態圖片切換</title>
  <style>
    .container { max-width: 700px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
    .selector { display: flex; gap: 16px; justify-content: center; flex-wrap: wrap; margin-bottom: 30px; }
    .img-option { position: relative; cursor: pointer; border-radius: 12px; overflow: hidden; box-shadow: 0 4px 12px rgba(0,0,0,0.1); transition: transform 0.2s, box-shadow 0.2s; }
    .img-option:hover { transform: translateY(-4px); box-shadow: 0 8px 24px rgba(0,0,0,0.15); }
    .img-option img { display: block; width: 120px; height: 120px; object-fit: cover; transition: opacity 0.2s; }
    .img-option input { position: absolute; opacity: 0; width: 100%; height: 100%; cursor: pointer; }
    .img-option::after { content: ''; position: absolute; inset: 0; border: 3px solid transparent; border-radius: 12px; transition: border-color 0.2s; pointer-events: none; }
    .img-option.selected::after { border-color: #1976d2; box-shadow: 0 0 0 2px #1976d2; }
    .img-option.selected img { opacity: 0.9; }
    .legend { text-align: center; color: #666; font-size: 14px; }
  </style>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <div class="container">
    <h2 style="text-align:center; color:#333;">點擊選擇圖片 (單選模式)</h2>
    
    <div class="selector" id="imageSelector">
      <label class="img-option" data-value="opt1">
        <img src="https://picsum.photos/seed/opt1/200/200" alt="選項 1">
        <input type="radio" name="imgSelect" value="opt1">
      </label>
      <label class="img-option" data-value="opt2">
        <img src="https://picsum.photos/seed/opt2/200/200" alt="選項 2">
        <input type="radio" name="imgSelect" value="opt2">
      </label>
      <label class="img-option" data-value="opt3">
        <img src="https://picsum.photos/seed/opt3/200/200" alt="選項 3">
        <input type="radio" name="imgSelect" value="opt3">
      </label>
      <label class="img-option" data-value="opt4">
        <img src="https://picsum.photos/seed/opt4/200/200" alt="選項 4">
        <input type="radio" name="imgSelect" value="opt4">
      </label>
      <label class="img-option" data-value="opt5">
        <img src="https://picsum.photos/seed/opt5/200/200" alt="選項 5">
        <input type="radio" name="imgSelect" value="opt5">
      </label>
    </div>

    <p class="legend">已選值:無</p>

    <hr style="margin:30px 0; border-color:#eee;">

    <h2 style="text-align:center; color:#333;">多選模式 (Ctrl/Shift 點擊)</h2>
    <div class="selector" id="multiSelector">
      <label class="img-option" data-value="m1">
        <img src="https://picsum.photos/seed/m1/200/200" alt="多選 1">
        <input type="checkbox" name="multiSelect" value="m1">
      </label>
      <label class="img-option" data-value="m2">
        <img src="https://picsum.photos/seed/m2/200/200" alt="多選 2">
        <input type="checkbox" name="multiSelect" value="m2">
      </label>
      <label class="img-option" data-value="m3">
        <img src="https://picsum.photos/seed/m3/200/200" alt="多選 3">
        <input type="checkbox" name="multiSelect" value="m3">
      </label>
      <label class="img-option" data-value="m4">
        <img src="https://picsum.photos/seed/m4/200/200" alt="多選 4">
        <input type="checkbox" name="multiSelect" value="m4">
      </label>
    </div>
    <p class="legend">已選值:無</p>
  </div>

  <script>
  $(function() {
    // 單選模式
    const $singleOptions = $('#imageSelector .img-option');
    const $singleRadios = $('#imageSelector input[type="radio"]');
    
    $singleOptions.on('click', function(e) {
      // 避免重複觸發 (label 包裹 input 會雙重觸發)
      if (e.target.tagName === 'INPUT') return;
      
      const $option = $(this);
      const value = $option.data('value');
      
      $singleOptions.removeClass('selected');
      $option.addClass('selected');
      $singleRadios.filter(`[value="${value}"]`).prop('checked', true);
      $('#selectedVal').text(value);
    });

    // 鍵盤支援
    $singleOptions.on('keydown', function(e) {
      if (e.key === 'Enter' || e.key === ' ') {
        e.preventDefault();
        $(this).trigger('click');
      }
    });

    // 多選模式
    const $multiOptions = $('#multiSelector .img-option');
    
    $multiOptions.on('click', function(e) {
      if (e.target.tagName === 'INPUT') return;
      
      const $option = $(this);
      const $checkbox = $option.find('input[type="checkbox"]');
      const checked = !$checkbox.prop('checked');
      
      $checkbox.prop('checked', checked);
      $option.toggleClass('selected', checked);
      updateMultiDisplay();
    });

    function updateMultiDisplay() {
      const vals = $('#multiSelector input:checked').map((_, el) => el.value).get();
      $('#multiVal').text(vals.length ? vals.join(', ') : '無');
    }

    // 初始化鍵盤無障礙
    $('.img-option').attr('tabindex', '0').attr('role', 'button').attr('aria-pressed', 'false');
    $('.img-option.selected').attr('aria-pressed', 'true');
  });
  </script>
</body>
</html>

核心技術點解析

1. <label> 包裹 <input> = 原生點擊代理

點擊圖片區域即觸發內部 input 的 change 事件,無需 JS 手動綁定。但需注意:

// 避免事件冒泡導致雙重觸發
$option.on('click', function(e) {
  if (e.target.tagName === 'INPUT') return; // 忽略原生 input 點擊
  // 自定義邏輯...
});

2. CSS 狀態管理優於 JS 操作樣式

.img-option.selected::after { border-color: #1976d2; }
.img-option.selected img { opacity: 0.9; }

JS 僅切換 .selected 類別,樣式完全由 CSS 控制,符合關注點分離。

3. .siblings() 同胞選擇器應用

// 經典寫法 (原文範例)
$('img', $(this)).attr('src', 'selected.jpg');
$('img', $(this).siblings('td')).attr('src', 'unselected.jpg');

// 現代寫法:類別切換
$(this).addClass('selected').siblings().removeClass('selected');

進階:動態資料渲染

const images = [
  { id: 'p1', src: 'img1.jpg', alt: '產品 1' },
  { id: 'p2', src: 'img2.jpg', alt: '產品 2' },
  // ...
];

function renderSelector(images, $container, name, multiple = false) {
  $container.empty();
  images.forEach(img => {
    const $label = $(``);
    $label.append(`${escapeHtml(img.alt)}`);
    $label.append(``);
    $container.append($label);
  });
  // 綁定事件...
}

無障礙 (a11y) 必做項

  • role="button" + tabindex="0":讓非按鈕元素可聚焦、可鍵盤操作
  • aria-pressed="true/false":告知螢幕閱讀器按下狀態
  • alt 屬性:圖片替代文字
  • <label> 關聯:點擊文字/圖片即可切換

總結

圖片切換的核心模式:語意化 HTML (label + input) + CSS 狀態類別 + JS 狀態同步。避免直接操作 src 屬性切換圖片 (閃爍、無快取),改用 疊層圖片 + 透明度/邊框切換 或 CSS background-image + 類別 實現流暢切換。

copyright © 萬盛學電腦網 all rights reserved