1 звезда на GitHub = 1 новый компонент.

Поставить звезду
Портфолио разработчика

Dev Article

Шаблон статьи: метаданные, заголовок, лид, теги, индикатор прогресса чтения, монохромная типографика с блоками кода и клавиши «назад / вперёд».

blogarticleproseportfolio
Живое превью
← All articles

/animation5 min

Damped springs instead of per-frame tweens

Why calling a tween library every frame makes a 3D slider feel rubbery, and the one-line function that fixes it.

  • #animation
  • #javascript

Compute where each card should be and move it a fraction of the way every frame:

const damp = (a, b, k, dt) => a + (b - a) * (1 - Math.exp(-k * dt));

Continuous layouts

Smoothstep between the centre and its neighbours, and the card no longer jumps when it crosses the middle.

Использование

Скопируйте и вставьте этот код в ваш React-компонент:

tsx
import { DevArticle } from 'react-component-kit-ui/sections';

<DevArticle title="Damped springs" date="2026-09-14" category="animation" html="<p>…</p>" />

Ручная установка

Если вы не используете пакет npm, создайте файл и вставьте следующий код: src/components/sections/DevArticle.tsx + DevArticle.css:

DevArticle.tsx
'use client';

import { useEffect, useRef } from 'react';
import type { ReactNode } from 'react';
import './DevArticle.css';

/** class:list → className */
function cx(...args: unknown[]): string {
  const out: string[] = [];
  const walk = (v: unknown) => {
    if (!v) return;
    if (typeof v === 'string' || typeof v === 'number') out.push(String(v));
    else if (Array.isArray(v)) v.forEach(walk);
    else if (typeof v === 'object') for (const [k, on] of Object.entries(v as Record<string, unknown>)) if (on) out.push(k);
  };
  args.forEach(walk);
  return out.join(' ');
}

/**
 * DevArticle — Blog post layout for developer portfolios ("Keycap" design): back link, meta line,
 * title, lead, tags, a reading-progress bar and monochrome prose styles for headings, lists, quotes
 * and code blocks, followed by previous / next article keys.
 *
 * @param {string} title - Post title (h1).
 * @param {string} excerpt - Lead paragraph.
 * @param {string} date - ISO date (YYYY-MM-DD).
 * @param {string} category - Category.
 * @param {string} readingTime - e.g. "6 min".
 * @param {string} author - Optional author name.
 * @param {string[]} tags - Tags.
 * @param {string} html - Trusted HTML body. Alternatively pass the body in the default slot.
 * @param {{label: string, href: string}} back - Back link. Default 'All articles' → '/blog/'.
 * @param {{title: string, href: string}} prev - Previous article.
 * @param {{title: string, href: string}} next - Next article.
 * @param {string} locale - Date locale. Default 'en-US'.
 * @param {string} className - Extra class.
 *
 * Accessibility: article landmark with one h1; the progress bar is decorative (aria-hidden);
 * code blocks scroll horizontally and are focusable; pager is a labelled nav.
 */
export interface DevArticleProps {
  title?: string;
  excerpt?: string;
  date?: string;
  category?: string;
  readingTime?: string;
  author?: string;
  tags?: string[];
  html?: string;
  back?: { label: string; href: string };
  prev?: { title: string; href: string };
  next?: { title: string; href: string };
  locale?: string;
  className?: string;
  children?: ReactNode;
}

