SpreadJS 是一款基于 HTML5 的純前端電子表格控件，兼容 450 種以上的 Excel 公式，憑借其 “高性能、跨平臺、與 Excel 高度兼容”的產品特性，備受以華為、蘇寧易購、天弘基金等為代表的企業用戶青睞。SpreadJS 為用戶帶來親切的 Excel 使用體驗的同時，滿足 Web Excel 組件開發、表格文檔協同編輯、數據填報、Excel 類報表設計等業務場景，極大降低了企業研發成本和項目交付風險。

SpreadJS v17.0 Update1正式版下載

V17.0 Update1 現已發布，新特性如下：

工作簿增強 / Workbook Enhancement

• 從右向左 / Right-to-Left

將樣式的 textDirection 屬性設置為 rightToLeft，可以將單元格中的文本方向更改為從右到左。這可以適應從右側編寫和讀取的語言和腳本，并確保這些語言的數據能夠正確、自然地顯示。

同時，可以將某個工作表（Worksheet）的配置 rightToLeft 為 true，將從整體外觀上形成從右到左的形式，如下圖：

• 富文本支持項目符號列表 / Bulleted List

作為富文本格式的一部分，現在支持使用無序項目符號和有序編號列表。列表項具有 type、level 和 richText 作為其屬性。

• 文件上傳單元格類型 / FileUpload CellType

在新版本中，我們引入了一個新的 FileUpload CellType，允許用戶通過單擊單元格內的文件上傳按鈕來選擇任何文件。

用戶還可以對這些文件執行操作，包括預覽、下載和清除。默認上傳按鈕在單元格中顯示，如下所示：

• 文檔自定義屬性 / Custom Properties Support

SpreadJS 現在支持為工作簿設置自定義屬性，包括標題、作者、主題等數據。可以使用API在工作簿中管理這些屬性，也可以使用“高級屬性”窗口在 SpreadJS 表格編輯器管理這些屬性：

• 通過行列頭拖動 / Move/Insert Column or Row by Dragging Headers

現在可以通過拖動標題來移動或插入列和行。可以通過將排列選項的allowDragHeaderToMove枚舉設置為行、列或兩者都設置來啟用。這也可以在SpreadJS設計器中啟用：

• 和外部復制粘貼支持格式 / Paste Data Outside of SpreadJS with Formatting

在 17.1 版本中，SpreadJS 現在支持在 SpreadJS 和 Excel 之間復制和粘貼單元格格式。這包括數字和日期格式等選項。

• 將形狀和圖表復制為圖像 / Copy Shape and Chart as an Image

現在可以將形狀、圖表和切片器復制到剪貼板并另存為圖像。我們向 Shape 和 Shape Base 類添加了一個名為 toImageSrc 的新 API。對于圖表和切片器來說也是如此。對于 SpreadJS Designer，當右鍵單擊任何這些對象時，還提供了一個新的“另存為圖片”選項：

報表插件 / ReportSheet

• 行高列寬自適應 / ReportSheet AutoFit Row/Column

SpreadJS ReportSheet 現在支持行和列的自動調整。這允許用戶指定行或列的大小是否應根據其中的文本進行更改。這樣，設計器中就有了一個用于設置 AutoFit 屬性的新 API 和一個新界面設置：

• 頁總計 / Page Total

報表插件的 R.V 函數生成工作表中溢出單元格的值。在新版本中，添加了另一個參數來指定當前頁面。例如：=SUM(R.V(C2,”CurrentPage”)) 將生成當前頁面中所有溢出值的總和。其模板是：

然后，第一頁將如下所示：

計算引擎 / Calculation

• 公式調整的性能增強 / Formula Adjustment Performance Enhancement

新版本中更新了內部邏輯，以提高插入/刪除行/列時的性能。會在使用這些操作時較之前花費更少的時間地進行計算。

• 增量計算 / Incremental Calculation

新版本支持增量計算，在執行過程中將整個計算分成多個段。這樣可以在計算任務較大時響應用戶操作，從而防止工作簿包含許多公式時 UI 無響應。開發人員只需將 Workbook 類的incrementalCalculation 屬性設置為 true。

