Reactで、表計算ソフトの範囲を貼り付けて表にする方法

​​React​Clipboard API,LibreOffice,Playwright,TypeScript

表計算ソフトの LibreOffice Calc でコピーしたセルの範囲は、onPaste で受け取った e.clipboardData から、主に HTML の表(text/html)とタブ区切りの文字(text/plain)の2つの形で読めました。HTML の <table> を DOMParser で読めば、セルの中の改行も残したまま、行と列の配列にできます。HTML がないときだけ、タブ区切りの文字を分けて使います。

Excel や Google スプレッドシートで用意した商品の一覧や名簿を、管理画面にまとめて貼り付けて取り込む、といった画面を想定した書き方です。Calc でコピーした表を、React のコンポーネントに Ctrl+V で貼り付けて確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Chromium 153、LibreOffice Calc 24.2 です。使ったのは react / react-dom 19.3.1、@types/react 19.3.0、typescript 7.0.2、esbuild 0.28.2、Playwright 1.63.0 です。.tsx を tsc で型チェックしてから esbuild で変換しました。Calc と Chromium を Xvfb の画面に並べて開き、Calc で選んだ範囲を Ctrl+C でコピーして、Chromium の入力欄で Ctrl+V を押しています。コピー元は LibreOffice Calc だけで、Microsoft Excel と Google スプレッドシートからのコピーは試していません。結合したセル、Windows と macOS、Firefox と Safari での貼り付けも試していません。

上に LibreOffice Calc、下にブラウザ。Calc で範囲をマウスで選んで Ctrl+C、ブラウザの入力欄で Ctrl+V を押すと表ができる。2回目は2列だけをコピーし、表が3行×2列に変わる
Calc でコピーした範囲を、ブラウザで2回貼り付けたときの動き(キーと回数の表示は GIF 用に重ねたもの。変わったところをピンクで強調)

コピーした範囲は、HTML とタブ区切りの文字の両方で届く

Calc で4行×4列の範囲をコピーし、入力欄に貼り付けたときの paste イベントを記録しました。コピー元の表には、セルの中で改行した「表紙は青」「中は方眼」のメモと、" を含む商品名「ペン "極細"」を入れてあります。記録した出力から、説明に使う行だけを抜き出しています。

text
paste イベントの types: ["text/plain","text/html","text/rtf","Files"]
text/plain: "商品名\t価格\t入荷日\tメモ\nノート\t1200\t2026-11-01\t表紙は青 中は方眼\nペン \"極細\"\t350\t2026-11-05\t\n消しゴム\t80\t\t在庫少\n"
text/html の「表紙は青」のセル: <td align="left" valign=bottom data-sheets-value="(略)"><font face="Noto Sans CJK SC">表紙は青<br>中は方眼</font></td>
files: ["image.png:image/png"]

text/plain は、セルをタブで、行を改行で区切った文字です。ただし、検証した Calc 24.2 では、セルの中の改行が空白に置き換わっていました。「表紙は青 中は方眼」が1行になっています。text/html のほうは <table> で、同じセルの改行は <br> として残っていました。そのため、この記事では HTML を先に読み、HTML がないときだけタブ区切りの文字を使います。

どちらの形も、MDN の paste イベントの説明にあるとおり、イベントの clipboardData に対して getData() を呼んで取り出します。React では、onPaste に渡すハンドラーが受け取るイベントから読めます。

files に image.png が入っているのは、Calc がコピーした範囲を画像としても渡しているためです。以前の記事「Reactで、貼り付けた画像を受け取って表示する方法」のように、画像の貼り付けも受け付ける画面に表の貼り付けを足すときは、files を見るより先に tableFromClipboard で表かどうかを調べます。

クリップボードの中身を行と列の配列にする

tableFromClipboard は、DataTransfer から表を読み取って、行と列の文字の配列を返す関数です。どちらの形から読んだかも、from で返します。

ts
export type Table = { rows: string[][]; from: 'html' | 'text' };

// セルの中の文字を取り出す。<br> は改行にし、ほかの空白はHTMLの表示と同じく1つにまとめる
function cellText(node: Node): string {
  let s = '';
  node.childNodes.forEach((child) => {
    if (child.nodeType === Node.TEXT_NODE) {
      s += (child.textContent ?? '').replace(/\s+/g, ' ');
    } else if (child.nodeName === 'BR') {
      s += '\n';
    } else {
      s += cellText(child);
    }
  });
  return s;
}

export function tableFromHtml(html: string): string[][] | null {
  const doc = new DOMParser().parseFromString(html, 'text/html');
  const table = doc.querySelector('table');
  if (!table) return null;
  return [...table.rows].map((tr) =>
    [...tr.cells].map((td) =>
      cellText(td)
        .split('\n')
        .map((line) => line.trim())
        .join('\n')
        .trim(),
    ),
  );
}

export function tableFromText(text: string): string[][] | null {
  const lines = text.replace(/\r\n?/g, '\n').replace(/\n$/, '').split('\n');
  if (!text.includes('\t') && lines.length < 2) return null;
  return lines.map((line) => line.split('\t'));
}

export function tableFromClipboard(data: DataTransfer): Table | null {
  const html = data.getData('text/html');
  const fromHtml = html ? tableFromHtml(html) : null;
  const rows = fromHtml ?? tableFromText(data.getData('text/plain'));
  // セル1つだけのときは表として扱わず、ふつうの貼り付けにする
  if (!rows || (rows.length === 1 && rows[0].length === 1)) return null;
  return { rows, from: fromHtml ? 'html' : 'text' };
}

tableFromHtml では、DOMParser の parseFromString() で HTML を文書にし、最初の table を探します。行は table.rows、セルは tr.cells で順に取り出せます。

