セルの自動マージ

Spread.Sheetsでは、自動マージがサポートされます。これにより、重複テキストが含まれた隣接するセルを自動的にマージされるように設定できます。自動マージによってデータが失われることはありません。

自動マージのメリット

自動マージ機能は、次の場合に役に立ちます。

大きなデータセット内のグループの見やすさを実現できます。
データを失うことなく、同一のセルを結合します。
冗長性（テキストの繰り返し）を除いて、ワークシートの複雑さを取り除きます。
重複するセルを手動で確認して1つずつ結合する必要がなくなるため、時間と労力を節約します。

使用例

ワークシートでデータを分析する際、データ表示を強化し、構造を改善するために、同一のテキストを含む複数のセルを結合することができます。

たとえば、販売レポートを生成する場合、一致する州名または都市名を自動的に結合することで外観がすっきりし、情報を失うことなく結合したセルでデータが保持された状態にできます。

次の図は、自動マージ操作がワークシートで国、州、都市の名前をどのように結合するかを示します。

自動マージの処理方法

自動マージ機能は、同一のテキストを含む連続したセルを自動的にマージし、マージされたセルのテキスト位置を調整します。

本機能は、結合させるセルが指定範囲の一部でない場合に動作します。Spread.Sheetsで作業する際、範囲、行、列およびワークシート全体の指定範囲に自動マージ機能を適用するには、autoMerge() メソッドを使用できます。セルを、行方向、列方向、および行と列の両方方向で結合できます。

Spread.Sheetsで自動マージを使用する際、次の2つのモードがサポートされます。

自由モード - 同じ値を持つセルが隣接するセルと自動的にマージされます。
制御モード - 同じ値を持つセルは、前の行または列の該当するセルがマージされている場合のみ、隣接するセルとマージされます。

自動マージと範囲指定したマージ

ワークシートの「セルの自動マージ」と「範囲指定したマージ」の実行の基本的な違いは次のとおりです。

Spread.Sheetsで自動マージ機能を使用する場合、マージ操作が実行された後でもセルを移動および編集できます。一方で、セル範囲を指定してマージする場合、セルの値を変更すると、マージされたセルが自動的に調整されます。
ユーザーがワークシートをスクロールすると、マージされたセル範囲のテキストは表示されたまま（固定表示）になります。通常のマージされたセル範囲とは異なり、自動マージされたセルは同じ値を表示します。

注意: 自動マージ機能には、次の制限事項があります。

スプレッドシートで次の操作を実行すると、自動マージ範囲が影響を受けます。
- 行または列の追加
- 行または列の削除
- 行数または列数の設定
savePDF（）メソッドを使用してPDFファイルの印刷または保存する際、結合されたすべてのセルは、自動的に通常のセル範囲として処理されます。
コピーまたは移動操作は自動マージ範囲に影響せず、自動的にマージされたセルを通常のマージ範囲として処理されません。

コードの使用

次のコードは、autoMerge()メソッドを使用して、同一の国、州、都市の名前を含むセルを自動マージする方法を示します。

