قهوه۶۵٪
شیر۳۵٪

CoffeeMilkشو تایم

قهوه و شیر

یه نوارِ نسبتی که با کشیدنش سهمِ دو طرف کم و زیاد می‌شه؛ قهوه و شیر که هر لحظه معلومه کدوم بیشتره.

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

وابستگی‌ها

motion

نوع تعامل

هر جای نوار بکشی، لبهٔ تقسیم می‌چسبه به اشاره‌گر و دو سهم زنده کم و زیاد می‌شن. سهمی که از ۳۰٪ کمتر بشه نوارش کوتاه و قرصی می‌شه، و برچسبی که جا نداشته باشه می‌پره بالای نوار. با صفحه‌کلید هم همینه: فلش‌ها یکی‌یکی، PageUp/PageDown ده‌تا ده‌تا و Home/End تا لبه.

پراپ‌ها

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

defaultValue
numberپیش‌فرض: 65

سهمِ اولیهٔ قهوه بر حسبِ درصد (۱ تا ۹۹) در حالتِ کنترل‌نشده.

value
number

مقدارِ کنترل‌شده؛ وقتی می‌دهی، کشیدن و صفحه‌کلید فقط `onChange` را صدا می‌زنند و خودش تغییر نمی‌کند.

onChange
(leftValue: number) => void

با هر تغییر (کشیدن یا صفحه‌کلید) سهمِ گردشدهٔ قهوه را برمی‌گرداند.

leftLabel
stringپیش‌فرض: "قهوه"

برچسبِ نوارِ چپ.

rightLabel
stringپیش‌فرض: "شیر"

برچسبِ نوارِ راست.

coffeeFill
string

رنگِ پُرِ نوارِ قهوه؛ جوهرِ برچسبش متغیرهای `--cm-coffee-word/num` در CSS است و جدا عوض می‌شود.

نصب

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

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

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

npx shadcn@latest add @farsify/coffee-milk

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

نمونه

coffee-milk.tsxtsx
"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` داخلِ صفحهٔ تیره درست می‌مونه.

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

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

مجوز

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