プラットフォームと Mac UI

スプレッドシートのプラットフォームは ui.platform で選択します。ui.profile とは独立しており、プロファイルが機能の範囲を選び、プラットフォームが固有の操作やリボンの配置を選びます。

値	動作
default	既定のスプレッドシート UI を使います。platform を省略した場合の既定値です。
mac	Mac のリボンと操作方法を明示的に選びます。
auto	ブラウザーのプラットフォームから解決します。iPad と iPhone のユーザーエージェント、およびタッチ対応の MacIntel は default にフォールバックします。

マウント前に解決結果が必要な場合は、リゾルバーを使います。

import {
  resolveSpreadsheetPlatform,
  Spreadsheet,
  type SpreadsheetPlatform,
} from '@libraz/formulon-cell'

const requested: SpreadsheetPlatform = 'auto'
const resolved = resolveSpreadsheetPlatform(requested)
const instance = await Spreadsheet.mount(host, {
  ui: { profile: 'excel365', platform: requested },
})

console.log(resolved) // 'mac' または 'default'

ui.platform は選択済みの ui.profile を変更しません。たとえば { profile: 'embedded', platform: 'mac' } は埋め込み用の表示を保ちながら、Mac のプラットフォーム動作を選びます。マウント後に両方を変更することもできます。

instance.setUi({ profile: 'excel365', platform: 'mac', theme: 'paper' })

setUi() はワークブックを置き換えません。省略した項目は既定値に戻るため、維持したい UI 設定もまとめて渡してください。Mac から別のプラットフォームへ変更すると、開いている数式パレットを閉じ、保留中の下書きを破棄します。トップレベルのオプションとの優先順位は オプション を参照してください。

シートのジオメトリとレンダリングスケール

プラットフォームはグリッドのサイズも決めます。グリッドは、シートのズームに掛け合わせる画面スケールで配置されます。default は 1、mac は 0.75（1 ポイントが画面の 1 ピクセル）です。列幅と行の高さは画面ピクセルの整数に丸められ、行の高さは最大 409 pt、行見出しの列の幅は default で 32 px、mac で 26 px です。セルエディター、グラフ、画像、図形も同じスケールで配置されます。--fc-cell-text-size はセルの文字サイズを決め、既定値は --fc-text-cell です。テーマ を参照してください。

マウントが作成するワークブックはプラットフォームに従います。Mac のワークブックはエンジンの Mac プロファイル（フォント、既定の行の高さ、基本の列幅）から作られ、default のワークブックはロケールのフォントと Windows の既定の行の高さを明示します。同じワークブックはホストからも WorkbookHandle.createDefault({ locale, platform }) で作れます。platform は default か mac です。渡したワークブックや読み込んだワークブックは、ファイルに保存されたサイズを保ちます。マウントはそのワークブックにプラットフォームの列幅モデルを適用します。Mac の列幅は Mac の数字幅の規則に従うため、同じ保存値でも 2 つのプラットフォームでピクセル数が異なることがあります。

高さを明示していない行は、その行で最も大きいフォントサイズに合わせて高くなります。大きいフォントが切れることはなく、小さいフォントで余白が残ることもありません。この高さはワークブック側の変更を含むフォントの変更に追従し、レイアウト、描画、ヒットテストに使われます。ファイルに保存された高さやユーザーが設定した高さはそのまま保たれます。

プラットフォームが変わると、setUi() は行の高さと列幅を読み直し、Undo 履歴を消去します。記録済みのサイズが以前のプラットフォームで計算された値だからです。テーマだけの変更ではサイズも履歴も保たれます。

Mac リボン

Mac のプラットフォームには、専用のリボンタブ、ショートカット、ダイアログがあります。ホームタブはデスクトップの Mac 版と同じ配置で、切り取り、コピー、書式のコピー/貼り付けはアイコンとテキストの行、挿入、削除、書式は大きなタイルです。セルのコンテキストメニューも Mac のメニューと文言で描画されます。Mac のタブ構成、mac. で始まるコマンド ID、独立したツールバー向けの excel365Mac のリボンモデルは リボンツールバー を参照してください。

組み込みの Mac リボンは ui.platform: 'mac' で使えます。描画タブには黒と赤のペン、鉛筆、蛍光ペン、消しゴム、トラックパッドの操作があります。インクはマウント中のセッション用イラスト層に保存され、1 ストロークは最大 2,000 点です。ワークブックのデータには書き込まれず、.xlsx に保存されません。ストロークを確定する前に、現在のポリシーで対象セルが認可されます。

ショートカット機能が有効な場合、グリッドでは次の Mac 用キー操作を使えます。

ショートカット	操作
Control+U	アクティブセルの既存の内容を編集します。
Command+Control+V	対応する機能が有効な場合、形式を選択して貼り付けを開きます。
Option+Left / Option+Right	前または次のシートへ移動します。

関数の引数パレット

Mac の関数の引数パレットはモーダルではありません。開くとインライン編集または数式バーの下書きを一時停止し、キャンセルで下書きの文字列、フォーカス、キャレットまたは選択範囲を復元します。複合数式の関数呼び出し内にキャレットがある場合も同じです。引数を編集すると、周囲の数式を保ったまま対象の関数呼び出しだけが変更されます。ピッカーは現在のワークブックから関数カタログを読み、カテゴリ別に表示します。「最近使った関数」には、マウント中のスプレッドシートで挿入に成功した関数を記録します。

