Squish Switchاینپوت‌ها

سوئیچ لاستیکی

یه کلید که دستگیره‌اش با کشیدن کش می‌آد و وقتی رهاش کنی، فنر می‌ندازدش به یه سر.

پیش‌نمایش سوئیچ لاستیکی
اختصاصی فارسی‌فایطراحی و توسعه در فارسی‌فای

وابستگی‌ها

motion

نوع تعامل

می‌تونی مثل هر کلیدی روش کلیک کنی، یا دستگیره رو بگیری و بکشی. همون‌طور که می‌کشی، دستگیره به اندازه‌ی سرعتِ حرکتت کشیده می‌شه ولی پهن‌تر نمی‌شه، و وضعیت همون لحظه‌ی عبور از وسط عوض می‌شه. با رهاکردن، فنر می‌ندازدش به نزدیک‌ترین سر. با آمدنِ نشانگر روش کمی بزرگ می‌شه و Escape وسطِ کشیدن همه‌چیز رو به حالتِ قبل برمی‌گردونه.

پراپ‌ها

گزینه‌هایی که می‌تونی به کامپوننت بدی؛ ستاره‌دارها اجباری‌اند.

checked
boolean

مقدارِ controlled. اگه uncontrolled می‌خوای، این رو نده.

defaultChecked
booleanپیش‌فرض: false

وضعیتِ اولیه توی حالتِ uncontrolled.

onChange
(checked: boolean) => void

با هر تغییر، وضعیتِ تازه رو برمی‌گردونه.

label
string

متنِ کنارِ کلید. اگه بدی، کلیک روش هم کلید رو عوض می‌کنه (با `htmlFor`).

disabled
booleanپیش‌فرض: false

کم‌رنگ و غیرقابل‌تعاملش می‌کنه.

trackColor
stringپیش‌فرض: #27272a (تیره) · #d4d4d8 (روشن)

رنگِ نوار توی حالتِ خاموش.

نصب

۱. این آدرس رو یک‌بار توی components.json بذار تا shadcn مخزن فارسی‌فای رو بشناسه.

components.jsonjson
{
  "registries": {
    "@farsify": "https://farsifyui.ir/r/{name}.json"
  }
}

۲. بعد با دستور زیر کامپوننت رو نصب کن.

npx shadcn@latest add @farsify/squish-switch

پیش‌نیاز: Tailwind CSS v4 و صفحهٔ راست‌به‌چپ dir="rtl".

نمونه

squish-switch.tsxtsx
"use client";

import { useState } from "react";
import { SquishSwitch } from "@/components/farsify/squish-switch";

export function AutoSave() {
  const [on, setOn] = useState(false);

  return (
    <SquishSwitch
      checked={on}
      onChange={setOn}
      ariaLabel="ذخیره‌ی خودکار"
    />
  );
}

// بدون کنترل — روشن از اول
<SquishSwitch label="اعلان‌ها" defaultChecked />

// رنگ برند و کشش بیشتر
<SquishSwitch
  label="همگام‌سازی خودکار"
  trackOnColor="var(--color-brand)"
  thumbOnColor="#ffffff"
  stretch={60}
  speed={70}
/>

نکته‌ها

  • برای کلیدهای پرتکرار `speed` رو حدود ۷۰ بذار تا حرکت آروم‌تر شه؛ سرعتِ بالا برای کلیدهاییه که کاربر باهاشون «بازی» می‌کنه.
  • اگه `stretch` رو صفر کنی و `hoverScale` رو ۱، یه کلیدِ معمولیِ تمیز می‌مونه — بدونِ کشش و بدونِ واکنشِ نشانگر.
  • رنگ‌ها رو با متغیرِ CSS هم می‌تونی بدی: `trackOnColor="var(--color-brand)"`.

هم‌خانواده‌ها

کامپوننت‌های دیگری از همان دسته که با این یکی جور درمی‌آیند.

مجوز

کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژه‌ی خودت نگهش دار. برای پروژه‌های شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسی‌فای رو یه جا توی پروژه نگه دار.