【GASスプレッドシート】getVerticalAlignment()で垂直配置を効率的に取得・SEO最適化

/**
 * アクティブなシートのA1セルの垂直配置を取得し、ログに出力する関数。
 * 返り値は "top", "middle", "bottom" のいずれかです。
 */
function getSingleCellVerticalAlignment() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const cell = sheet.getRange("A1");           // A1セルをRangeオブジェクトとして取得
  const verticalAlignment = cell.getVerticalAlignment(); // A1セルの垂直配置を取得
  
  // 取得した垂直配置をログに出力
  Logger.log(`A1セルの垂直配置: "${verticalAlignment}"`);
}

/**
 * 複数範囲のセルの垂直配置を一括取得し、ログに出力する関数。
 * getRange("A1:C3") の場合、[["top", "middle", "bottom"], ["bottom", ...]] の形式で返されます。
 */
function getRangeVerticalAlignments() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3"); // 対象範囲をA1:C3に設定
  const alignments = range.getVerticalAlignments(); // 範囲内の全セルの垂直配置を一括取得
  
  Logger.log(`A1:C3範囲の垂直配置:\n${JSON.stringify(alignments, null, 2)}`);

  // 各セルのアドレスと共に垂直配置を出力する例
  alignments.forEach((rowAlignments, rowIndex) => {
    rowAlignments.forEach((alignment, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress}: 垂直配置 "${alignment}"`);
    });
  });
}

/**
 * A1からC3の範囲のすべてのセルの垂直配置を「中央揃え」に設定する関数。
 */
function setRangeVerticalAlignmentExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3");
  range.setVerticalAlignment("middle"); // 全セルを中央揃えに設定
  Logger.log(`A1:C3範囲の垂直配置を「中央揃え」に設定しました。`);
}

/**
 * A1からC3範囲の各セルに異なる垂直配置を一括で設定する関数。
 */
function setMultipleVerticalAlignmentsExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3");
  // 設定したい垂直配置を二次元配列で定義
  const alignments = [
    ["top", "middle", "bottom"],   // A1, B1, C1
    ["bottom", "middle", "top"],   // A2, B2, C2
    ["middle", "top", "bottom"]    // A3, B3, C3
  ];
  range.setVerticalAlignments(alignments); // 垂直配置を一括設定
  Logger.log(`A1:C3範囲の各セルに異なる垂直配置を設定しました。`);
}

/**
 * セルの内容のテキスト長に応じて、垂直配置を自動調整する関数。
 * テキスト長が50文字を超えるセルは「上寄せ」、それ以外は「中央揃え」に設定します。
 */
function autoAdjustVerticalAlignmentBasedOnContent() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const values = dataRange.getValues();   // 全範囲のセル値を取得（テキスト長取得用）
  const newAlignments = [];               // 新しい垂直配置を格納する二次元配列

  values.forEach(rowValues => {
    const rowAlignments = [];
    rowValues.forEach(cellValue => {
      // セル値のテキスト長に基づいて垂直配置を決定
      if (String(cellValue).length > 50) { // 例: 50文字を超える場合
        rowAlignments.push("top");       // 上寄せ
      } else {
        rowAlignments.push("middle");    // 中央揃え
      }
    });
    newAlignments.push(rowAlignments);
  });
  
  // 生成した新しい垂直配置を一括でシートに適用
  dataRange.setVerticalAlignments(newAlignments);
  Logger.log("セルの内容に応じて垂直配置を自動調整しました。");
}