Angular スプレッドシートコンポーネント | ng-hub-ui-spreadsheet

Excel のキーボード操作、矩形選択、Excel と往復できるクリップボード、固定枠、結合セルを備えた、編集できる Angular のスプレッドシート。MIT ライセンス、アクセシブル、有料プランなし。

最終更新 2026/11/15

概要

チームがこのライブラリを探す理由

セルに入力したり貼り付けたりする画面が必要で、グリッドに料金を払いたくない、スクリーンリーダー対応も諦めたくないときは、ng-hub-ui-spreadsheet を使います。

インストール

npm install ng-hub-ui-spreadsheet

ジャンプ

最適な用途

  • 請求書と注文の明細行
  • 価格表と料金表
  • タイムシートとシフト表
  • データの一括修正

について spreadsheet

ng-hub-ui-spreadsheet is a standalone Angular component that renders rows and columns you already hold and reports what the reader did to them. It never writes to your data. It brings in-cell editing with Excel's keyboard, rectangular selection by shift or dragging, a clipboard that writes and reads both flavours so figures survive a journey between locales, frozen rows and columns, merged blocks, and a save state per cell. It carries real grid semantics — role="grid", row and column indices, a roving tab stop — and depends on nothing outside Angular: its grid primitives live in ng-hub-ui-utils rather than @angular/cdk. 数式は列の別名でも座標でも書け、長いシートは縦横どちらもビューポートが覆う範囲だけを描き、全体を本物の .xlsx や CSV に書き出してまた取り込めます。zip と XML はここで書いているので、どれも依存関係を持ち込みません。

機能ガイド

このライブラリにはまだ機能ガイドがドキュメント化されていません。

主な機能

最近の変更

Version 22.13.0 - 11/15/26, 12:00 AM

added: hubSpreadsheetHeader は、編集ボタン付きの名前など、独自のテンプレートで列見出しのタイトルを描画します。内部のボタン、リンク、入力欄は列をドラッグせずに押せ、見出しは幅、固定、全選択チェックボックスを保ちます。

Version 22.12.2 - 11/4/26, 12:00 AM

fixed: 計算で誤差が出た数値も表計算ソフトと同じように表示されます。セル、コピー、エディターで数値を有効数字 15 桁で書くため、3260.4 − 3120.8 は 139.6 と表示されます。保存される値は変わりません。

Version 22.12.1 - 11/4/26, 12:00 AM

fixed: 末尾揃えのリスト列・日付列は、セルとヘッダーにキャレット用の余白を確保するため、キャレットが値の末尾に重なりません。

fixed: リストを開いてもキャレットは変わりません。ネイティブのリストはブラウザーの矢印を隠し、シートの矢印を同じ位置に保ちます。

Version 22.12.0 - 11/4/26, 12:00 AM

added: editCell はコードからセルのエディターを開き、追加されたばかりの行を待ちます。メモを追加するボタンの後、そのまま入力できます。

added: Alt+Enter(Mac では Option+Enter)は入力もできるセルの操作を開きます。Enter は引き続きその入力欄を開きます。

Version 22.11.0 - 11/4/26, 12:00 AM

added: 列の append は、主な値の後ろに短いリストから選ぶ2つ目の値を表示します(数量の単位や値引きの種類)。変更は append.key をキーとする commit として届き、コピー・貼り付け・フィルは両方の部分を扱います。

Version 22.10.0 - 11/4/26, 12:00 AM

added: focusCell はコードからセルにカーソルを置き、追加したばかりの行を待ちます。行を追加するボタンのあと、すぐにその行へ入力できます。

added: fillHandle が有効なとき Ctrl+D(Mac では Cmd+D)で下方向にコピーします。選択範囲の先頭行を下の行へ写し、filled を一度だけ通知します。

added: シートより長い貼り付けは、structure が許す場合 insertRequested で不足行を要求し、行が描画されたあとで全体が反映されます。

added: checkAll は、はい/いいえ列の見出しに全行を一度にチェックするボックスを置きます。行がそろっていないときは中間表示になり、filled を一度だけ通知します。