ホスト UI から開くには openFunctionArguments(seedName?, { category }) を使います。seedName が関数名の場合は category を無視します。利用できるカテゴリは all、recent、logical、lookup、text、datetime、math、financial、dynamicArray、statistical、engineering、information、database、compatibility、cube、web です。

getFunctionArgumentHelp には関数の正規名、0 始まりの引数インデックス、現在のロケールが渡されます。label を省略するとカタログの引数ラベルを使います。説明と参照リンクはホスト側のプロバイダーから取得します。パレットは引数インデックス 0 の戻り値からヘルプリンクを読みます。オブジェクト内のプロパティの順序は関係ありません。参照 URL は許可されたスキーム（http:、https:、mailto:、tel:）を使ってください。相対パスはリンクとして表示されません。

import { Spreadsheet, type FunctionArgumentHelpProvider } from '@libraz/formulon-cell'

const getFunctionArgumentHelp: FunctionArgumentHelpProvider = (
  functionName,
  argumentIndex,
  locale,
) => {
  if (functionName.toUpperCase() !== 'SUM' || argumentIndex !== 0) return null
  const japanese = locale.toLowerCase().startsWith('ja')
  return {
    url: japanese
      ? 'https://formulon.libraz.net/ja/workbook/formula-engine'
      : 'https://formulon.libraz.net/workbook/formula-engine',
    label: japanese ? '数値' : 'numbers',
    description: japanese ? '加算する値または範囲です。' : 'The values or range to add.',
  }
}

const instance = await Spreadsheet.mount(host, {
  ui: { profile: 'excel365', platform: 'mac' },
  getFunctionArgumentHelp,
})

React と Vue のアダプターも FunctionArgumentHelp と FunctionArgumentHelpProvider をエクスポートし、コールバックをコアのマウントへ渡します。Vue の例では、コールバックをコンポーネントのプロパティとして受け取ります。

React

import { Spreadsheet } from '@libraz/formulon-cell-react'

<Spreadsheet
  ui={{ profile: 'excel365', platform: 'mac' }}
  getFunctionArgumentHelp={getFunctionArgumentHelp}
/>

Vue

<script setup lang="ts">
import { Spreadsheet } from '@libraz/formulon-cell-vue'
import type { FunctionArgumentHelpProvider } from '@libraz/formulon-cell-vue'

defineProps<{ getFunctionArgumentHelp: FunctionArgumentHelpProvider }>()
</script>

<template>
  <Spreadsheet
    :ui="{ profile: 'excel365', platform: 'mac' }"
    :get-function-argument-help="getFunctionArgumentHelp"
  />
</template>

Mac リボンのダイアログ

これらのダイアログは Mac リボンから開きます。ホストから開く場合は、表のコマンド ID を ToolbarInstance.applyCommand(id) に渡します。リボンツールバー を参照してください。ゴール シーク、統合、小計は、ワークブックを変更する前にインスタンスのポリシーを確認します。

リボンの経路	コマンド ID	対応範囲と上限
データ → What-If 分析 → ゴール シーク	mac.data.goalSeek	最大 100 回の反復で解を求めます。
データ → What-If 分析 → データ テーブル	mac.data.dataTable	行と列の入力セルを指定します。エンジンがデータ テーブルに対応している必要があります。結果は読み取り専用の {=TABLE()} セルで、結果ブロックへの編集は拒否されます。openDataTableDialog(instance) でも同じダイアログを開けます。
データ → 統合	mac.data.consolidate	sum、average、count、min、max に対応し、統合するソース範囲は合計 100,000 セルまでです。
データ → 小計	mac.data.subtotal	アクティブシートのみです。入力は 100,000 行、出力は 100,000 セル、グループは 1,000 個までです。エンジンの SUBTOTAL 対応が必要で、処理できないオブジェクトや空きのない出力領域は拒否されます。
挿入 → スパークライン	mac.insert.sparkline	矩形のソース範囲、1 セルの出力先、line、column、win-loss に対応します。
挿入 → スライサー	mac.insert.slicer	既存のワークブックテーブルと、そのテーブルの列が必要です。
校閲 → ブック統計	mac.review.stats	シート、入力済みセル、数式、数値、文字列、ブール値、エラー、テーブル、コメント、ハイパーリンク、使用行、使用列を数え、開くたびに再集計します。

小計などの Mac データ操作もポリシーの対象で、Undo / Redo に記録されます。ホストのポリシー、オーバーレイ、ヘルパーは オプション、API 一覧、モーダルとダイアログ、埋め込み を参照してください。

関連ページ

• オプション — プロファイル、プラットフォーム、機能、ポリシーの解決。
• リボンツールバー — リボンのマウント、タブ構成、コマンドの実行。
• API 一覧 — リゾルバーの型とホストヘルパー。
• React / Vue アダプター — アダプターのプロパティとイベント境界。
• フックとコンポーザブル — ホストパネルでの複数範囲の状態。
• デモ — ヘッダーで既定、Mac、自動を切り替える例。