React · React Native · 16 కాంపోనెంట్లు

కష్టమైన ఇంటరాక్షన్లు, పూర్తయ్యాయి.

Animated Chorus అనేది చేతితో సరిగ్గా చేయడం కష్టమైన ఇంటరాక్షన్ల కోసం మోషన్ కాంపోనెంట్ల సమితి: దొర్లే సంఖ్యలు, స్ట్రీమ్ అయ్యే టెక్స్ట్, పరిమాణం మారే మార్పిడులు, షీట్‌లు, పేజర్‌లు, స్వైప్ చర్యలు, మారినవాటిని మాత్రమే యానిమేట్ చేసే జాబితాలు. ఒకే tag, మీ డేటా. Provider లేదు, సెటప్ లేదు.

ప్రారంభించండి కాంపోనెంట్లు చూడండి

ఇన్‌స్టాలేషన్

npm install @kkwaenggwari/animated-chorus

ఈ build‌లో కొలవబడింది

Chrome, 2026-09-28. ప్రతి షరతు, నమూనా పనితీరు గైడ్‌లో ఉన్నాయి. ఇది ఎలా కొలవబడింది

28.0KBమొత్తం 16 export-లకు KB gzip
మొత్తం వెబ్ ఎంట్రీ, minify చేయబడింది. React మాత్రమే peer.
0యానిమేట్ అవుతున్నప్పుడు JS frame callback-లు
ఒక సంఖ్య, ఒక ఎత్తు, ఒక హైలైట్ కలిసి మారుతున్నాయి: బ్రౌజర్ మొత్తం 12 యానిమేషన్లను ప్లే చేస్తుంది.
1విలువ మార్పుకు ఒక React commit
MotionNumber విలువ మారినప్పుడు రెండర్ అవుతుంది, దొర్లుతున్నప్పుడు ఎప్పుడూ కాదు.
11స్ట్రీమ్ అయిన 3000 అక్షరాలకు React commit-లు
MotionStream అక్షరాలను నేరుగా జోడించి, సెకనుకు కొన్నిసార్లు React-లోకి కలుపుతుంది.

01అత్యంత సులభం

ఒకే tag, మీ డేటా

ప్రతి కాంపోనెంట్ స్వతంత్రంగా పనిచేస్తుంది: Provider, రాపర్ కాంపోనెంట్, సెటప్ కాల్ లేవు. సేకరణలు items, renderItem తీసుకుంటాయి; మీ లేఅవుట్, టెక్స్ట్, శైలులు మీవిగానే ఉంటాయి.

ఒక కాంపోనెంట్‌ను import చేసి విలువ ఇవ్వండి. అదే మొత్తం ఇంటిగ్రేషన్.
జాబితాలు, ట్యాబ్‌లు, పేజర్‌లు మీ అరేను చదువుతాయి; key డిఫాల్ట్‌గా item.id.
టెక్స్ట్ నిజమైన టెక్స్ట్‌గానే ఉంటుంది: చుట్టుకుంటుంది, ఫాంట్‌తో స్కేల్ అవుతుంది, ఎంచుకోవచ్చు.

```
<MotionNumber value={total} />;
```

<MotionSwap value={status}>{label}</MotionSwap>;

<MotionHeight open={open}>{details}</MotionHeight>;

<MotionHighlight items={tabs} value={tab} onValueChange={setTab} />;

<MotionList items={tasks} renderItem={(task) => task.title} />;

```
<ProgressRing value={progress} />;
```

ఆరు లైవ్ కాంపోనెంట్లు, ప్రతిదాని వెనుక ఉన్న ఒక లైన్ కోడ్.

ఉదాహరణ సిద్ధమవుతోంది…

JavaScript ఆఫ్‌లో ఉంది. కింద ఉన్న కోడే పూర్తి ఉదాహరణ.

App.jsx

import { useState } from 'react';
import {
  MotionHighlight,
  MotionNumber,
  MotionSwap,
  motionTokens,
} from '@kkwaenggwari/animated-chorus';
import './styles.css';

const plans = [
  { id: 'starter', label: 'Starter', price: 0, points: ['1 project', 'Community support'] },
  {
    id: 'team',
    label: 'Team',
    price: 24,
    points: ['10 projects', 'Shared workspaces', 'Priority support'],
  },
  {
    id: 'scale',
    label: 'Scale',
    price: 196,
    points: ['Unlimited projects', 'Single sign-on', 'Audit log', 'Dedicated support'],
  },
];