changed: セルの title はネイティブの title 属性ではなく、シートのツールチップに表示されます。マウスでもキーボードでも見えます。

changed: セルテンプレートを使ってもセル本来の操作は残ります。はい/いいえ列はチェックボックスの横にテンプレートを表示し、リストや日付の列は開くための矢印を保ちます。

fixed: 空の行も、余白だけに縮まず、入力済みの行と同じ高さになります。

fixed: 枠の下の角にあるセルが角の丸みに沿うようになり、カーソルの枠線がはみ出さなくなりました。

Version 22.9.1 - 11/3/26, 12:00 AM

changed: シートのラベルは非推奨の translate パイプではなく hubTranslate を使います。ホスト側の変更はありません。

Version 22.9.0 - 11/3/26, 12:00 AM

added: Alt+Shift と上下の矢印でキーボードから行を移動でき、ドロップと同じく rowMoved で通知され、移動先がライブリージョンで読み上げられます。

fixed: 独自のエディターや開いた行で打ったキーはそれらのものになりました。ピッカーの検索欄に入力でき、矢印はシートのカーソルではなくその中のキャレットを動かします。

fixed: 独自のエディターはシート自身のものと同じく、Escape、Tab、フォーカスが離れたときに閉じます。回答を選ぶ Enter が下のセルまで開くことはなくなりました。確定が必要なエディターのために、コンテキストに draft が加わりました。

fixed: セルが保存できないテキストは、読み手がセルを離れても失われなくなりました。セルが枠と説明付きで保持し、invalidDrafts がホストに伝えます。

Version 22.8.0 - 10/28/26, 12:00 AM

added: 列と同じように、行もドラッグして別の位置へ移動できるようになりました。行にポインターを重ねると先頭側の端にハンドルが、列に重ねるとヘッダーの上にハンドルが表示されます。ドロップは columnMoved と同じ形で、並べ替え済みの状態で rowMoved から通知されます。

changed: 移動の様子が見えるようになりました。コピーがポインターに追従し、通過した行や列が場所を空けるために退き、端に近づくとシートがスクロールします。ボタンを押している間はハンドルが隠れます。

Version 22.7.0 - 10/27/26, 12:00 AM

changed: セルの検証メッセージは、ブラウザーの灰色の title ではなく、ホバー時またはキーボードでセルに移動したときに赤いツールチップで表示されます。

changed: 1 つのセルで Backspace または Delete を押すとセルが空になってエディターが開き、新しい値をすぐに入力できます。複数のセルは引き続き cleared で空になります。

changed: カーソルと選択範囲はシートにフォーカスがある間だけ描画されるため、離れたシートが入力可能に見えることはありません。

added: セル内で開いたフォームフィールドはエラーをツールチップで表示し、行の高さは変わりません。

Version 22.6.0 - 9/30/26, 12:00 AM

added: セルは何が空かを示せます。placeholder はセルが空のとき、ホバーでそのセルに表示されるヒントで、列のものにフォールバックします。

Version 22.5.0 - 9/29/26, 12:00 AM

changed: hubSpreadsheetCellAction が行の関数も受け取れるようになりました。列の一部のセルだけを開くことができ、それらに Enter を残し、ほかはシートに委ねます。

Version 22.4.0 - 9/28/26, 12:00 AM

added: 行がその場で開きます。expansion と expandedRow により、行が数値の背後に持つものを、上に重なるダイアログではなく行そのものの下に描くテンプレートです。

added: 何かを開くセル。テンプレートがそう宣言します。hubSpreadsheetCellAction がセルに Enter を残し、押下は opened で通知されます。

added: 列と行はアウトラインで折りたたまれます。Excel のグループ化と同じです。あるレベルの列または行の並びが 1 つのボタンで折りたたまれ、どのグループが折りたたまれているかはあなた次第です。

Version 22.2.0 - 9/27/26, 12:00 AM

added: 入力ではなく数式で計算されたセルは、隅に小さな fx を持ち、ポインターを合わせている間だけ表示されます。専用のトークン --hub-spreadsheet-formula-bg と --hub-spreadsheet-formula-color を持ちます。

