--- title: "Luckysheetとは：保守終了後の導入コードとデータ形式、Univerへ移すときの判断【2026年11月】" url: "https://www.issoh.co.jp/tech/details/19194/" published: 2026-11-02 updated: 2026-11-02 categories: ["開発"] publisher: "株式会社一創" --- # Luckysheetとは：保守終了後の導入コードとデータ形式、Univerへ移すときの判断【2026年11月】 Luckysheetは、Excelのような表計算画面をブラウザだけで動かすオープンソースのJavaScriptライブラリです。ただし2026年11月2日にnpm registryで確認した最新版は、2021年1月19日公開の2.1.13のままでした。GitHubリポジトリもアーカイブされ、READMEの冒頭には保守を終えたことと後継のUniverを使うよう書かれています。この記事では、Luckysheetの機能と現在の配布状況、既存の画面を動かし続けるための導入コードと保存処理、Univerへデータを移す変換コード、Handsontableとの選び分けまでを扱います。Luckysheetで作った画面を抱えている開発者と、Web上の表計算ライブラリを選んでいる担当者に向けた内容です。 ## まとめ：Luckysheetを新規採用しない理由と既存画面を移す時期の判断基準 新しい案件でLuckysheetを選ぶ理由は、もうありません。5年近く更新が無く、依存しているjQuery 2.2.4には既知のXSS勧告が4件残っています。表示言語に日本語も用意されていないため、利用者向けの画面では文言の差し替えから始めることになります。 既存の画面は、社内ネットワークの中だけで使い、貼り付けや入力値を信頼できる場合に限って当面は残せます。外部の利用者が触る画面、または改修の予定がある画面は、後継のUniverへ移す計画を立ててください。複数シートの表計算が要件ならUniver、Excelと同じ手つきの大量入力が主ならHandsontableが移行先の第一候補です。 ## Luckysheetの定義とExcel風Web表計算の機能群・2021年で停止した配布状況 Luckysheetのリポジトリは現在GitHubのdream-num組織にあり、npmの公開者名はmengshukejiです。採用を考える前に、何ができて、どこで止まっているかを押さえておきます。 ### ブラウザだけで動く表計算としての立ち位置とHandsontableとの設計の違い [GitHubのREADME](https://github.com/dream-num/Luckysheet)によると、Luckysheetは純粋なフロントエンドで動く表計算です。書式設定、条件付き書式、セル結合、データ検証、数式と関数、フィルターと並べ替え、ピボットテーブル、グラフ、コメント、共同編集まで1つのライブラリに入っていました。シート見出しやツールバーを含めた「Excelの画面そのもの」を描く点が特徴です。 同じ「Excel風の表」でも、[Handsontable](https://www.issoh.co.jp/tech/details/19056/)は1枚の表をアプリの画面に部品として埋め込む設計です。ツールバーやシート切り替えは持たず、列の型や入力チェックを開発者がコードで決めます。Luckysheetは利用者に表計算ソフトを渡す道具、Handsontableは業務画面の入力欄を表にする道具、と分けて考えると選び分けを誤りません。 ### npm最終版2.1.13とGitHubアーカイブ化で確定した保守終了の時点 [npm registry](https://registry.npmjs.org/luckysheet)の記録では、luckysheetパッケージは2020年9月14日に初公開され、最後の版は2021年1月19日の2.1.13です。GitHubリポジトリは読み取り専用のアーカイブ状態で、説明文は「Luckysheet upgraded to Univer」に変わっていました。スター数は2026年11月2日時点で16,630件あり、検索で今も見つかるのはこの蓄積のためです。 [公式ドキュメント](https://dream-num.github.io/LuckysheetDocs/)も残っていますが、各ページの冒頭に「Luckysheet is no longer maintained, please use Univer instead!」と表示されます。Excelファイルの入出力を担う[Luckyexcel](https://github.com/dream-num/Luckyexcel)も同じくアーカイブ済みで、npmの最終版は2021年1月4日の1.0.1です。不具合を見つけても、本家に修正が入ることはありません。 ### 依存するjQuery 2.2.4に残るXSS勧告4件と配布ファイル約3MBの重さ 2.1.13のpackage.jsonは、実行時の依存に`jquery ^2.2.4`を指定しています。jQuery 2系の最終版は2.2.4なので、npmで入れると必ずこの版になります。脆弱性データベースのOSVで照会すると、jQuery 2.2.4には[GHSA-gxr4-xjj5-5px2](https://osv.dev/vulnerability/GHSA-gxr4-xjj5-5px2)（CVE-2020-11022）を含むXSSの勧告が4件登録されていました。Luckysheet本体の勧告は0件でしたが、更新が止まったライブラリは調べる人もいないため、0件を安全の根拠にはできません。 配布ファイルの大きさも見ておきます。jsDelivrから取得した`dist/luckysheet.umd.js`は3,050,103バイトで、gzip圧縮しても約621KBでした。同時に読む`plugin.js`は約171KBです。Handsontable 18.1.2の本体が圧縮後で約319KBなので、その2倍を超える量を表の画面を開くたびに読み込むことになります。 ## 既存案件でLuckysheetを動かす導入コードとセルデータの保存処理の要点 すでにLuckysheetで動いている画面を保守する場合や、移行前に挙動を確かめたい場合のために、最小の構成と保存処理を示します。新規案件での利用は勧めません。 ### CDNの版を2.1.13に固定して表を出す最小構成とlang設定の制約 READMEの導入例はCDNから`@latest`で読み込む形ですが、保守する画面では版を固定し、できれば自社のサーバーに置いて配信してください。外部CDNの障害や配信停止で、画面が開かなくなる事態を避けるためです。 ```
``` [全体設定のページ](https://dream-num.github.io/LuckysheetDocs/guide/config.html)では、`lang`が受け付けるのは簡体字中国語・英語・繁体字中国語・スペイン語の4つです。日本語の画面にするには、言語ファイルを自前で書き換えるしかありません。[シート設定のページ](https://dream-num.github.io/LuckysheetDocs/guide/sheet.html)の注意書きどおり、`config`を`null`にすると初期化で失敗します。 ### celldataとdataの二つの形式とtransToCellDataで保存用に戻す手順 Luckysheetのセルには、2つの持ち方があります。`celldata`は値の入ったセルだけを`{r, c, v}`で並べる1次元配列で、初期化と保存に使います。`data`は全セルを`data[行][列]`で持つ2次元配列で、空のセルは`null`です。初期化の時点で`celldata`は`data`に変換され、以後の編集は`data`側に反映されます。 セルの中身は[セル属性の表](https://dream-num.github.io/LuckysheetDocs/guide/cell.html)で定義されています。`v`が元の値、`m`が表示用の文字列、`f`が`=MAX(A7:A9)`のような数式、`ct`が書式です。背景色は`bg`、太字は`bl`のように、書式も1セルずつ短い名前で持ちます。 保存するときは、`luckysheet.getAllSheets()`で全シートを取り出し、`transToCellData()`で`data`を`celldata`に戻してから送ります。2次元配列のまま保存すると、1,000行×26列なら空セルの`null`だけで2万6,000要素を抱えることになるためです。 ### cellUpdatedフックで変更セルを受け取りサーバーへ差分を送る実装 ブック全体を毎回送る方式では、2人が同じブックを開いたときに後から保存した人の内容で上書きされます。変更したセルだけを送るなら、`hook`の`cellUpdated`を使います。 ``` // luckysheet.create のオプションに追加する：変更セルだけを集めて送る const pending = new Map(); hook: { cellUpdated(r, c, oldValue, newValue) { const value = newValue && typeof newValue === 'object' ? newValue.v : newValue; pending.set(`${r}:${c}`, { r, c, value, formula: newValue?.f ?? null }); }, }, // 保存ボタンで1回にまとめて送る async function flush() { if (pending.size === 0) return; const cells = [...pending.values()]; pending.clear(); await fetch('/api/books/orders/cells', { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(cells), }); } ``` `cellUpdated`の引数は行番号・列番号・変更前のセル・変更後のセル・再描画の有無の5つです。行の挿入や削除は`cellUpdated`では届かず、すべての操作を受ける`updated`フックで扱います。行を挿入すると、送信済みの行番号がずれる点に注意してください。行番号ではなく行ごとのIDで更新する設計にしておくと、移行先のライブラリでも同じAPIが使えます。 ## 後継Univerと派生FortuneSheetへ移すときのデータ変換と機能差の確認 移行先の候補は、開発元が後継と位置づける[Univer](https://github.com/dream-num/univer)と、Luckysheetから派生したFortuneSheetの2つです。どちらも、Luckysheetのコードを差し替えるだけでは動きません。 ### Univer 1.3.1の導入コードと日本語ロケールja-JPを指定する設定 Univerの最新版は、2026年10月30日公開の1.3.1です（npm registryで確認）。[公式のInstallationページ](https://docs.univer.ai/guides/sheets/getting-started/installation)では、まとめて機能を読み込むプリセット方式が案内されています。例は英語ですが、`@univerjs/preset-sheets-core` 1.3.1にはja-JPの言語ファイルが同梱されており、`LocaleType.JA_JP`を指定すれば日本語の画面になります。 ``` npm install @univerjs/presets @univerjs/preset-sheets-core // main.js：Univer 1.3 系で日本語の表計算を表示する（index.html に
） import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'; import UniverPresetSheetsCoreJaJP from '@univerjs/preset-sheets-core/locales/ja-JP'; import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'; import '@univerjs/preset-sheets-core/lib/index.css'; const { univerAPI } = createUniver({ locale: LocaleType.JA_JP, locales: { [LocaleType.JA_JP]: mergeLocales(UniverPresetSheetsCoreJaJP), }, presets: [UniverSheetsCorePreset({ container: 'app' })], }); univerAPI.createWorkbook({}); ``` LuckysheetがjQueryと`window.luckysheet`に頼っていたのに対し、Univerはnpmで入れてバンドラで組み込む前提です。CDNの`