Spring Checkاینپوت‌ها

چک‌باکس فنری

یه چک‌باکس که با تیک‌خوردن پر می‌شه، تیک می‌زنه و متنش رو خط می‌کشه.

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

وابستگی‌ها

motion

نوع تعامل

با هر کلیک، خانه از وسط پر می‌شه، کمی ورم می‌کنه و تیک میاد؛ هم‌زمان متن کم‌رنگ می‌شه و یه خط از روش رد می‌شه. Space و Enter هم همین کارو می‌کنن، ولی بی‌انیمیشن.

پراپ‌ها

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

label
ReactNodeپیش‌فرض: "انجام شد"

متنِ کنارِ خانه؛ هر گره‌ای می‌تونه باشه، نه فقط رشته.

checked
boolean

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

defaultChecked
booleanپیش‌فرض: false

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

onChange
(checked: boolean) => void

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

disabled
booleanپیش‌فرض: false

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

color
stringپیش‌فرض: #ffffff (تیره) · #18181b (روشن)

رنگِ جوهر: قابِ خانه، متن و خطِ روی متن همه از همین‌ان. پیش‌فرضش با تم عوض می‌شه.

نصب

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

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

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

npx shadcn@latest add @farsify/spring-check

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

نمونه

spring-check.tsxtsx
"use client";

import { useState } from "react";
import { SpringCheck } from "@/components/farsify/spring-check";

export function TodoItem() {
  const [done, setDone] = useState(false);

  return (
    <SpringCheck
      label="ساخت بیلد"
      checked={done}
      onChange={setDone}
    />
  );
}

// بدون کنترل — مقدار اولیه‌ی تیک‌خورده
<SpringCheck label="هماهنگی جلسه" defaultChecked />

// رنگ برند، خانه‌ی بزرگ‌تر و خط از وسط
<SpringCheck
  label="به‌روزرسانی تغییرات"
  color="var(--color-brand)"
  fillColor="var(--color-brand)"
  checkColor="#ffffff"
  boxSize={34}
  strike="center"
/>

نکته‌ها

  • برای فهرست کارها `bounce` رو حدود ۰.۱ و `strikeLag` رو صفر بذار؛ حرکت کمتر بهتره.
  • اگه رنگ برند می‌دی، حواست به کنتراست `fillColor` و `checkColor` باشه؛ وگرنه تیک دیده نمی‌شه.
  • با `strike="none"` متن فقط کم‌رنگ می‌شه؛ برای برچسب‌های بلند همین بهتره.

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

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

مجوز

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