export default function App({ hover = true, effect = 'up', spring = 'default' }) {
  const [plan, setPlan] = useState('team');
  const current = plans.find((item) => item.id === plan);
  // "default" is not a preset: undefined keeps the component's own motion.
  const transition = motionTokens.spring[spring];

  return (
    <div className="card">
      <MotionHighlight
        items={plans}
        value={plan}
        onValueChange={setPlan}
        hover={hover}
        transition={transition}
        className="tabs"
        itemClassName="tab"
        highlightClassName="tab-highlight"
        renderItem={(item, { selected }) => (
          <span className={selected ? 'tab-label on' : 'tab-label'}>{item.label}</span>
        )}
      />
      <p className="price">
        <MotionNumber value={current.price} prefix="$" transition={transition} />
        <span className="per">per month</span>
      </p>
      <MotionSwap as="div" inline={false} value={plan} effect={effect} transition={transition}>
        <ul className="points">
          {current.points.map((point) => (
            <li key={point}>{point}</li>
          ))}
        </ul>
      </MotionSwap>
    </div>
  );
}

styles.css

.card {
  display: grid;
  gap: 18px;
  max-width: 420px;
  margin: 24px auto;
  padding: 22px;
  border: 1px solid #cfe8dc;
  border-radius: 18px;
  background: #fff;
}

.tabs {
  display: flex;
  gap: 2px;
  padding: 4px;
  border-radius: 999px;
  background: #eaf6f0;
}

.tab {
  flex: 1;
  min-height: 40px;
  border: 0;
  border-radius: 999px;
  background: none;
  font:
    650 15px system-ui,
    sans-serif;
  color: #0e2e24;
  cursor: pointer;
}

.tab-highlight {
  border-radius: 999px;
  background: #fff;
  box-shadow: 0 0 0 1px #cfe8dc;
}

.tab-label {
  color: #5b616b;
  transition: color 0.2s;
}

.tab-label.on {
  color: #176b52;
}

.price {
  display: flex;
  align-items: baseline;
  gap: 8px;
  margin: 0;
  font:
    800 44px/1 system-ui,
    sans-serif;
  font-variant-numeric: tabular-nums;
  color: #0e2e24;
}

.price .per {
  font-size: 15px;
  font-weight: 500;
  color: #5b616b;
}

.points {
  display: grid;
  gap: 10px;
  margin: 0;
  padding: 0;
  list-style: none;
}

.points li {
  padding: 12px 14px;
  border-radius: 12px;
  background: #f4faf7;
  color: #16181d;
}

02అత్యంత వేగం

బ్రౌజర్ ప్లే చేస్తుంది. React కదలకుండా ఉంటుంది.

వెబ్‌లో లోడ్ చేయాల్సిన యానిమేషన్ లైబ్రరీ లేదు: కాంపోనెంట్లు తమ మోషన్‌ను Web Animations API-కి అప్పగిస్తాయి; అందువల్ల దొర్లే సంఖ్య లేదా పరిమాణం మారే ప్యానెల్ కదులుతున్నప్పుడు ఫ్రేమ్‌కు JavaScript గానీ React రెండర్ గానీ ఖర్చు కావు.

12 యానిమేషన్లు కలిసి నడుస్తున్నప్పుడు 0 JS frame callback-లు.
విలువ మార్పుకు ఒక React commit, ఫ్రేమ్‌కు ఒకటి కాదు.
స్ట్రీమ్ అయ్యే టెక్స్ట్: 3000 అక్షరాలకు 11 React commit-లు. కింది ఉదాహరణ తన రెండర్‌లను తానే లెక్కిస్తుంది.

ఉదాహరణ సిద్ధమవుతోంది…

JavaScript ఆఫ్‌లో ఉంది. కింద ఉన్న కోడే పూర్తి ఉదాహరణ.

App.jsx

import { useEffect, useRef, useState } from 'react';
import { MotionStream } from '@kkwaenggwari/animated-chorus';
import './styles.css';

const answer =
  'Motion helps people follow change. When a total updates, a rolling number shows which way it moved. ' +
  'When a panel opens, the height that follows its content keeps the reader in place. ' +
  'When an answer arrives in bursts, a steady reveal turns the bursts into reading: nothing waits for the ' +
  'next packet, and nothing is dumped at once. The pace speeds up only when a backlog builds, so the text ' +
  'never falls far behind what the server has already sent.';

// Network-like bursts: long pauses, then a lot of text at once.
const pauses = [300, 1100, 250, 1500, 400, 900];