MDN の textContent の説明にあるとおり、要素の textContent は、子ノードの textContent をつなげたものです。セルの文字を textContent でまとめて取ると、子を持たない <br> の分は何も入らず、改行が消えます。そこで cellText で中身をたどり、<br> を \n に、文字の中の空白や改行を1つの空白にしています。Calc の HTML では、空のセルが <br> だけになっていました。最後の trim() で、こうしたセルを空の文字にしています。

tableFromText は、改行とタブで分けます。Calc の text/plain は最後の行のあとにも改行が付いていたので、末尾の改行を1つ落としてから分けています。

Calc の HTML と文字を、それぞれの関数で読んだ結果です。セルの中の改行が残っているのは、HTML から読んだほうだけです。

text
HTML から読んだ表: [["商品名","価格","入荷日","メモ"],["ノート","1200","2026-11-01","表紙は青\n中は方眼"],["ペン \"極細\"","350","2026-11-05",""],["消しゴム","80","","在庫少"]]
テキストから読んだ表: [["商品名","価格","入荷日","メモ"],["ノート","1200","2026-11-01","表紙は青 中は方眼"],["ペン \"極細\"","350","2026-11-05",""],["消しゴム","80","","在庫少"]]

貼り付けを受け取って表を出すコンポーネント

PasteTable は、入力欄の onPaste で tableFromClipboard を呼び、表が読めたときだけ preventDefault() で入力欄への貼り付けを止めます。1行目を見出しにして、table で表示します。

tsx
import { useState, type ClipboardEvent } from 'react';
import { tableFromClipboard, type Table } from './parseTable';

export function PasteTable() {
  const [table, setTable] = useState<Table | null>(null);
  const [text, setText] = useState('');

  const handlePaste = (e: ClipboardEvent<HTMLTextAreaElement>) => {
    const pasted = tableFromClipboard(e.clipboardData);
    // 表でなければ何もしない。文字はふだんどおり入力欄に入る
    if (!pasted) return;
    e.preventDefault();
    setTable(pasted);
  };

  const [head, ...body] = table?.rows ?? [];
  const width = Math.max(0, ...(table?.rows ?? []).map((row) => row.length));

  return (
    <div>
      <label htmlFor="paste">表をここに貼り付け(Ctrl+V)</label>
      <textarea
        id="paste"
        value={text}
        onChange={(e) => setText(e.target.value)}
        onPaste={handlePaste}
        rows={2}
      />
      <p role="status">
        {table && `${table.rows.length}行×${width}列を貼り付けました(${table.from === 'html' ? 'HTML' : 'テキスト'}から読み取り)`}
      </p>
      {table && (
        <table>
          <thead>
            <tr>
              {Array.from({ length: width }, (_, i) => (
                <th key={i}>{head[i] ?? ''}</th>
              ))}
            </tr>
          </thead>
          <tbody>
            {body.map((row, r) => (
              <tr key={r}>
                {Array.from({ length: width }, (_, i) => (
                  <td key={i}>{row[i] ?? ''}</td>
                ))}
              </tr>
            ))}
          </tbody>
        </table>
      )}
    </div>
  );
}

行によってセルの数が違っても表が崩れないように、いちばん長い行に合わせて width を決め、足りないセルは空にしています。セルの中の改行は、CSS で th, td に white-space: pre-line を付けて、画面でも改行して見せました。

Calc の4行×4列を貼り付けると、表示は次のようになりました。入力欄は空のままです。

text
画面: {"status":"4行×4列を貼り付けました(HTMLから読み取り)","textarea":"","table":[["商品名","価格","入荷日","メモ"],["ノート","1200","2026-11-01","表紙は青\n中は方眼"],["ペン \"極細\"","350","2026-11-05",""],["消しゴム","80","","在庫少"]]}

価格も入荷日も、Calc の画面に出ている文字のまま、文字列として入ります。数として計算に使うときは、取り込んだあとで変換します。

1つのセルやふつうの文字は、入力欄にそのまま入る

tableFromClipboard は、セルが1つだけのときと、タブも改行もない文字のときに null を返します。handlePaste は何もせずに戻るので、MDN の paste イベントの説明にある既定の動きのとおり、文字が入力欄に入ります。

Calc でセル B2 だけをコピーしたときも、HTML は <table> で届き、1行1列の表として読めました。セル1つを表にしても使い道がないので、入力欄に入れています。記録した出力から、説明に使う行だけを抜き出しました。

text
HTML から読んだ表: [["1200"]]
画面: {"status":"4行×4列を貼り付けました(HTMLから読み取り)","textarea":"1200",…}

ふつうの文字は、xclip で text/plain だけをクリップボードに入れて貼り付けました。

text
画面: {"status":"4行×4列を貼り付けました(HTMLから読み取り)","textarea":"こんにちは",…}

どちらも、前に貼り付けた4行×4列の表はそのままで、文字だけが入力欄に入りました(… は、変わらない表の値を省いたところです)。

HTML がなく、タブ区切りの文字だけが届いたときは、tableFromText で表になります。xclip で text/plain だけをクリップボードに入れて貼り付けると、次のようになりました(説明に使う行だけを抜き出しています)。

text
paste イベントの types: ["text/plain"]
画面: {"status":"3行×2列を貼り付けました(テキストから読み取り)","textarea":"","table":[["商品名","価格"],["ノート","1200"],["ペン","350"]]}

tableFromText はタブと改行で分けるだけなので、セルの中の改行やタブは扱えません。Calc の text/plain では、セルの中の改行は空白になって届きました。" も、ペン "極細" のように、セルの文字のまま入っていました。

​Posted by 86