JavaScript	コードのコピー
<script> var data = [ { "Country": "Canada", "State": "Ontario", "City": "Ottawa", "Product": "Kraft Grated Parmesan Cheese" }, { "Country": "Canada", "State": "Ontario", "City": "Belleville", "Product": "KIND Bars Almond & Coconut Gluten Free" }, { "Country": "Canada", "State": "Ontario", "City": "Alliston", "Product": "Kraft Grated Parmesan Cheese" }, { "Country": "Canada", "State": "Saskatchewan", "City": "Prince Albert", "Product": "Smartfood Popcorn" }, { "Country": "Canada", "State": "Alberta", "City": "Red Deer", "Product": "Smartfood Popcorn" }, { "Country": "Canada", "State": "Alberta", "City": "Calgary", "Product": "Planters Deluxe Whole Cashew" }, { "Country": "Canada", "State": "Alberta", "City": "Calgary", "Product": "Kraft Grated Parmesan Cheese" }, { "Country": "Canada", "State": "Alberta", "City": "Okotoks", "Product": "Smartfood Popcorn" }, { "Country": "India", "State": "Andhra Pradesh", "City": "Hyderabad", "Product": "Teddy Grahams Crackers" }, { "Country": "South Africa", "State": "Gauteng", "City": "Roodepoort", "Product": "Jaybee's Gourmet Nuts Gift Pack (3 Lb)" }, { "Country": "Finland", "State": "Ita-Suomen Laani", "City": "Kuopio", "Product": "Planters Deluxe Whole Cashew" }, { "Country": "Switzerland", "State": "Geneve", "City": "Vesenaz", "Product": "KIND Bars Almond & Coconut Gluten Free" }, { "Country": "Switzerland", "State": "Vaud", "City": "Lausanne", "Product": "Smartfood Popcorn" }, { "Country": "Switzerland", "State": "Vaud", "City": "Morges", "Product": "Kraft Real Mayo" }, { "Country": "Denmark", "State": "Frederiksborg", "City": "Helsingor", "Product": "Planters Deluxe Whole Cashew" }, { "Country": "Denmark", "State": "Kobenhavn", "City": "Kobenhavn", "Product": "Kraft Grated Parmesan Cheese" }, { "Country": "Denmark", "State": "Storstrom", "City": "Nakskov", "Product": "Kraft Grated Parmesan Cheese" }] </script> <script> $(document).ready(function() { GC.Spread.Sheets.LicenseKey = "xxx"; // Spreadを初期化します。 var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 }); // activesheetを取得します。 var activeSheet = spread.getActiveSheet(); // データソースと連結します。 activeSheet.setRowHeight(0, 30, 1); activeSheet.autoGenerateColumns = true; activeSheet.setDataSource(data); /* AutoMergeDirectionがColumnに設定され、AutoMergeModeが制限モードに設定されている場合、完全なシートセルをマージします。*/ var range = new GC.Spread.Sheets.Range(-1, -1, -1, -1); activeSheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.column, GC.Spread.Sheets.AutoMerge.AutoMergeMode.restricted); // 列幅を設定します。 for (var c = 0; c < activeSheet.getColumnCount(); c++) activeSheet.setColumnWidth(c, 130.0, GC.Spread.Sheets.SheetArea.viewport); }); </script>

JavaScript

コードのコピー

<script>
  var data = [
    {
      "Country": "Canada",
      "State": "Ontario",
      "City": "Ottawa",
      "Product": "Kraft Grated Parmesan Cheese"
    },
    {
      "Country": "Canada",
      "State": "Ontario",
      "City": "Belleville",
      "Product": "KIND Bars Almond & Coconut Gluten Free"
    },
    {
      "Country": "Canada",
      "State": "Ontario",
      "City": "Alliston",
      "Product": "Kraft Grated Parmesan Cheese"
    },
    {
      "Country": "Canada",
      "State": "Saskatchewan",
      "City": "Prince Albert",
      "Product": "Smartfood Popcorn"
    },
    {
      "Country": "Canada",
      "State": "Alberta",
      "City": "Red Deer",
      "Product": "Smartfood Popcorn"
    },
    {
      "Country": "Canada",
      "State": "Alberta",
      "City": "Calgary",
      "Product": "Planters Deluxe Whole Cashew"
    },
    {
      "Country": "Canada",
      "State": "Alberta",
      "City": "Calgary",
      "Product": "Kraft Grated Parmesan Cheese"
    },
    {
      "Country": "Canada",
      "State": "Alberta",
      "City": "Okotoks",
      "Product": "Smartfood Popcorn"
    },
    {
      "Country": "India",
      "State": "Andhra Pradesh",
      "City": "Hyderabad",
      "Product": "Teddy Grahams Crackers"
    },
    {
      "Country": "South Africa",
      "State": "Gauteng",
      "City": "Roodepoort",
      "Product": "Jaybee's Gourmet Nuts Gift Pack (3 Lb)"
    },
    {
      "Country": "Finland",
      "State": "Ita-Suomen Laani",
      "City": "Kuopio",
      "Product": "Planters Deluxe Whole Cashew"
    },
    {
      "Country": "Switzerland",
      "State": "Geneve",
      "City": "Vesenaz",
      "Product": "KIND Bars Almond & Coconut Gluten Free"
    },
    {
      "Country": "Switzerland",
      "State": "Vaud",
      "City": "Lausanne",
      "Product": "Smartfood Popcorn"
    },
    {
      "Country": "Switzerland",
      "State": "Vaud",
      "City": "Morges",
      "Product": "Kraft Real Mayo"
    },
    {
      "Country": "Denmark",
      "State": "Frederiksborg",
      "City": "Helsingor",
      "Product": "Planters Deluxe Whole Cashew"
    },
    {
      "Country": "Denmark",
      "State": "Kobenhavn",
      "City": "Kobenhavn",
      "Product": "Kraft Grated Parmesan Cheese"
    },
    {
      "Country": "Denmark",
      "State": "Storstrom",
      "City": "Nakskov",
      "Product": "Kraft Grated Parmesan Cheese"
    }]
</script>
<script>
    $(document).ready(function()
    {
      GC.Spread.Sheets.LicenseKey = "xxx";
      // Spreadを初期化します。
      var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), {
        sheetCount: 1
      });
      // activesheetを取得します。
      var activeSheet = spread.getActiveSheet();
      // データソースと連結します。
      activeSheet.setRowHeight(0, 30, 1);
      activeSheet.autoGenerateColumns = true;
      activeSheet.setDataSource(data);
      /* AutoMergeDirectionがColumnに設定され、AutoMergeModeが制限モードに設定されている場合、完全なシートセルをマージします。*/
      var range = new GC.Spread.Sheets.Range(-1, -1, -1, -1);
      activeSheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.column, GC.Spread.Sheets.AutoMerge.AutoMergeMode.restricted);
      // 列幅を設定します。
      for (var c = 0; c < activeSheet.getColumnCount(); c++)
        activeSheet.setColumnWidth(c, 130.0, GC.Spread.Sheets.SheetArea.viewport);
    });
</script>