GetTextDirection

Google Apps Script (GAS) を用いたスプレッドシートの自動化において、複数セルのテキスト方向（左から右、右から左）を効率的に管理することは、特に多言語コンテンツや複雑なレイアウトを扱う場合に非常に重要です。個々のセルに対してテキスト方向を取得するgetTextDirection()も便利ですが、広範囲のセルを扱う際には非効率的になります。

本記事では、スプレッドシートの指定範囲からセルのテキスト方向を二次元配列で一括取得できるgetTextDirections()メソッドを徹底解説します。基本的な使い方から、getTextDirection()との違い、GoogleのLanguageAppを使った言語判定によるテキスト方向の動的制御、そして**CacheServiceを活用したパフォーマンス最適化**、エラーハンドリングといった実践的な応用例までを、具体的なコード例を交えて紹介します。

Google Apps Script (GAS) を用いてスプレッドシートを操作する際、特に多言語対応や複雑なレイアウトを扱う場合には、セルのテキスト方向を正確に取得・設定することが重要になります。getTextDirection()メソッドは、このテキスト方向をプログラムで制御するための基本的ながら強力な機能です。

本記事では、GASのRange.getTextDirection()メソッドを徹底解説します。単一セルのテキスト方向取得の基本から、複数セルの方向を一括で扱うgetTextDirections()との違い、さらにはGoogleのLanguageAppを使った言語判定によるテキスト方向の動的制御、そしてパフォーマンス最適化のヒントまで、具体的なコード例を交えて分かりやすく紹介します。