{
  "id": "motion:motion-stroke-order",
  "slug": "motion-stroke-order",
  "kind": "motion",
  "title": {
    "ja": "筆順",
    "en": "Stroke order"
  },
  "aiName": "Stroke-order handwriting",
  "summary": {
    "ja": "文字が一画ずつ、筆順どおりに書かれる",
    "en": "A character is written one stroke at a time, in stroke order"
  },
  "number": 45,
  "group": "text-motion",
  "techniques": [
    "svg",
    "scroll-progress"
  ],
  "rules": [
    {
      "ja": "各画の path は筆の入りの点から書き始める。逆の端から描くと、筆順の向きが壊れる",
      "en": "Start each path at the point where the brush lands; drawing from the other end reverses the stroke direction"
    },
    {
      "ja": "画の順は筆順そのもの。1 画の描き終わりを待ってから次の画に移る",
      "en": "The order of strokes is the stroke order; finish one stroke before the next begins"
    },
    {
      "ja": "長さ 0 の線も丸い端の点が残るので、書き始める前の画は visibility: hidden にする",
      "en": "A zero-length line still leaves a round-cap dot, so keep unwritten strokes visibility: hidden"
    },
    {
      "ja": "動きを減らす設定では、全画を書き終えた状態で止める",
      "en": "With reduced motion, stop with every stroke already written"
    }
  ],
  "reproduction": {
    "prompt": {
      "ja": "筆順 — Stroke-order handwriting\n\n「日」（4 画）と「本」（5 画）の 2 文字を、スクロールに合わせて 1 画ずつ筆順どおりに書いてください。各画は SVG の path（stroke-linecap: round、stroke-width 7）で、pathLength=\"1\" を付け、stroke-dasharray: 1 のまま stroke-dashoffset を 1 から 0 へ動かして描きます。420vh の pin 区画の進み 8% から 86% を使い、画ごとの実際の長さに比例して進みを配ります（長い画ほど長く書く）。いま書いている画の先端にはアクセント色の点を置き、下に「筆順 05 / 09」と画数を出します。各文字には薄い手本の線と点線の十字（米字格の半分）を敷き、JavaScript が動かない、または動きを減らす設定では 9 画を書き終えた状態で見せます。CSS と JavaScript だけで実装し、ライブラリは使わないでください。\n\n外すと崩れる点:\n- 各画の path は筆の入りの点から書き始める。逆の端から描くと、筆順の向きが壊れる\n- 画の順は筆順そのもの。1 画の描き終わりを待ってから次の画に移る\n- 長さ 0 の線も丸い端の点が残るので、書き始める前の画は visibility: hidden にする\n- 動きを減らす設定では、全画を書き終えた状態で止める\n\n動く実物（1 ファイルで完結する HTML）: https://design-vault.pages.dev/designs/motion-stroke-order/demo.html",
      "en": "Stroke order — Stroke-order handwriting\n\nWrite the two characters 日 (4 strokes) and 本 (5 strokes) one stroke at a time, in correct stroke order, as the page scrolls. Draw each stroke as an SVG path (stroke-linecap: round, stroke-width 7) with pathLength=\"1\", keeping stroke-dasharray: 1 and moving stroke-dashoffset from 1 to 0. Use 8% to 86% of the progress through a 420vh pinned section, and give each stroke a share of it proportional to its real length so longer strokes take longer. Put an accent-coloured dot at the tip of the stroke being written, and show the stroke count below as \"筆順 05 / 09\". Lay a faint guide of the strokes and a dotted cross under each character, and with JavaScript off or reduced motion show all nine strokes already written. Implement it with CSS and JavaScript only, without any library.\n\nDo not drop:\n- Start each path at the point where the brush lands; drawing from the other end reverses the stroke direction\n- The order of strokes is the stroke order; finish one stroke before the next begins\n- A zero-length line still leaves a round-cap dot, so keep unwritten strokes visibility: hidden\n- With reduced motion, stop with every stroke already written\n\nA working example (one self-contained HTML file): https://design-vault.pages.dev/designs/motion-stroke-order/demo.html"
    },
    "code": {
      "url": "https://design-vault.pages.dev/designs/motion-stroke-order/demo.html",
      "html": "<!doctype html>\n<html lang=\"ja\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>45 筆順 — Stroke-order handwriting</title>\n<style>\n/* dv-motion-base:start */\n:root {\n  --ground: #FFFFFF;\n  --surface: #F3F5F8;\n  --ink: #14181F;\n  --muted: #5A6472;\n  --accent: #1F5FA8;\n  --rule: #D8DDE4;\n  --accent-soft: color-mix(in srgb, var(--accent) 12%, var(--ground));\n  --accent-mid: color-mix(in srgb, var(--accent) 45%, var(--ground));\n  --shade: color-mix(in srgb, var(--ink) 14%, transparent);\n\n  --font: \"Zen Kaku Gothic New\", \"Hiragino Sans\", \"Noto Sans JP\", \"Yu Gothic\", system-ui, sans-serif;\n  --mono: ui-monospace, \"SF Mono\", Menlo, Consolas, monospace;\n\n  --t-label: 13px;\n  --t-body: 16px;\n  --t-lead: 20px;\n  --t-h2: 32px;\n  --t-h1: clamp(40px, 7vw, 72px);\n\n  --s1: 4px;\n  --s2: 8px;\n  --s3: 16px;\n  --s4: 24px;\n  --s5: 40px;\n  --s6: 64px;\n  --s7: 104px;\n\n  --radius: 12px;\n  --ease: cubic-bezier(.2, .7, .2, 1);\n  --dur: .7s;\n  --measure: 1080px;\n}\n*, *::before, *::after { box-sizing: border-box; }\nhtml { -webkit-text-size-adjust: 100%; }\nbody {\n  margin: 0;\n  background: var(--ground);\n  color: var(--ink);\n  font-family: var(--font);\n  font-size: var(--t-body);\n  line-height: 1.7;\n  font-feature-settings: \"palt\";\n  overflow-x: hidden;\n}\nh1, h2, h3, p, ul, ol, figure { margin: 0; padding: 0; }\nul, ol { list-style: none; }\n.dv-wrap { width: min(100% - 2 * var(--s4), var(--measure)); margin-inline: auto; }\n.dv-label {\n  min-height: 72vh;\n  display: grid;\n  align-content: center;\n  gap: var(--s3);\n  padding-block: var(--s6);\n  border-bottom: 1px solid var(--rule);\n}\n.dv-num { font-family: var(--mono); font-size: var(--t-lead); font-weight: 700; color: var(--accent); letter-spacing: .04em; }\n.dv-name { font-size: var(--t-h1); font-weight: 700; line-height: 1.15; letter-spacing: .01em; }\n.dv-ai { font-family: var(--mono); font-size: var(--t-lead); color: var(--muted); }\n.dv-desc { font-size: var(--t-lead); color: var(--ink); }\n.dv-hint { font-size: var(--t-label); color: var(--muted); letter-spacing: .12em; margin-top: var(--s4); }\n.dv-stage { padding-block: var(--s7); }\n.dv-h2 { font-size: var(--t-h2); font-weight: 700; line-height: 1.3; }\n.dv-lead { font-size: var(--t-lead); color: var(--muted); }\n.dv-eyebrow { font-family: var(--mono); font-size: var(--t-label); color: var(--accent); letter-spacing: .12em; text-transform: uppercase; }\n.dv-card { background: var(--surface); border: 1px solid var(--rule); border-radius: var(--radius); padding: var(--s4); }\n.dv-ph {\n  border-radius: var(--radius);\n  background: linear-gradient(135deg, var(--accent-soft), var(--accent-mid) 60%, var(--accent));\n  aspect-ratio: 16 / 9;\n}\n.dv-ph--alt { background: linear-gradient(200deg, var(--surface), var(--accent-soft) 55%, var(--accent-mid)); }\n.dv-ph--ink { background: linear-gradient(160deg, var(--ink), color-mix(in srgb, var(--ink) 55%, var(--accent))); }\n.dv-end {\n  min-height: 60vh;\n  display: grid;\n  place-items: center;\n  border-top: 1px solid var(--rule);\n  color: var(--muted);\n  font-family: var(--mono);\n  font-size: var(--t-label);\n  letter-spacing: .12em;\n}\n/* dv-motion-base:end */\n\n/* ---- この演出だけの CSS。色は var(--…) か color-mix() のみ ---- */\n.stack { display: grid; gap: var(--s6); }\n.so-zone { height: 420vh; }\n.so-stick {\n  position: sticky; top: 0; height: 100vh;\n  display: grid; place-content: center; justify-items: center; gap: var(--s4);\n}\n/* 幅は画面から決める。中央寄せの grid の中で % を使うと箱が点まで縮む。 */\n.so-board { display: block; width: min(100vw - 2 * var(--s4), 760px); height: auto; overflow: visible; }\n.so-guide { fill: none; stroke: color-mix(in srgb, var(--ink) 11%, var(--ground)); stroke-width: 7; stroke-linecap: round; stroke-linejoin: round; }\n.so-ink { fill: none; stroke: var(--ink); stroke-width: 7; stroke-linecap: round; stroke-linejoin: round; }\n.so-grid { fill: none; stroke: var(--rule); stroke-width: 1; stroke-dasharray: 4 5; }\n.so-frame { fill: none; stroke: var(--rule); stroke-width: 1.5; }\n.so-tip { fill: var(--accent); opacity: 0; }\n.so-count { font-family: var(--mono); font-size: var(--t-label); color: var(--muted); letter-spacing: .12em; }\n.so-count b { color: var(--accent); font-weight: 700; }\n\n@media (prefers-reduced-motion: reduce) {\n  .so-zone { height: auto; }\n  .so-stick { position: static; height: auto; padding-block: var(--s6); }\n  .so-tip { display: none; }\n}\n</style>\n</head>\n<body data-motion-number=\"45\">\n<header class=\"dv-label\">\n  <div class=\"dv-wrap\">\n    <p class=\"dv-num\">45</p>\n    <h1 class=\"dv-name\">筆順</h1>\n    <p class=\"dv-ai\">Stroke-order handwriting</p>\n    <p class=\"dv-desc\">文字が一画ずつ、筆順どおりに書かれる</p>\n    <p class=\"dv-hint\">SCROLL ↓</p>\n  </div>\n</header>\n\n<main class=\"dv-stage\">\n<div class=\"dv-wrap stack\">\n    <section class=\"dv-card\">\n      <p class=\"dv-eyebrow\">Section 1</p>\n      <h2 class=\"dv-h2\">見出しが入ります</h2>\n      <p class=\"dv-lead\">本文のダミーです。スクロールすると、下の二文字が一画ずつ筆順どおりに書かれていきます。</p>\n    </section>\n  </div>\n\n  <section class=\"so-zone\" data-progress=\"pin\">\n    <div class=\"so-stick\">\n      <svg class=\"so-board\" viewBox=\"0 0 240 120\" role=\"img\" aria-label=\"日本（にほん）\" xmlns=\"http://www.w3.org/2000/svg\">\n        <g class=\"so-frames\">\n          <rect class=\"so-frame\" x=\"2\" y=\"10\" width=\"104\" height=\"104\" rx=\"4\"/>\n          <rect class=\"so-frame\" x=\"134\" y=\"10\" width=\"104\" height=\"104\" rx=\"4\"/>\n          <path class=\"so-grid\" d=\"M54 10V114M2 62H106M186 10V114M134 62H238\"/>\n        </g>\n        <!-- 日（4 画）。各画の始点が筆の入り -->\n        <g class=\"so-char\" transform=\"translate(4 12)\">\n          <path class=\"so-guide\" d=\"M28 16V84\"/><path class=\"so-guide\" d=\"M28 16H72V84\"/><path class=\"so-guide\" d=\"M28 50H72\"/><path class=\"so-guide\" d=\"M28 84H72\"/>\n        </g>\n        <!-- 本（5 画） -->\n        <g class=\"so-char\" transform=\"translate(136 12)\">\n          <path class=\"so-guide\" d=\"M12 34H88\"/><path class=\"so-guide\" d=\"M50 10V92\"/><path class=\"so-guide\" d=\"M47 42Q36 64 12 80\"/><path class=\"so-guide\" d=\"M53 42Q64 64 88 80\"/><path class=\"so-guide\" d=\"M32 73H68\"/>\n        </g>\n        <g class=\"so-draw\" transform=\"translate(4 12)\">\n          <path class=\"so-ink\" pathLength=\"1\" d=\"M28 16V84\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M28 16H72V84\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M28 50H72\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M28 84H72\"/>\n        </g>\n        <g class=\"so-draw\" transform=\"translate(136 12)\">\n          <path class=\"so-ink\" pathLength=\"1\" d=\"M12 34H88\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M50 10V92\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M47 42Q36 64 12 80\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M53 42Q64 64 88 80\"/><path class=\"so-ink\" pathLength=\"1\" d=\"M32 73H68\"/>\n        </g>\n        <circle class=\"so-tip\" r=\"4.5\" cx=\"0\" cy=\"0\"/>\n      </svg>\n      <p class=\"so-count\">筆順 <b>09</b> / 09</p>\n    </div>\n  </section>\n\n  <div class=\"dv-wrap stack\">\n    <section class=\"dv-card\">\n      <p class=\"dv-eyebrow\">Section 2</p>\n      <h2 class=\"dv-h2\">見出しが入ります</h2>\n      <p class=\"dv-lead\">本文のダミーです。書き終えた文字は、そのまま残ります。</p>\n    </section>\n  </div>\n</main>\n\n<footer class=\"dv-end\">END — 45 筆順</footer>\n\n<script>\n/* dv-motion-helpers:start */\nconst dvReduce = matchMedia('(prefers-reduced-motion: reduce)').matches;\ndocument.documentElement.classList.add('js');\n\n/**\n * 画面に入った要素へ .is-in を付ける。\n * data-reveal=\"repeat\" の要素は画面を出たら外す（何度でも再生）。\n */\nfunction dvReveal(selector = '[data-reveal]', { threshold = 0.2, rootMargin = '0px 0px -8% 0px' } = {}) {\n  const els = [...document.querySelectorAll(selector)];\n  if (dvReduce || !('IntersectionObserver' in window)) {\n    els.forEach((el) => el.classList.add('is-in'));\n    return;\n  }\n  const io = new IntersectionObserver((entries) => {\n    for (const e of entries) {\n      if (e.isIntersecting) {\n        e.target.classList.add('is-in');\n        if (e.target.dataset.reveal !== 'repeat') io.unobserve(e.target);\n      } else if (e.target.dataset.reveal === 'repeat') {\n        e.target.classList.remove('is-in');\n      }\n    }\n  }, { threshold, rootMargin });\n  els.forEach((el) => io.observe(el));\n}\n\n/**\n * スクロール量を 0〜1 にして、各 [data-progress] 要素の CSS 変数 --p に書く。\n *   data-progress=\"through\" : 要素の上端が画面の下端に来たとき 0、下端が画面の上端を抜けたとき 1\n *   data-progress=\"pin\"     : 要素の上端が画面の上端に来たとき 0、下端が画面の下端に来たとき 1\n *                             （中に position: sticky の箱を持つ、背の高い区画用）\n *   data-progress=\"page\"    : ページ全体のスクロール量\n * onUpdate(el, p) を渡すと、値が変わるたびに呼ばれる。\n */\nfunction dvProgress(onUpdate) {\n  const els = [...document.querySelectorAll('[data-progress]')];\n  const clamp = (n) => Math.min(1, Math.max(0, n));\n  let queued = false;\n  const measure = () => {\n    queued = false;\n    const vh = window.innerHeight;\n    for (const el of els) {\n      const r = el.getBoundingClientRect();\n      let p;\n      if (el.dataset.progress === 'pin') p = r.height > vh ? -r.top / (r.height - vh) : 0;\n      else if (el.dataset.progress === 'page') {\n        const max = document.documentElement.scrollHeight - vh;\n        p = max > 0 ? window.scrollY / max : 0;\n      } else p = (vh - r.top) / (vh + r.height);\n      p = clamp(p);\n      el.style.setProperty('--p', p.toFixed(4));\n      if (onUpdate) onUpdate(el, p);\n    }\n  };\n  const request = () => {\n    if (!queued) { queued = true; requestAnimationFrame(measure); }\n  };\n  addEventListener('scroll', request, { passive: true });\n  addEventListener('resize', request);\n  measure();\n}\n/* dv-motion-helpers:end */\n\n/* ---- この演出だけの JS ---- */\nconst board = document.querySelector('.so-board');\nconst tip = board.querySelector('.so-tip');\nconst countNo = document.querySelector('.so-count b');\nconst inks = [...board.querySelectorAll('.so-ink')];\nconst lens = inks.map((p) => p.getTotalLength());\n// 画ごとの長さに比例して進みを配る。長い画ほど、書くのに長くかかる。\nconst total = lens.reduce((a, b) => a + b, 0);\nconst ends = [];\nlens.reduce((acc, len, i) => (ends[i] = (acc + len) / total, acc + len), 0);\n\nfunction draw(p) {\n  let done = 0;\n  inks.forEach((path, i) => {\n    const start = i === 0 ? 0 : ends[i - 1];\n    const t = Math.min(1, Math.max(0, (p - start) / (ends[i] - start)));\n    path.style.strokeDasharray = '1';\n    path.style.strokeDashoffset = String(1 - t);\n    // 長さ 0 の線も丸い端の点が残るので、書き始める前は隠す。\n    path.style.visibility = t > 0 ? 'visible' : 'hidden';\n    if (t >= 1) done = i + 1;\n    if (t > 0 && t < 1) {\n      // 筆先の点を、いま書いている画の先端へ。\n      const pt = path.getPointAtLength(lens[i] * t);\n      // 点は、その画と同じ座標系（親の <g>）へ移して置く。\n      if (tip.parentNode !== path.parentNode) path.parentNode.append(tip);\n      tip.setAttribute('cx', pt.x.toFixed(2));\n      tip.setAttribute('cy', pt.y.toFixed(2));\n      tip.style.opacity = '1';\n      done = i + 1;\n    }\n  });\n  if (p <= 0 || p >= 1) tip.style.opacity = '0';\n  countNo.textContent = String(done).padStart(2, '0');\n}\n\nif (dvReduce) {\n  countNo.textContent = String(inks.length).padStart(2, '0');\n} else {\n  // 書き始める前に少し間を置き、書き終えたあとも少し残す。\n  dvProgress((el, p) => draw(Math.min(1, Math.max(0, (p - 0.08) / 0.78))));\n}\n</script>\n</body>\n</html>\n"
    }
  },
  "license": "Original",
  "catalogVersion": 1,
  "designSchemaVersion": 2,
  "capabilities": [
    "live-preview",
    "copy-prompt",
    "get-code"
  ],
  "reusePolicy": "construction-reuse",
  "urls": {
    "ja": "https://design-vault.pages.dev/designs/motion-stroke-order",
    "en": "https://design-vault.pages.dev/en/designs/motion-stroke-order",
    "json": "https://design-vault.pages.dev/ai/assets/motion-stroke-order.json",
    "designJson": null
  }
}