fixed: 座標は数式のときだけ表示されます。ふつうのセルを編集しても文字と数字の枠は描かれず、最初の = を待ちます。

fixed: 座標はシートの枠の外側に描かれます。枠が場所を空けるためにずれ、バッジはその外側に浮かぶので、枠はバッジと表の間に残ります。

fixed: 数式に入れられるものの一覧は枠に追随します。最初の = でシートが動き、一覧はずれた後に置き直され、いまのセルからぶら下がります。

Version 22.1.0 - 9/27/26, 12:00 AM

added: ブロックを複数まとめて。Ctrl を押したクリックは描いていた矩形をしまって別の矩形を始め、Delete はすべてを空にし、selectionRangesChange がすべてを伝えます。コピーはブロックが表になるときだけ、フィルハンドルは複数選んでいる間は出ません。

added: hub-spreadsheet-theme。シートの 65 個のテーマ可能な変数を一度の include で。すべての引数は任意で、渡したものだけが出力されます。

added: 数式は色付きで入力されます。入力中は、関数、列の別名、セル参照、引用符付き文字列がそれぞれの色で描かれ、文法が一目で読めます。

added: セルを指して参照を書き込みます。数式の入力中に他のセルを押すかドラッグすると、指した内容がカーソル位置の数式に挿入されます — 単一なら B3、矩形なら B3:D7 — テキストを確定せずに。

added: セルを開いている間、列の文字と行番号が表示されます。表が少しずれ、その空きにバッジが浮かびます — 各列の上に文字と別名、左端に行番号 — ので、参照を数えずに読み取れます。表示時には短いアニメーションが付きます。

fixed: シートを外からテーマ付けできるようになりました。変数はホスト要素そのものに宣言されていて、それは継承より強いので、:root も囲みのクラスもルート単位のテーマも黙って無視されていました。今は使う場所で読んでいます。既定値は変わりません。

fixed: 数式に入れられるものの一覧が実際に見えるようになりました。以前も存在しましたが、シートのスクロール領域とセルとページの間の overflow:hidden によって切り取られ、最終行では決して表示されませんでした。今はウィンドウに固定され、下に余白がないときはセルの上に開きます。

Version 22.0.0 - 9/27/26, 12:00 AM

added: hub-spreadsheet:セル内編集、完全なキーボードナビゲーション、矩形選択。

added: Excel と双方向で往復できるクリップボード。HTML 形式から生の数値を読み取ります。

added: 固定された行と列。端から数えます。

added: 所有者が宣言する結合ブロック。ナビゲーションと選択では 1 つのセルとして扱われます。

added: 挿入と削除のリクエスト。権限で制御され、別名は再利用されません。

よくある質問

Excel から Angular のグリッドに、数値を壊さずに貼り付けるには?

クリップボードはプレーンテキストだけでなく HTML 形式を読みます。Excel はそこにある属性に生の数値を書きます。プレーンテキストにはコピー元のロケールが表示したものがそのまま入るので、1.234,56 はコピー元によって文字列として、または 1.23 として解釈されます。ng-hub-ui-spreadsheet は両方を読み、生の値を優先します。

無料の Angular スプレッドシートコンポーネントはありますか?

ng-hub-ui-spreadsheet は MIT ライセンスで、有料プランも機能制限もありません。編集、矩形選択、クリップボード、固定枠、結合セルはすべてパッケージに含まれています。多くのグリッドではそうではなく、クリップボードや範囲選択はエンタープライズライセンスの背後にあります。

スクリーンリーダーで使えますか?

はい。本物の role="grid" を描画し、セルごとに aria-colindex、行ごとに aria-rowindex、選択に追従する aria-selected、入力できないセルには aria-readonly、セルの保存中は aria-busy を付けます。タブストップは 1 つだけ移動し、矢印キーで操作できます。

@angular/cdk は必要ですか?

いいえ。二次元のナビゲーション、矩形選択、キーボードマップは ng-hub-ui-utils にあるため、スプレッドシートをインストールしても Angular 以外は何も入りません。