CSS, HTML, JavaScript, سورس کد

اسکریپت فیلتر و جستجوی هوشمند با جستجوی بلادرنگ (سورس کد JS خالص)

سورس کد فیلتر و جستجوی هوشمند
زمان مطالعه: ۹ دقیقهسطح: متوسطسورس کد رایگان
خلاصه در یک نگاه
  • جستجو هم‌زمان با تایپ انجام می‌شود، اما با debounce فقط وقتی کاربر ۲۰۰ میلی‌ثانیه دست از تایپ بکشد، تا صفحه کند نشود.
  • همهٔ فیلترها (متن، دسته، قیمت و مرتب‌سازی) در یک شیء state نگهداری و در یک تابع اعمال می‌شوند.
  • جستجو به «ی» و «ک» عربی و فاصله‌های اضافه حساس نیست ؛ سورس مستقل عنوان کامل را نمایش می‌دهد و هایلایت زیررشته ندارد.
  • فیلترها در آدرس صفحه ذخیره می‌شوند تا کاربر بتواند نتیجه را با دیگران به اشتراک بگذارد.

وقتی تعداد محصولات، مقالات یا نمونه‌کارهای سایت زیاد می‌شود، کاربر باید بتواند در چند ثانیه چیزی را که می‌خواهد پیدا کند. فیلتر و جستجوی هوشمند دقیقاً همین کار را می‌کند: با هر حرف تایپ‌شده یا هر فیلتر انتخاب‌شده، نتیجه بدون رفرش صفحه به‌روز می‌شود. در این مطلب از طاووس وب نسخهٔ کامل و به‌روز این اسکریپت را با جاوااسکریپت خالص می‌سازیم.

دموی زنده جستجو و فیلتر

دموی زیر فقط جستجو، فیلتر و مرتب‌سازی را نشان می‌دهد و فیلترها را در URL ذخیره یا از آن بازیابی نمی‌کند. قابلیت اشتراک‌گذاری آدرس در سورس مستقلِ بخش «ذخیرهٔ فیلترها در آدرس صفحه» پیاده‌سازی شده است.

تایپ کنید، دسته انتخاب کنید یا قیمت را تغییر دهید

حداکثر قیمت:

قیمت‌ها به هزار تومان و محصولات نمونه هستند.

ایدهٔ اصلی: یک state، یک تابع

اشتباه رایج در اسکریپت‌های فیلتر این است که هر فیلتر مستقیم کارت‌ها را پنهان یا نمایش می‌دهد؛ نتیجه این می‌شود که فیلترها با هم تداخل پیدا می‌کنند. راه درست این است که همهٔ انتخاب‌های کاربر در یک شیء نگهداری شوند و یک تابع، هر بار کل داده را از اول با همهٔ شرط‌ها فیلتر کند:

مراحل کار اسکریپت فیلتر و جستجوی هوشمند
هر تغییر ورودی از همین مسیر عبور می‌کند

کد HTML

<div class="finder">
  <input type="search" id="q" placeholder="جستجو…" aria-label="جستجو">
  <select id="cat" aria-label="دسته‌بندی">
    <option value="">همهٔ دسته‌ها</option>
    <option>کفش</option><option>کیف</option><option>ساعت</option>
  </select>
  <label for="max">حداکثر قیمت (هزار تومان)</label>
  <input type="range" id="max" min="100" max="3000" step="100" value="3000">
  <label for="sort">مرتب‌سازی</label>
  <select id="sort">
    <option value="new">جدیدترین</option>
    <option value="low">ارزان‌ترین</option>
    <option value="high">گران‌ترین</option>
  </select>
  <p id="count" aria-live="polite"></p>
  <div id="results"></div>
</div>

کد جاوااسکریپت فیلتر و جستجوی هوشمند

داده‌ها می‌توانند از یک آرایهٔ ثابت، فایل JSON یا REST API وردپرس بیایند. اینجا یک آرایهٔ ساده داریم:

const products = [
  { title: 'کفش ورزشی رانینگ', cat: 'کفش', price: 1850, date: 9 },
  { title: 'کیف دوشی چرم',     cat: 'کیف', price: 1500, date: 8 },
  { title: 'ساعت مچی کلاسیک',  cat: 'ساعت', price: 2900, date: 6 },
  // ...
];

const state = { q: '', cat: '', max: 3000, sort: 'new' };

// یکسان‌سازی متن فارسی: ی و ک عربی، نیم‌فاصله و فاصله‌های اضافه
const normalize = (s) => s
  .replace(/ي/g, 'ی').replace(/ك/g, 'ک')
  .replace(/\u200c/g, ' ').replace(/\s+/g, ' ')
  .trim().toLowerCase();

function applyFilters() {
  const q = normalize(state.q);
  const list = products
    .filter(p => !q || normalize(p.title).includes(q))
    .filter(p => !state.cat || p.cat === state.cat)
    .filter(p => p.price <= state.max)
    .sort((a, b) =>
      state.sort === 'low'  ? a.price - b.price :
      state.sort === 'high' ? b.price - a.price :
                              b.date - a.date);
  render(list);
}

تابع render نتیجه را می‌سازد. برای امنیت، متن‌ها با textContent یا escape وارد صفحه می‌شوند:

const results = document.getElementById('results');
const count = document.getElementById('count');

function render(list) {
  results.replaceChildren(...list.map(p => {
    const card = document.createElement('div');
    card.className = 'card';
    card.innerHTML = '<b></b><small></small><span></span>';
    card.querySelector('b').textContent = p.title;
    card.querySelector('small').textContent = p.cat;
    card.querySelector('span').textContent = p.price.toLocaleString('fa-IR') + ' هزار تومان';
    return card;
  }));
  count.textContent = list.length
    ? `${list.length.toLocaleString('fa-IR')} نتیجه`
    : 'نتیجه‌ای پیدا نشد؛ فیلترها را کمتر کنید.';
}

و در آخر، اتصال ورودی‌ها به state. جستجو با debounce اجرا می‌شود:

function debounce(fn, ms = 200) {
  let t;
  return (...args) => { clearTimeout(t); t = setTimeout(() => fn(...args), ms); };
}

const $ = (id) => document.getElementById(id);

$('q').addEventListener('input', debounce((e) => {
  state.q = e.target.value; applyFilters(); syncURL();
}));
$('cat').addEventListener('change',  (e) => { state.cat  = e.target.value;  applyFilters(); syncURL(); });
$('max').addEventListener('input',   (e) => { state.max  = +e.target.value; applyFilters(); syncURL(); });
$('sort').addEventListener('change', (e) => { state.sort = e.target.value;  applyFilters(); syncURL(); });

// نمایش اولیه پس از بازیابی state از URL، در انتهای بخش بعد انجام می‌شود.

ذخیرهٔ فیلترها در آدرس صفحه

اگر کاربر نتیجهٔ فیلترشده را برای کسی بفرستد، باید همان نتیجه باز شود. در سورس مستقل، کد زیر را پس از بخش‌های قبلی و پس از ساخته‌شدن کنترل‌های HTML اجرا کنید. ابتدا مقادیر URL اعتبارسنجی و روی state و هر چهار کنترل اعمال می‌شوند، سپس نتیجه فقط یک بار نمایش داده می‌شود. دسته یا ترتیب نامعتبر به مقدار پیش‌فرض برمی‌گردد؛ قیمت باید عددی بین ۱۰۰ و ۳۰۰۰ با گام ۱۰۰ باشد، وگرنه مقدار پیش‌فرض ۳۰۰۰ استفاده می‌شود:

function syncURL() {
  const p = new URLSearchParams();
  if (state.q)    p.set('q', state.q);
  if (state.cat)  p.set('cat', state.cat);
  if (state.max < 3000) p.set('max', state.max);
  if (state.sort !== 'new') p.set('sort', state.sort);
  history.replaceState(null, '', p.toString() ? '?' + p : location.pathname);
}

// این بخش را پس از کدهای قبلی و ساخته‌شدن کنترل‌های HTML اجرا کنید.
const init = new URLSearchParams(location.search);
const allowedCats = ['', 'کفش', 'کیف', 'ساعت'];
const allowedSorts = ['new', 'low', 'high'];
const rawMax = init.get('max');
const max = Number(rawMax);

state.q = init.get('q') || '';
state.cat = allowedCats.includes(init.get('cat')) ? init.get('cat') : '';
state.sort = allowedSorts.includes(init.get('sort')) ? init.get('sort') : 'new';
state.max = rawMax !== null && rawMax.trim() !== '' &&
  Number.isFinite(max) && max >= 100 && max <= 3000 && (max - 100) % 100 === 0
    ? max : 3000;

$('q').value = state.q;
$('cat').value = state.cat;
$('max').value = String(state.max);
$('sort').value = state.sort;
applyFilters();

از replaceState به‌جای pushState استفاده کرده‌ایم تا با هر حرف تایپ‌شده، یک صفحه به تاریخچهٔ مرورگر اضافه نشود و دکمهٔ بازگشت کاربر را اذیت نکند.

نکات کارایی و سئو

  • تا چند صد آیتم، فیلتر سمت کاربر کافی است. برای هزاران محصول، جستجو باید سمت سرور (مثلاً با REST API وردپرس یا افزونه‌های جستجوی ووکامرس) انجام شود و فقط نتیجه برگردد.
  • محتوای اصلی را با جاوااسکریپت نسازید. اگر لیست محصولات فقط با JS ساخته شود، ممکن است دیرتر یا ناقص ایندکس شود. بهتر است کارت‌ها در HTML صفحه باشند و اسکریپت فقط آن‌ها را پنهان و نمایش دهد.
  • برای URLهای فیلتر راهبرد مشخص داشته باشید. ترکیب‌های مفید و قابل‌ایندکس را از URLهای تکراری یا کم‌ارزش جدا کنید. canonical برای معرفی نسخهٔ اصلیِ صفحات مشابه است، نه دستور قطعی جلوگیری از خزیدن؛ کنترل خزیدنِ فضای بزرگ فیلترهای غیرضروری را جداگانه طراحی کنید.
  • بازخورد بدهید. تعداد نتیجه و پیام «چیزی پیدا نشد» با پیشنهاد کم کردن فیلترها، کاربر را سردرگم نمی‌کند.

برای چیدمان کارت‌های نتیجه، آموزش CSS Grid و برای ساخت سایتی که محصولاتش راحت پیدا شوند، مطلب سئو چیست را هم بخوانید.

مشتری‌های فروشگاه‌تان محصول را پیدا می‌کنند؟طاووس وب جستجو، فیلتر و مسیر خرید فروشگاه اینترنتی را طوری طراحی می‌کند که کاربر سریع‌تر به محصول و پرداخت برسد.

طراحی سایت فروشگاهی

سؤالات متداول فیلتر و جستجوی هوشمند

Debounce چیست و چرا لازم است؟

Debounce اجرای تابع را تا وقتی کاربر برای مدت کوتاهی تایپ را متوقف کند عقب می‌اندازد. بدون آن، با هر حرف یک جستجو اجرا می‌شود و در داده‌های زیاد، صفحه کند می‌شود.

چطور این اسکریپت را به محصولات ووکامرس وصل کنم؟

Store API ووکامرس از مسیر /wp-json/wc/store/v1/products دادهٔ صفحه‌بندی‌شده می‌دهد؛ پاسخ آن مستقیماً شکل آرایهٔ این مثال را ندارد. نام، دسته و قیمت را به ساختار نمونه نگاشت کنید، واحد پول و تعداد رقم اعشار را از پاسخ بخوانید و همهٔ صفحات را بی‌هدف بارگیری نکنید. راه دیگر، فیلتر کارت‌های موجود با data-attribute است.

چرا جستجوی «کيف» با ی عربی نتیجه نمی‌دهد؟

در کد این مطلب، تابع normalize ی و ک عربی و نیم‌فاصله را یکسان‌سازی می‌کند تا این مشکل پیش نیاید.

برای چند محصول مناسب است؟

به حجم هر آیتم، تعداد عناصر صفحه و توان دستگاه بستگی دارد. زمان پاسخ را اندازه‌گیری کنید؛ برای دادهٔ بزرگ، جستجوی سمت سرور و صفحه‌بندی را در نظر بگیرید.

آیا فیلترهای آدرس صفحه روی سئو اثر منفی دارند؟

canonical به‌تنهایی مانع خزیدن یا تضمین‌کنندهٔ حذف URLهای فیلتر از ایندکس نیست. ابتدا مشخص کنید کدام ترکیب‌ها ارزش ایندکس‌شدن دارند؛ برای URLهای تکراری راهبرد canonical و برای فضای بزرگ فیلترهای غیرضروری راهبرد کنترل خزیدن را جداگانه طراحی کنید. فقط URLهای اصلی و قابل‌ایندکس را در نقشهٔ سایت بگذارید.

author-avatar

درباره مهدی حبیبی

مهدی حبیبی، بنیان‌گذار طاووس وب و برنامه‌نویس فرانت‌اند با بیش از ۵ سال تجربه در طراحی سایت و بیش از ۵۰ پروژهٔ انجام‌شده. تخصصش وردپرس، المنتور، ووکامرس، سئو و بهینه‌سازی سرعت است و تجربهٔ پروژه‌های واقعی را در طاووس وب به زبان ساده آموزش می‌دهد. و البته مجنون قهوه!

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *