useFilterPresets

معرفی

هوک useFilterPresets وضعیتِ یک <FilterProvider> را به‌صورت preset های نام‌دار در localStorage ذخیره و مدیریت می‌کند: save / load / rename / overwrite / remove / clear. لیست به‌ترتیبِ جدیدترین مرتب می‌شود و سقفِ نرمِ maxPresets (پیش‌فرض ۲۰) دارد؛ روی سرریز قدیمی‌ترین حذف می‌شود. SSR-safe.

چه زمانی استفاده کنیم

• اجازه به کاربر برای ذخیره‌ی ترکیب‌های فیلترِ پرکاربرد و بازگشتِ سریع به آن‌ها

چه زمانی استفاده نکنیم

• اگر فیلترها فقط باید با لینک share شوند → useFilterParams

استفاده

import { FilterProvider, useFilterPresets } from '@partodata/ui'

function PresetBar() {
  const { presets, save, load, remove } = useFilterPresets({ storageKey: 'reports.filters' })

  return (
    <div className="flex items-center gap-2">
      <Button onClick={() => save('فیلتر من')}>ذخیره‌ی فیلتر فعلی</Button>
      {presets.map((p) => (
        <FilterChip key={p.id} label={p.name} onClick={() => load(p.id)} onRemove={() => remove(p.id)} />
      ))}
    </div>
  )
}

پارامترها (options)

مقدار بازگشتی

هوک‌های مرتبط

• همگام‌سازیِ فیلترها با URL → useFilterParams
• نمایشِ فیلترهای فعال → FilterChip