کاستومایز
CoffeeMilkشو تایم
قهوه و شیر
یه نوارِ نسبتی که با کشیدنش سهمِ دو طرف کم و زیاد میشه؛ قهوه و شیر که هر لحظه معلومه کدوم بیشتره.
وابستگیها
نوع تعامل
هر جای نوار بکشی، لبهٔ تقسیم میچسبه به اشارهگر و دو سهم زنده کم و زیاد میشن. سهمی که از ۳۰٪ کمتر بشه نوارش کوتاه و قرصی میشه، و برچسبی که جا نداشته باشه میپره بالای نوار. با صفحهکلید هم همینه: فلشها یکییکی، PageUp/PageDown دهتا دهتا و Home/End تا لبه.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
defaultValuenumberپیشفرض: 65سهمِ اولیهٔ قهوه بر حسبِ درصد (۱ تا ۹۹) در حالتِ کنترلنشده.
valuenumberمقدارِ کنترلشده؛ وقتی میدهی، کشیدن و صفحهکلید فقط `onChange` را صدا میزنند و خودش تغییر نمیکند.
onChange(leftValue: number) => voidبا هر تغییر (کشیدن یا صفحهکلید) سهمِ گردشدهٔ قهوه را برمیگرداند.
leftLabelstringپیشفرض: "قهوه"برچسبِ نوارِ چپ.
rightLabelstringپیشفرض: "شیر"برچسبِ نوارِ راست.
coffeeFillstringرنگِ پُرِ نوارِ قهوه؛ جوهرِ برچسبش متغیرهای `--cm-coffee-word/num` در CSS است و جدا عوض میشود.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/coffee-milkپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"use client";
import { useState } from "react";
import { CoffeeMilk } from "@/components/farsify/coffee-milk";
export function BrewSetup() {
const [coffee, setCoffee] = useState(65);
return <CoffeeMilk value={coffee} onChange={setCoffee} />;
}
// کنترلنشده — خودش حالتش را نگه میدارد
<CoffeeMilk defaultValue={65} />
// برچسبهای دلخواه — هر نسبتی که بخوای
<CoffeeMilk leftLabel="کار" rightLabel="استراحت" defaultValue={70} />
// رنگهای دلخواه؛ جوهرِ برچسبها با متغیرهای --cm-*-word/num جدا عوض میشه
<CoffeeMilk coffeeFill="#8a5a2b" milkFill="#dbe4ee" />نکتهها
- لبهٔ تقسیم فقط راهنمای چشم است و چیزی رویش نمینشینه؛ کلِ نوار قابلِ گرفتنه، حتی وقتی یکی از سهمها خیلی لاغر شده.
- برچسبِ هر طرف اول داخلِ نوارش میشینه و وقتی جا نشه میپره بالا — هر طرف مستقل تصمیم میگیره؛ تنگ شدنِ یکی دربارهٔ دیگری حرف نمیزنه.
- هندسه فیزیکی مونده: قهوه سمتِ چپه و کشیدن ۱:۱ با اشارهگر جلو میره؛ فقط ترتیبِ خواندنِ برچسبها راستبهچپه («قهوه ۶۵٪»).
- رنگهای پُر عمداً کماشباع و نیمهشفافاند و «حضور» با opacity کار میکنه نه روشنی — چون پُرها شفافاند، brightness برعکس عمل میکرد.
- با `prefers-reduced-motion` همهٔ فنرها بیدرنگ میشن؛ کشیدن از قبل بیدرنگه تا از دستِ اشارهگر عقب نیفته.
- متغیرهای رنگ (`--cm-*`) در `coffee-milk.css` تعریف شدن؛ تمِ تیره با گزینشگرِ خودش عوض میشه و جزیرهٔ `.light` داخلِ صفحهٔ تیره درست میمونه.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.