DIV CSS 佈局教程網

jQuery 插件 MixItUp:為列表加上動畫過濾與排序
編輯:JavaScript綜合知識     

MixItUp 是什麼

MixItUp 是一個 jQuery 插件,提供動畫式的過濾與排序。它特別適合管理作品集、圖庫、部落格文章這類需要分類瀏覽的內容,也能作為應用程式 UI 與資料視覺化的有力工具。

MixItUp 的一大優點是與既有的 HTML 和 CSS 相容良好,因此是響應式布局的絕佳選擇。它不像多數輪播那樣用絕對定位控制布局,而是設計成與既有的行內流(inline flow)布局協同運作。無論你使用百分比寬度、媒體查詢、inline-block,甚至是 flexbox,都能正常運作。

HTML 結構

<div id="Container">
  <div class="mix category-1" data-my-order="1"> ... </div>
  <div class="mix category-1" data-my-order="2"> ... </div>
  <div class="mix category-2" data-my-order="3"> ... </div>
  <div class="mix category-2" data-my-order="4"> ... </div>
</div>

兩組約定是整個插件的基礎:

  • .mix class:標示哪些元素要參與過濾與排序。
  • 分類 class(如 category-1):作為過濾條件。
  • 自訂 data 屬性(如 data-my-order):作為排序依據。

建立過濾控制項

<button class="filter" data-filter=".category-1">Category 1</button>
<button class="filter" data-filter=".category-2">Category 2</button>

點擊過濾鈕時即觸發篩選。data-filter 的值是一個選擇器,符合的元素保留、其餘以動畫淡出。

建立排序控制項

<button class="sort" data-sort="my-order:asc">Ascending Order</button>
<button class="sort" data-sort="my-order:desc">Descending Order</button>

data-sort 的格式是「data 屬性名稱:方向」,方向可為 asc 或 desc。

CSS

#Container .mix {
  display: none;
}

在樣式中把目標元素設為不顯示,MixItUp 只會顯示符合目前過濾條件的項目。這個初始狀態很重要,否則頁面載入瞬間會看到全部內容閃一下。

JavaScript 初始化

$(function() {
  $('#Container').mixItUp();
});

用容器的 id 就能實例化 MixItUp。

進階:用程式控制

除了點擊 DOM 上的控制項,也可以用 API 直接操作:

var mixer = $('#Container').mixItUp();

// 過濾
mixer.filter('.category-1');
mixer.filter('all');
mixer.filter('none');

// 排序
mixer.sort('my-order:asc');
mixer.sort('random');

// 插入新元素
var newItem = $('<div class="mix category-1" data-my-order="5">新項目</div>');
mixer.insertDOM(newItem);

// 移除
mixer.removeDOM('.category-2');

幾個實務提醒

版本差異很大

MixItUp 2.x 與 3.x 的 API 完全不同。3.x 改為需要透過建構子實例化,並且其社群版與商業授權版功能有別。使用前請確認你手上的文件對應哪個版本,網路上大量範例是 2.x 的寫法。

// MixItUp 3 的寫法
var mixer = mixitup('#Container', {
  animation: { duration: 300, effects: 'fade translateY(-20%)' },
  load: { filter: '.category-1' }
});

過濾後記得處理空狀態

mixer.filter('.category-1');
// 監聽結果,顯示「查無資料」提示
$(document).on('mix-end', function(e, state) {
  $('#empty-tip').toggle(state.totalShow === 0);
});

動畫與可及性

使用者若開啟了系統的「減少動態效果」偏好,插件動畫應該關閉:

@media (prefers-reduced-motion: reduce) {
  #Container .mix { transition: none !important; }
}

過濾結果的可及性

動畫過濾會讓部分內容從畫面消失,螢幕閱讀器使用者不會知道發生了什麼。建議在過濾後更新一個 aria-live 區域,告知目前顯示幾筆:

<p id="result-count" aria-live="polite"></p>

// 過濾後
$('#result-count').text('目前顯示 ' + state.totalShow + ' 筆結果');

現代替代方案

MixItUp 依賴 jQuery,在如今的前端生態中顯得沉重。若只是要過濾與排序,其實用原生寫法十幾行就夠了:

function filterBy(className) {
  document.querySelectorAll('#Container .mix').forEach(function(el) {
    var show = className === 'all' || el.classList.contains(className);
    el.hidden = !show;
  });
}

function sortBy(attr, dir) {
  var container = document.getElementById('Container');
  var items = [...container.children];
  items.sort(function(a, b) {
    var av = a.dataset[attr], bv = b.dataset[attr];
    return dir === 'asc' ? av.localeCompare(bv) : bv.localeCompare(av);
  });
  items.forEach(el => container.appendChild(el));
}

需要更複雜的拖放排序時,SortableJS 是輕量且好用的選擇;需要瀑布流排版則可考慮 CSS 的 column-count 或 Masonry。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved