自动合并单元格

SpreadJS支持自动合并功能，允许用户自动合并包含重复文本的相邻单元格。在自动合并操作期间，在此过程中不会丢失任何数据。

使用自动合并的好处

自动合并功能可帮助用户：

在大型数据集中创建清晰可视化。
合并相同的单元而不会丢失任何数据。
消除冗余（重复文本）以消除表单中不必要的混乱。
节省大量时间和精力，而无需手动扫描重复的单元格以将它们一一合并。

自动合并原理？

自动合并功能会自动合并具有相同文本的连续单元格，并调整合并单元格的文本位置。

此功能在您要合并的单元格不应属于任何跨度范围的条件下起作用。使用SpreadJS时，用户可以使用 autoMerge() 方法将自动合并功能应用于指定范围，包括范围，行，列和整个表单。

SpreadJS 支持以下两种模式 AutoMergeMode 枚举:

自由模式-在此模式下，具有相同值的单元格会自动与相邻的单元格合并。
受限模式-在此模式下，只有在前一行或前一列中的相应单元格以类似方式合并时，具有相同值的单元格才会与相邻单元格合并。

要在SpreadJS中使用 addSpan 的选择功能支持自动合并, 使用 Worksheet 类下的 autoMerge 方法的参数 SelectionMode

您可以将 SelectionMode 参数设置为 source 或 merged 。下面介绍了这两个选项：

source : 在此模式选项中，您可以选择自动合并区域中的单个单元格。
merged : 在此模式选项中，您可以在自动合并区域中选择整个合并的单元格。

使用场景

在表单上执行数据分析时，用户可能希望合并包含相同文本的多个单元格，以增强数据表示和更好的结构。

例如-在生成销售报告时，最好将匹配的州或城市名称自动合并在一起，使其看起来更整洁，干净，同时确保不会丢失任何信息，并且合并后的单元格中的数据保持完整。

以下截图描述了自动合并操作如何在表单中组合国家，州和城市的名称。

自动合并单元格与生成和合并单元格

在表单中执行“自动合并单元格”操作和“跨单元合并”的基本区别是：

在SpreadJS中使用“自动合并”功能时，即使执行了合并操作，单元仍保持可导航和可编辑状态。相反，在执行单元格的合并和合并时，变更单元格值时会自动调整跨度和合并的单元格。
当用户滚动浏览表单时，文本在合并的跨度中保持可见（粘滞）状态。与常规合并跨度不同，自动合并的像元具有相同的值。

注意: 使用自动合并功能时，必须牢记以下限制：

代码

以下代码段使用合并包含相同国家名称，州和城市的单元格 autoMerge() 方法。

<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 () {
        // 初始化 Spread
        var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });

        //获取活跃表单
        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);

        // 自动合并SelectionMode为merged
        activeSheet.autoMerge(range, GC.Spread.Sheets.AutoMerge.AutoMergeDirection.column, GC.Spread.Sheets.AutoMerge.AutoMergeMode.restricted, GC.Spread.Sheets.SheetArea.viewport, GC.Spread.Sheets.AutoMerge.SelectionMode.merged);

        // 设置列宽
        for (var c = 0; c < activeSheet.getColumnCount(); c++)
            activeSheet.setColumnWidth(c, 130.0, GC.Spread.Sheets.SheetArea.viewport);
    });
</script>