MotionStream

স্থির গতিতে দেখানো স্ট্রিম হওয়া লেখা, যা ঝাপটার সঙ্গে তাল মেলায়।

ওয়েবReact Nativeসংখ্যা আর লেখা

চালিয়ে দেখুন

উদাহরণ প্রস্তুত হচ্ছে…

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;
}

সবচেয়ে ছোট ব্যবহার

Answer.jsx

<MotionStream text={answerSoFar} initial />

<MotionStream text={answerSoFar}>
  {visible => <Markdown>{visible}</Markdown>}
</MotionStream>

এটি আপনার হয়ে যা সামলায়

ঝাপটা পড়ার মতো হয়ে যায়: লেখা টুকরো টুকরো না এসে প্রতি সেকেন্ডে speedটি অক্ষরে দেখা দেয়।
জমে থাকলে দেখানোর গতি বাড়ে, যাতে প্রায় catchUp মিলিসেকেন্ডে দেখা যায়।
ইমোজি, পতাকা আর সংযোজক চিহ্ন কখনো ভাঙে না, আর অর্ধেক পাওয়া ইমোজি বাকিটার জন্য অপেক্ষা করে।
আবার লেখা উত্তর নতুন করে শুরু না করে ভাগ করা শুরু থেকে এগোয়।
দেখানো অক্ষর সরাসরি পাতায় যায়; React প্রতি সেকেন্ডে মাত্র কয়েকবার রেন্ডার করে।

যেখানে ব্যবহার করবেন

চ্যাটে সহকারীর উত্তর।
বিল্ড বা ডিপ্লয় লগ।
লাইভ ক্যাপশন।

Props

Prop	টাইপ	ডিফল্ট	বিবরণ
`text`	`string`	`—`আবশ্যক	এখন পর্যন্ত লেখা। বাড়তে থাকা লেখা স্থির গতিতে দেখা দেয়; আবার লেখা ভাগ করা শুরু থেকে এগোয়।
`speed`	`number`	`90`	প্রতি সেকেন্ডে অক্ষরে মূল প্রকাশের হার।
`catchUp`	`number`	`900`	জমে থাকা অংশ গতি বাড়িয়ে প্রায় এত মিলিসেকেন্ডে দেখানো হয়।
`initial`	`boolean`	`false`	মাউন্টের সময় থাকা লেখাও ধীরে দেখান (নাহলে সঙ্গে সঙ্গে দেখায়)।
`effect`	`'fade' \| 'none'`	`'fade'`	`fade` নতুন অক্ষর ফুটিয়ে তোলে; `none` সরাসরি দেখায়।
`children`	`(visible: string) => ReactNode`		গতি মেনে দেওয়া লেখা পাওয়া ফাংশন, যেমন Markdown রেন্ডার করতে।
`as`	`element`	`'span'`	রেন্ডার করার এলিমেন্ট।
`onMotionComplete`	`(text) => void`		প্রকাশ যখনই `text`-এর সমান হয়, চলে।

অন্য props রেন্ডার হওয়া এলিমেন্টে যায়, তাই className, style আর ইভেন্ট হ্যান্ডলার স্বাভাবিকভাবে কাজ করে।

ওয়েব আর React Native

ওয়েবে নতুন অক্ষর ফুটে ওঠে (effect="fade") আর সাধারণ, বাছাইযোগ্য লেখায় মিশে যায়। ফাংশন child Markdown-এর জন্য গতি মেনে দেওয়া স্ট্রিং পায়, বড়জোর প্রতি দুই ফ্রেমে একবার। লুকানো ট্যাবে সব একসঙ্গে দেখায়।

React Native-এ লেখা সত্যিকারের Text এবং ফেড ছাড়া দেখা দেয়।

এই উদাহরণগুলোতে ব্যবহৃত

চ্যাটের উত্তরগুটিয়ে যাওয়া পরামর্শ, স্থির গতিতে স্ট্রিম হওয়া উত্তর আর সোয়াপ হওয়া স্ট্যাটাস লাইন।MotionStreamMotionListMotionSwapMotionHeight