• 保護狀態下隱藏公式 / Protected Sheets Hidden Option

現在可以使用 Style 類的隱藏屬性或 CellRange 類的隱藏方法來控制受保護工作表中公式單元格的可見性。啟用后，當隱藏單元格處于活動狀態時，編輯欄將不會顯示任何數據，輸入編輯器在編輯模式下將為空，并且公式編輯器面板將不會顯示公式。

利用這個特性，可以保護一些單元格中的公式，避免使用者看到公式或修改。

圖表 / Charts

• 圖表表結構引用 / Chart Table Structured References

新版本已支持結構化參考公式，并且現在在表格中支持它們作為圖表數據源。如果圖表綁定到完整的表或使用表結構引用的表的某些列，則表中的任何更新都將在運行時自動更新圖表的系列或數據值。

• 圖表數據標簽“單元格值” / Chart Data Label “Value Of Cell”

圖表數據標簽現在支持使用單元格引用來顯示所選單元格范圍的值。用戶可以為圖表的數據標簽選擇特定的單元格范圍。

• 源鏈接單元格式化程序 / Source Linked Cell Formatter

在新版本中，用戶現在可以使用鏈接單元格應用單元格格式，以動態更新圖表元素的格式，包括數據標簽、軸和工具提示。

表 / Table

• 自定義樣式 / Custom Styles Enhancement

新版本中，SpreadJS 允許用戶自定義表格樣式

集算表 / TableSheet

• 預定義列 / Defined Column Functionality

SpreadJS 集算表新版本支持添加、更新和刪除具有有意義的列類型的列，以幫助輕松設計表格。

• 撤銷重做支持 / Undo/Redo Support

新版本集算表添加了撤消和重做支持，允許用戶撤消/重做以下類別的操作：

• 配置更改：過濾、排序和其他配置設置
• 運行時 UI 操作：類似于工作表操作，如單元格編輯、添加/刪除行/列、剪貼板操作、拖動/移動行/列等
• 集算表 API：大多數更改數據或設置的 API 操作（setDataView 方法除外）

同樣，在表格編輯器中也支持撤銷重做。

• 大綱分組 / Outline Groups

在新版本中，SpreadJS 集算表現在支持大綱分組，可以在 groupBy 方法中定義多個字段來創建大綱組。這種多重分組允許用戶展開或折疊字段并包括聚合、頁眉和頁腳。

分組還支持在分組和基礎列之間進行排序。

表格編輯器 / Designer

• 自定義保存文件對話框 / Save File Dialog Customization

在新版本中，用戶可以通過 API 設置保存時的文件格式以及文件名稱，如下代碼所示：

• 打印邊框選項 / Printing showBorder Option

 SpreadJS 中已經存在 showBorder 方法，用于控制打印過程中是否顯示邊框。在此版本中，我們已將該選項添加到表格編輯器：

• 條件格式規則管理器性能增強 / Conditional Formatting Rules Manager Performance Enhancement

條件格式規則管理器的性能得到了顯著增強，特別是在管理對話框中的多個規則時。

• 條件格式規則管理器支持當前選擇區域 / Conditional Formatting Rules Manager Current Selection Support

在某些情況下，工作簿可能具有大量條件格式，這可能會使查找特定格式變得復雜。規則管理器對話框現在支持顯示特定區域的規則，例如當前選擇或特定工作表：

透視表 / PivotTable

• 自定義樣式 / Custom Styles Enhancement

與上面提到的自定義表格樣式增強功能一樣，SpreadJS 現在使用戶能夠在運行時添加、刪除和修改數據透視表樣式。

• 數據透視表分組兼容性更新 / PivotTable Grouping Compatibility Update

Excel 更改了數據透視表中的分組方式，因此我們更新了 SpreadJS 數據透視表的分組策略以匹配。它經過改進，增強了可用性、靈活性和清晰度。

框架支持 / Framework Support

• Angular 17

除了版本 11 - 16 之外，SpreadJS 現在還支持 Angular 17。

• Next.js 14

SpreadJS 現在還支持 Next.js 版本 14。