AutoFit Rows for Merged Cells with JavaScript via C++
Contents
[
Hide
]
Microsoft Excel provides a feature that allows you to auto-size the height of a cell according to its content. The feature is called auto-fit rows. Microsoft Excel doesn’t set auto-fit operation on merged cells natively. Sometimes the feature becomes vital for a user who really needs to implement auto-fit rows on merged cells too.
How to use AutoFitMergedCellsType for autofitting rows
Aspose.Cells for JavaScript via C++ supports this feature through the AutoFitterOptions.autoFitMergedCellsType API. Using this API, it is possible to auto-fit rows in a worksheet including merged cells. Here is a list of all possible types of auto fitting merged cells:
- None
- FirstLine
- LastLine
- EachLine
Autofit Rows for Merged Cells
Please see the following code, it creates a workbook object and adds multiple worksheets. Use different methods for autofit operations in each worksheet. The screenshot shows the results after the execution of the sample code.

JavaScript Sample Code
<!DOCTYPE html>
<html>
<head>
<title>Aspose.Cells Example</title>
</head>
<body>
<h1>Autofit Merged Cells Example</h1>
<input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
<button id="runExample">Run Example</button>
<a id="downloadLink" style="display: none;">Download Result</a>
<div id="result"></div>
</body>
<script src="aspose.cells.js.min.js"></script>
<script type="text/javascript">
const { Workbook, SaveFormat, AutoFitterOptions, AutoFitMergedCellsType, Utils } = AsposeCells;
AsposeCells.onReady({
license: "/lic/aspose.cells.enc",
fontPath: "/fonts/",
fontList: [
"arial.ttf",
"NotoSansSC-Regular.ttf"
]
}).then(() => {
console.log("Aspose.Cells initialized");
});
document.getElementById('runExample').addEventListener('click', async () => {
const fileInput = document.getElementById('fileInput');
let workbook;
if (fileInput.files.length) {
const file = fileInput.files[0];
const arrayBuffer = await file.arrayBuffer();
workbook = new Workbook(new Uint8Array(arrayBuffer));
} else {
workbook = new Workbook();
}
// Obtaining the reference of the first worksheet
const sheet1 = workbook.worksheets.get(0);
// Create a range A1:B2
const range = sheet1.cells.createRange(0, 0, 2, 2);
// Merge the cells
range.merge();
// Insert value to the merged cell A1
const cell1 = sheet1.cells.get(0, 0);
cell1.value = "A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog....end";
// Create a style object
const style = cell1.style;
// Set wrapping text on
style.isTextWrapped = true;
// Apply the style to the cell
cell1.style = style;
// Create an object for AutoFitterOptions
const options = new AutoFitterOptions();
// Only expands the height of the first row.
options.autoFitMergedCellsType = AutoFitMergedCellsType.FirstLine;
// Autofit rows in the sheet (including the merged cells)
sheet1.autoFitRows(options);
let index = workbook.worksheets.add();
const sheet2 = workbook.worksheets.get(index);
sheet2.name = "Sheet2";
// Create a range A1:B2
const range2 = sheet2.cells.createRange(0, 0, 2, 2);
// Merge the cells
range2.merge();
// Insert value to the merged cell A1
const cell2 = sheet2.cells.get(0, 0);
cell2.value = "A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog....end";
// Create a style object
const style2 = cell2.style;
// Set wrapping text on
style2.isTextWrapped = true;
// Apply the style to the cell
cell2.style = style2;
// Create an object for AutoFitterOptions
const options2 = new AutoFitterOptions();
// Only expands the height of the last row.
options2.autoFitMergedCellsType = AutoFitMergedCellsType.LastLine;
// Autofit rows in the sheet (including the merged cells)
sheet2.autoFitRows(options2);
index = workbook.worksheets.add();
const sheet3 = workbook.worksheets.get(index);
sheet3.name = "Sheet3";
// Create a range A1:B2
const range3 = sheet3.cells.createRange(0, 0, 2, 2);
// Merge the cells
range3.merge();
// Insert value to the merged cell A1
const cell3 = sheet3.cells.get(0, 0);
cell3.value = "A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog....end";
// Create a style object
const style3 = cell3.style;
// Set wrapping text on
style3.isTextWrapped = true;
// Apply the style to the cell
cell3.style = style3;
// Create an object for AutoFitterOptions
const options3 = new AutoFitterOptions();
// Only expands the height of each row.
options3.autoFitMergedCellsType = AutoFitMergedCellsType.EachLine;
// Autofit rows in the sheet (including the merged cells)
sheet3.autoFitRows(options3);
index = workbook.worksheets.add();
const sheet4 = workbook.worksheets.get(index);
sheet4.name = "Sheet4";
// Create a range A1:B2
const range4 = sheet4.cells.createRange(0, 0, 2, 2);
// Merge the cells
range4.merge();
// Insert value to the merged cell A1
const cell4 = sheet4.cells.get(0, 0);
cell4.value = "A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog....end";
// Create a style object
const style4 = cell4.style;
// Set wrapping text on
style4.isTextWrapped = true;
// Apply the style to the cell
cell4.style = style4;
// Create an object for AutoFitterOptions
const options4 = new AutoFitterOptions();
// Ignore merged cells.
options4.autoFitMergedCellsType = AutoFitMergedCellsType.None;
// Autofit rows in the sheet (not including the merged cells)
sheet4.autoFitRows(options4);
// Saving the modified Excel file and creating a download link
const outputData = workbook.save(SaveFormat.Xlsx);
const blob = new Blob([outputData]);
const downloadLink = document.getElementById('downloadLink');
downloadLink.href = URL.createObjectURL(blob);
downloadLink.download = 'out.xlsx';
downloadLink.style.display = 'block';
downloadLink.textContent = 'Download Excel File';
document.getElementById('result').innerHTML = '<p style="color: green;">Operation completed successfully! Click the download link to get the modified file.</p>';
});
</script>
</html>