MixItUp 是一個 jQuery 插件,提供動畫式的過濾與排序。它特別適合管理作品集、圖庫、部落格文章這類需要分類瀏覽的內容,也能作為應用程式 UI 與資料視覺化的有力工具。
MixItUp 的一大優點是與既有的 HTML 和 CSS 相容良好,因此是響應式布局的絕佳選擇。它不像多數輪播那樣用絕對定位控制布局,而是設計成與既有的行內流(inline flow)布局協同運作。無論你使用百分比寬度、媒體查詢、inline-block,甚至是 flexbox,都能正常運作。
<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:標示哪些元素要參與過濾與排序。category-1):作為過濾條件。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。
#Container .mix {
display: none;
}
在樣式中把目標元素設為不顯示,MixItUp 只會顯示符合目前過濾條件的項目。這個初始狀態很重要,否則頁面載入瞬間會看到全部內容閃一下。
$(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。