export default function App({ speed = 90, catchUp = 900, chunk = 160, effect = 'fade' }) {
  const [received, setReceived] = useState(0);
  const [chunks, setChunks] = useState(0);
  const renders = useRef(0);
  renders.current += 1;

  useEffect(() => {
    if (received >= answer.length) return;
    const timer = setTimeout(
      () => {
        setReceived((current) => Math.min(answer.length, current + chunk));
        setChunks((count) => count + 1);
      },
      pauses[chunks % pauses.length],
    );
    return () => clearTimeout(timer);
  }, [received, chunks, chunk]);

  const askAgain = () => {
    setReceived(0);
    setChunks(0);
  };

  return (
    <div className="chat">
      <p className="question">Why does motion help an interface?</p>
      <p className="answer">
        <MotionStream
          text={answer.slice(0, received)}
          speed={speed}
          catchUp={catchUp}
          effect={effect}
        />
      </p>
      <footer>
        <output>
          {chunks} chunks · App rendered {renders.current} times
        </output>
        <button onClick={askAgain}>Ask again</button>
      </footer>
    </div>
  );
}

styles.css

.chat {
  display: grid;
  gap: 16px;
  max-width: 620px;
  margin: 0 auto;
  padding: 24px 20px;
}

.question {
  justify-self: end;
  max-width: 80%;
  margin: 0;
  padding: 10px 16px;
  border-radius: 18px 18px 4px 18px;
  background: #176b52;
  color: #fff;
}

.answer {
  min-height: 180px;
  margin: 0;
  padding: 16px 18px;
  border: 1px solid #cfe8dc;
  border-radius: 18px 18px 18px 4px;
  background: #fff;
  color: #16181d;
  line-height: 1.65;
}

footer {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 10px;
}

output {
  font:
    600 13px ui-monospace,
    Consolas,
    monospace;
  color: #176b52;
}

footer button {
  min-height: 40px;
  padding: 0 16px;
  border: 1px solid #cfe8dc;
  border-radius: 999px;
  background: #fff;
  font:
    600 14px system-ui,
    sans-serif;
  cursor: pointer;
}

03అత్యంత స్థిరం

దేనికైనా అంతరాయం కలిగించండి. అది ఎప్పుడూ దూకదు.

ప్రతి కొత్త విలువ స్క్రీన్‌పై ఉన్నదాని నుండి ప్రారంభమవుతుంది, spring-లు తమ వేగాన్ని నిలుపుకుంటాయి; అందువల్ల వేగవంతమైన క్లిక్‌లు, డేటా పేలుళ్లు, దిశ మార్పులు ఉద్దేశపూర్వకంగా కనిపిస్తాయి. మోషన్ ముగిసినప్పుడు ఏదీ నడుస్తూ ఉండదు.

సంఖ్యలు ఎప్పుడూ చీలవు: మిగిలిన స్థానాలు దొర్లుతూనే జారుతాయి.
5 ms వ్యవధిలో 200 కొత్త విలువలు: తర్వాత మిగిలిన యానిమేషన్లు 0, ఖచ్చితమైన చివరి టెక్స్ట్.
React StrictMode-లో సురక్షితం. నేపథ్యంలో ఉన్న React Native యాప్‌లో మోషన్ తన చివరి స్థితికి స్థిరపడుతుంది.

ఉదాహరణ సిద్ధమవుతోంది…

JavaScript ఆఫ్‌లో ఉంది. కింద ఉన్న కోడే పూర్తి ఉదాహరణ.

App.jsx

import { useEffect, useState } from 'react';
import { MotionNumber, motionTokens } from '@kkwaenggwari/animated-chorus';
import './styles.css';

const burst = [12, 37, 85, 140, 9, 260, 48, 530, 21, 1100, 75, 2300];

export default function App({ mode = 'roll', direction = 'auto', spring = 'default' }) {
  const [value, setValue] = useState(1280);
  const [changes, setChanges] = useState(0);
  const [bursting, setBursting] = useState(false);

  const change = (next) => {
    setValue(next);
    setChanges((count) => count + 1);
  };

  // Twelve rising values, 90 ms apart, like a live counter: each arrives mid-motion.
  useEffect(() => {
    if (!bursting) return;
    let step = 0;
    const timer = setInterval(() => {
      const delta = burst[step];
      setValue((current) => Math.max(0, current + delta));
      setChanges((count) => count + 1);
      step += 1;
      if (step === burst.length) {
        clearInterval(timer);
        setBursting(false);
      }
    }, 90);
    return () => clearInterval(timer);
  }, [bursting]);

  return (
    <div className="counter">
      <MotionNumber
        className="value"
        value={value}
        intl
        locale="en-US"
        mode={mode}
        direction={direction}
        transition={motionTokens.spring[spring]}
      />
      <p className="changes">{changes} changes, no jumps</p>
      <div className="buttons">
        <button onClick={() => change(Math.max(0, value - 100))}>−100</button>
        <button onClick={() => change(value + 1)}>+1</button>
        <button onClick={() => change(value + 250)}>+250</button>
        <button onClick={() => change(value * 10)}>×10</button>
        <button onClick={() => change(Math.round(value / 10))}>÷10</button>
        <button className="burst" onClick={() => setBursting(true)} disabled={bursting}>
          Burst ×12
        </button>
      </div>
    </div>
  );
}

styles.css

.counter {
  display: grid;
  justify-items: center;
  gap: 14px;
  padding: 36px 20px 28px;
}

.value {
  font:
    800 clamp(48px, 12vw, 88px)/1.05 system-ui,
    sans-serif;
  font-variant-numeric: tabular-nums;
  letter-spacing: -0.03em;
  color: #0e2e24;
}

.changes {
  margin: 0;
  color: #5b616b;
  font-size: 14px;
}

.buttons {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  gap: 8px;
}

.buttons button {
  min-width: 64px;
  min-height: 44px;
  padding: 0 16px;
  border: 1px solid #cfe8dc;
  border-radius: 999px;
  background: #fff;
  font:
    650 15px system-ui,
    sans-serif;
  color: #0e2e24;
  cursor: pointer;
}

.buttons button:hover {
  border-color: #176b52;
}

.buttons .burst {
  border-color: #176b52;
  background: #176b52;
  color: #fff;
}

.buttons .burst:disabled {
  opacity: 0.5;
}

16 కాంపోనెంట్లు, అవి చేసే పని ప్రకారం సమూహం చేయబడ్డాయి

సంఖ్యలు, టెక్స్ట్, పరిమాణం మారే విషయం, ఎంపిక, జాబితాలు, సంజ్ఞలు, ఓవర్‌లేలు, పురోగతి. ప్రతిదానికీ పక్కన props ఉన్న లైవ్ వర్క్‌బెంచ్ ఉంది.

అన్ని కాంపోనెంట్లు

కలిపి

అనేక కాంపోనెంట్లను కలిపే సంపూర్ణ స్క్రీన్‌లు, ప్రతిదాని సెట్టింగ్‌లు ఉదాహరణ బయట.

అన్ని ఉదాహరణలు

వెబ్‌లో, React Native-లో అదే import

Metro నేటివ్ అమలును, వెబ్ బండ్లర్‌లు DOM అమలును ఎంచుకుంటాయి. ప్రతి ప్లాట్‌ఫారమ్ తనకు ఉత్తమమైన విధంగా మోషన్‌ను ప్లే చేస్తుంది.

App.jsx

// Web and React Native: the same import.
import { MotionNumber, MotionList } from '@kkwaenggwari/animated-chorus';

export function Score({ points, players }) {
  return (
    <>
      <MotionNumber value={points} />
      <MotionList items={players} renderItem={(player) => player.name} />
    </>
  );
}

భాగం	వెబ్	React Native
Transform-లు, opacity	Web Animations API, spring-లు విశ్లేషణాత్మకంగా నమూనా చేయబడతాయి	నేటివ్ driver‌తో `Animated`
వెడల్పు, ఎత్తు	Web Animations API	JS driver‌తో `Animated`, ఎందుకంటే ఇది లేఅవుట్
స్ట్రీమ్ అయ్యే టెక్స్ట్	అక్షరాలు జోడించబడి మసకగా కనిపిస్తాయి; సెకనుకు కొన్ని React రెండర్‌లు	నిజమైన `Text`, మసక లేకుండా బయటపడుతుంది
షీట్‌లు, జూమ్	పై పొరలో నేటివ్ `dialog`	పారదర్శక `Modal`; వెనుక బటన్ దాన్ని మూసివేస్తుంది

రెండు నిమిషాల్లో ప్రారంభించండి

ఇన్‌స్టాల్ చేయండి, ఒక కాంపోనెంట్ import చేయండి, విలువ ఇవ్వండి.

npm install @kkwaenggwari/animated-chorus

కష్టమైన ఇంటరాక్షన్లు, పూర్తయ్యాయి.

ఈ build‌లో కొలవబడింది

ఒకే tag, మీ డేటా

బ్రౌజర్ ప్లే చేస్తుంది. React కదలకుండా ఉంటుంది.

దేనికైనా అంతరాయం కలిగించండి. అది ఎప్పుడూ దూకదు.

16 కాంపోనెంట్లు, అవి చేసే పని ప్రకారం సమూహం చేయబడ్డాయి

సంఖ్యలు, టెక్స్ట్

విషయం, పరిమాణం

ఎంపిక, పేజింగ్

జాబితాలు

సంజ్ఞలు

ఓవర్‌లేలు

పురోగతి

కలిపి

వెబ్‌లో, React Native-లో అదే import

రెండు నిమిషాల్లో ప్రారంభించండి

వెతకండి