export function DevArticle({
  title = 'Damped springs instead of per-frame tweens',
  excerpt = 'Why calling a tween library every frame makes a 3D slider feel rubbery, and the one-line function that fixes it.',
  date = '2026-09-14',
  category = 'animation',
  readingTime = '5 min',
  author,
  tags = ['animation', 'javascript'],
  html: htmlProp,
  back = { label: 'All articles', href: '/blog/' }, prev, next, locale = 'en-US', className = '',
  children
}: DevArticleProps) {
  const DEMO_HTML = '<p>Compute where each card <em>should</em> be and move it a fraction of the way every frame:</p><pre><code>const damp = (a, b, k, dt) =&gt; a + (b - a) * (1 - Math.exp(-k * dt));</code></pre><h2>Continuous layouts</h2><p>Smoothstep between the centre and its neighbours, and the card no longer jumps when it crosses the middle.</p>';
  const html = htmlProp ?? (children != null ? undefined : DEMO_HTML);
  const formatted = new Intl.DateTimeFormat(locale, { year: 'numeric', month: 'long', day: 'numeric', timeZone: 'UTC' }).format(new Date(`${date}T00:00:00Z`));

  // Reading progress bar + focusable code blocks (scoped to this article, cleaned up on unmount).
  const rootRef = useRef<HTMLElement>(null);
  useEffect(() => {
    const root = rootRef.current;
    if (!root) return;
    root.querySelectorAll<HTMLElement>('[data-prose] pre').forEach((pre) => pre.setAttribute('tabindex', '0'));
    const bar = root.querySelector<HTMLElement>('[data-progress]');
    if (!bar) return;
    let raf = 0;
    const update = () => {
      raf = 0;
      const r = root.getBoundingClientRect();
      const total = r.height - window.innerHeight;
      const p = total > 0 ? Math.min(1, Math.max(0, -r.top / total)) : 1;
      bar.style.transform = `scaleX(${p})`;
    };
    const onScroll = () => { if (!raf) raf = requestAnimationFrame(update); };
    window.addEventListener('scroll', onScroll, { passive: true });
    update();
    return () => {
      window.removeEventListener('scroll', onScroll);
      if (raf) cancelAnimationFrame(raf);
    };
  }, [html]);

  return (
    <>
      <article ref={rootRef} className={cx(['dvar', className])} data-dev-article data-rk-6a1464="">
        <div className="dvar__progress" aria-hidden="true" data-rk-6a1464=""><span data-progress data-rk-6a1464=""></span></div>
        <header className="dvar__head" data-rk-6a1464="">
          <a className="dvar__back" href={back.href} data-rk-6a1464="">← {back.label}</a>
          <p className="dvar__meta" data-rk-6a1464="">
            <time dateTime={date} data-rk-6a1464="">{formatted}</time>
            {author && <><span aria-hidden="true" data-rk-6a1464="">•</span><span data-rk-6a1464="">{author}</span></>}
            {category && <><span aria-hidden="true" data-rk-6a1464="">•</span><span data-rk-6a1464="">/{category}</span></>}
            {readingTime && <><span aria-hidden="true" data-rk-6a1464="">•</span><span data-rk-6a1464="">{readingTime}</span></>}
          </p>
          <h1 className="dvar__title" data-rk-6a1464="">{title}</h1>
          {excerpt && <p className="dvar__lead" data-rk-6a1464="">{excerpt}</p>}
          {tags.length > 0 && <ul className="dvar__tags" data-rk-6a1464="">{tags.map((t, __i: number) => <li key={__i} data-rk-6a1464="">#{t}</li>)}</ul>}
        </header>
      
        {html
          ? <div className="dvar__prose" data-prose data-rk-6a1464="" dangerouslySetInnerHTML={{ __html: html }} />
          : <div className="dvar__prose" data-prose data-rk-6a1464="">{children}</div>}
      
        {(prev || next) && (
          <nav className="dvar__pager" aria-label="More articles" data-rk-6a1464="">
            {prev ? <a href={prev.href} rel="prev" data-rk-6a1464=""><span data-rk-6a1464="">← Previous</span><strong data-rk-6a1464="">{prev.title}</strong></a> : <span data-rk-6a1464=""></span>}
            {next && <a className="dvar__next" href={next.href} rel="next" data-rk-6a1464=""><span data-rk-6a1464="">Next →</span><strong data-rk-6a1464="">{next.title}</strong></a>}
          </nav>
        )}
      </article>
    </>
  );
}

export default DevArticle;
DevArticle.css
.dvar:where([data-rk-6a1464]) { max-width: 760px; margin: 0 auto; padding: clamp(7rem, 14vw, 9rem) clamp(1rem, 3vw, 1.5rem) clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvar__progress:where([data-rk-6a1464]) { position: fixed; inset: 0 0 auto; z-index: 950; height: 3px; pointer-events: none; }
.dvar__progress:where([data-rk-6a1464]) span:where([data-rk-6a1464]) { display: block; height: 100%; width: 100%; background: var(--c-text-1); transform-origin: 0 50%; transform: scaleX(0); }
.dvar__back:where([data-rk-6a1464]) { display: inline-flex; align-items: center; min-height: 36px; margin-bottom: 1.5rem; font-family: var(--font-mono); font-size: 0.75rem; color: var(--c-text-2); text-decoration: none; }
.dvar__back:hover:where([data-rk-6a1464]) { color: var(--c-text-1); }
.dvar__meta:where([data-rk-6a1464]) { display: flex; flex-wrap: wrap; gap: 0.5rem; margin: 0 0 1rem; font-family: var(--font-mono); font-size: 0.72rem; color: var(--c-text-3); }
.dvar__title:where([data-rk-6a1464]) { margin: 0 0 1rem; font-size: clamp(2rem, 5vw, 3.1rem); font-weight: 800; letter-spacing: -0.035em; line-height: 1.05; }
.dvar__lead:where([data-rk-6a1464]) { margin: 0 0 1.25rem; font-size: 1.15rem; line-height: 1.65; color: var(--c-text-2); }
.dvar__tags:where([data-rk-6a1464]) { display: flex; flex-wrap: wrap; gap: 0.4rem; margin: 0 0 2rem; padding: 0 0 2rem; list-style: none; border-bottom: 1.5px solid var(--c-text-1); }
.dvar__tags:where([data-rk-6a1464]) li:where([data-rk-6a1464]) { padding: 0.2rem 0.55rem; border: 1px solid var(--c-border); border-radius: 2px; font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-2); }

.dvar__prose:where([data-rk-6a1464]) { font-size: 1.05rem; line-height: 1.8; color: var(--c-text-2); }
.dvar__prose:where([data-rk-6a1464]) > * + * { margin-top: 1.25rem; }
.dvar__prose:where([data-rk-6a1464]) h2 { margin-top: 2.5rem; font-size: 1.5rem; font-weight: 700; letter-spacing: -0.02em; line-height: 1.25; color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) h3 { margin-top: 2rem; font-size: 1.2rem; font-weight: 700; color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) p { margin-bottom: 0; }
.dvar__prose:where([data-rk-6a1464]) a { color: var(--c-text-1); text-decoration: underline; text-underline-offset: 3px; }
.dvar__prose:where([data-rk-6a1464]) strong { color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) ul, .dvar__prose:where([data-rk-6a1464]) ol { padding-left: 1.25rem; }
.dvar__prose:where([data-rk-6a1464]) li + li { margin-top: 0.4rem; }
.dvar__prose:where([data-rk-6a1464]) li::marker { color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) blockquote { margin-left: 0; padding: 0.25rem 0 0.25rem 1.25rem; border-left: 3px solid var(--c-text-1); font-style: italic; color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) :not(pre) > code { padding: 0.12rem 0.38rem; border-radius: 3px; background: rgb(var(--ink-rgb, 0 0 0) / 0.06); font-family: var(--font-mono); font-size: 0.88em; color: var(--c-text-1); }
.dvar__prose:where([data-rk-6a1464]) pre { overflow-x: auto; padding: 1.1rem 1.25rem; border: 1.5px solid var(--c-text-1); border-radius: 4px; background: var(--c-text-1); color: var(--c-bg); box-shadow: 4px 4px 0 rgb(var(--ink-rgb, 0 0 0) / 0.18); font-family: var(--font-mono); font-size: 0.85rem; line-height: 1.6; }
.dvar__prose:where([data-rk-6a1464]) pre:focus-visible { outline: 2px solid var(--c-text-1); outline-offset: 3px; }
.dvar__prose:where([data-rk-6a1464]) img { max-width: 100%; height: auto; border-radius: 4px; }
.dvar__prose:where([data-rk-6a1464]) hr { border: 0; height: 1px; background: var(--c-border); margin: 2.5rem 0; }

.dvar__pager:where([data-rk-6a1464]) { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin-top: 3.5rem; padding-top: 2rem; border-top: 1.5px solid var(--c-text-1); }
.dvar__pager:where([data-rk-6a1464]) a:where([data-rk-6a1464]) { display: flex; flex-direction: column; gap: 0.3rem; padding: 1rem 1.1rem; border: 1.5px solid var(--c-text-1); border-radius: 4px; color: var(--c-text-1); text-decoration: none; box-shadow: 0 4px 0 var(--c-text-1); transition: transform 0.18s ease, box-shadow 0.18s ease; }
.dvar__pager:where([data-rk-6a1464]) a:hover:where([data-rk-6a1464]) { transform: translateY(2px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvar__pager:where([data-rk-6a1464]) span:where([data-rk-6a1464]) { font-family: var(--font-mono); font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--c-text-3); }
.dvar__pager:where([data-rk-6a1464]) strong:where([data-rk-6a1464]) { font-size: 1rem; line-height: 1.35; }
.dvar__next:where([data-rk-6a1464]) { grid-column: 2; text-align: right; }
.dvar:where([data-rk-6a1464]) :focus-visible:where([data-rk-6a1464]) { outline: 2px solid var(--c-text-1); outline-offset: 3px; }
@media (max-width: 560px) { .dvar__pager:where([data-rk-6a1464]) { grid-template-columns: 1fr; } .dvar__next:where([data-rk-6a1464]) { grid-column: auto; } }