セルコメント

v1.4.0 から、任意のセルにコメント（Excel の「メモ/ノート」）を添付できます。コメントの付いたセルには赤い角マーカーが表示され、ホバーでバブルが現れます。コメントは単一作成者のメモで — スレッド返信は意図的に対象外です。

Note: コメントの作成は Pro 機能です。読み取り（getComment・getComments・hasComment）は Lite で動作するため、Pro で作成した — または xlsx から読み取った — コメントは無償版でも表示されます。

コメントの設定

1 セルにつき 1 コメントです。ワークシート上で行・列指定、またはセルハンドル経由で設定します。

import { createReogrid } from '@reogrid/pro'

const grid = createReogrid({ workspace: '#app' })
const ws = grid.worksheet

// 行・列指定 — コメントの数値 id を返す
ws.setComment(0, 2, '税抜の単価です。', { author: '経理' })

// セルハンドル経由
ws.cell('B2').setComment('4 個以上で数量割引が適用されます。', { author: 'QA' })

同じセルで再度 setComment を呼ぶと既存のメモが置き換わります。

SetCommentOptions

コメントの読み取り（Lite で読み取り可）

ws.getComment(0, 2)   // CellComment | null
ws.hasComment(0, 2)   // boolean
ws.getComments()      // シート上の readonly CellComment[]
ws.cell('B2').getComment()

CellComment は { id, row, col, text, author?, visible? } です。

更新と削除

ws.setCommentVisible(0, 2, true)  // 常時表示フラグを切り替え
ws.removeComment(0, 2)            // 1 つのコメントを削除（削除できたら true）
ws.clearComments()                // シート上の全コメントを削除

表示

コメントの付いた各セルには右上に小さな赤い三角が描画され、セルにホバーするとバブルにコメント文が表示されます。visible フラグは将来の常時表示ボックスのために I/O を通じて保持されますが、v1 では常にマーカー＋ホバーの挙動になります。

永続化：xlsx は読み取り専用、JSON は往復

• xlsx: コメントは .xlsx から読み取られます（インポートしたファイルのメモは表示されます）が、xlsx への書き戻し（VML）は先送りです — 新規作成したコメントは現時点では xlsx エクスポートに含まれません。
• ReoGrid JSON: コメントは ReoGrid JSON で完全に往復します。アプリで作成したコメントを永続化するには JSON を使ってください。

関連項目

• セルツールチップ — ホバー駆動の動的ヒント（保存されるコメントとは別物）。
• セルデータ — 基になるセル値の読み書き。
• ReoGrid JSON — コメントをロスレスに保持する形式。