ONLYOFFICEのAPI更新情報：2025年12月の新機能
年末は、ONLYOFFICE APIへの大規模なアップデートの波をもたらします。ONLYOFFICE Docsのバージョン9.2が登場し、これに伴い、Office JavaScript APIの大幅な拡張、プラグインとマクロの新しい機能、および重要なドキュメントの改善がもたらされます。
ONLYOFFICEの上に構築する開発者にとって、これらのアップデートは、ドキュメント要素に対するより細かい制御、強化されたフォーム操作、より優れた統合ツールを提供します。ドキュメントの作成を自動化している場合でも、複雑なプラグインを構築している場合でも、DocSpaceを統合している場合でも、このリリースには何かがあります。技術的な詳細に飛び込んでみましょう。
Office JavaScript API：拡張された制御
Office JavaScript APIは、スイート全体でかなりの数の新しいメソッドを受け取りました。
強化されたフォーム操作
プログラム的にフォームを操作することが、より強力になりました。フォーム要素を正確に処理するための新しいメソッドを導入しました。
CheckBoxFormメソッド。Form APIとText Document APIの両方でチェックボックスのラベルを動的に管理できるようになりました：
ApiCheckBoxForm/GetLabelApiCheckBoxForm/SetLabel
ライフサイクルとID管理。フォームオブジェクトとの対話方法を標準化しました。Form APIとText Document APIの両方で、ほぼすべてのフォームタイプに新しいDeleteおよびGetInternalIdメソッドが追加されました。これには以下が含まれます：
ApiCheckBoxFormApiComboBoxFormApiComplexFormApiDateFormApiFormBaseApiPictureFormApiTextForm
この細かい制御により、動的フォームを管理する際にクリーンなコードが可能になり、要素を削除したり、内部IDでプログラム的に参照したりできます。
プレゼンテーションとスプレッドシートAPIの段落メソッド
このアップデートでの最大の追加の1つは、ApiParagraphメソッドのプレゼンテーションとスプレッドシートAPIへの拡張です。以前は、深い段落操作は主にText Document APIの領域でした。現在、スライドとシート内で直接リッチテキストの書式設定と構造の変更を適用できます。
- 構造：
InsertParagraph、Push、Last、GetLastRunWithText。 - 書式設定：
SetBold、SetItalic、SetUnderline、SetStrikeout、SetDoubleStrikeout、SetCaps、SetSmallCaps。 - スタイリング：
SetColor、SetFontSize、SetFontFamily、SetSpacing。 - プロパティ：
GetFontNames、SetTextPr。 - データ：
ToJSON、GetInternalId。
これにより、エディター全体で開発者エクスペリエンスが統一され、ドキュメントでレポートを生成する場合でも、スライドデッキのテキストボックスを書式設定する場合でも、コードがより再利用可能になります。
単位変換ヘルパー
Office Open XMLでの測定の処理には、英語メートル単位（EMU）と標準単位の間の変換が必要になることがよくあります。これを簡素化するために、プレゼンテーション、スプレッドシート、およびテキストドキュメントAPIにヘルパーメソッドを追加しました：
Api/EmusToMillimetersApi/MillimetersToEmus
ナビゲーションとコンテンツアクセス
Text Document APIについては、タイピングや編集を自動化するマクロに重要なカーソルの移動とコンテンツの挿入を改善しました：
ApiDocument/MoveCursorDown、MoveCursorLeft、MoveCursorRight、MoveCursorUpApiDocument/EnterTextApiDocument/InsertParagraphBreak
さらに、プレゼンテーションとスプレッドシート内のコンテンツへのアクセスは、GetAllParagraphs、GetCurrentParagraph、GetTextなどの新しいApiDocumentContentメソッドで簡単になりました。
Docs用プラグイン：より良い開発者エクスペリエンス
プラグインの構築は、コードだけでなく、開発者エクスペリエンスと最終的なユーザーインターフェースに関するものです。
デバッグチュートリアル
Webとデスクトップエディターの両方のチュートリアルに新しい「デバッグ」サブセクションを追加しました。これらのガイドは、プラグインをより速く、より効果的にトラブルシューティングするのに役立ちます。
UIの一貫性
- アイコン：ベストプラクティスでプラグインのアイコンページを更新しました。アイコンを追加することは、使いやすさを大幅に向上させ、インターフェースを直感的にする小さなステップです。
- テーマ設定：新しい「テーマをカスタマイズする方法」ページでは、プラグインが現在のエディターテーマを検出し、それに応じて反応する方法を説明しています。これにより、ユーザーがダークモードまたはライトモードにいるかどうかにかかわらず、プラグインがネイティブに見えることが保証されます。
ローカライゼーションのトラブルシューティング
グローバルな視聴者向けにプラグインを翻訳する際の一般的な問題を解決するために、「ローカライゼーション」ページにトラブルシューティングセクションを追加しました。
DocSpace SDKアップデート
ルームベースのコラボレーションプラットフォームDocSpaceを統合する開発者向けに、JavaScript SDKが更新されました。ドキュメント構造がリファクタリングされ、DocSpaceから直接ファイルを使用して自動的に生成されるようになり、読んでいるリファレンスが常に実際のコードと同期していることが保証されます。
APIドキュメントサイトの改善
APIドキュメントサイトを、より速く、より使いやすくするために常に改善しています。
- エンジン：Docusaurusをバージョン3.9.2に更新しました。
- システムテーマモード：ドキュメントサイトは、システムテーマ検出をサポートするようになり、ダークモードまたはライトモードのOS設定を尊重します。
- 使いやすさとローカライゼーション：ドキュメントのスタートページを再設計し、完全に翻訳されたデスクトップエディターセクションを含む中国語ドキュメントを改善しました。
ONLYOFFICEの無料アカウントを登録する
オンラインでドキュメント、スプレッドシート、スライド、フォーム、PDFファイルの閲覧、編集、共同作業
