导出HTML

许多公司在 Excel 文件中维护产品库存、招聘职位、价目表等。但是，将这些数据发布到网站上与相关客户共享是非常普遍的。因此，在这种情况下，导出为 HTML 文件成为一项重要功能。

GcExcel 允许用户将工作簿、工作表或任何特定范围导出到 HTML 文件。默认情况下，它导出一个HTML文件和一个包含其他文件的文件夹。这些附加文件可以是工作表中的图像、工作簿中其他工作表的 HTML 文件或用于设置 HTML 文件样式的 CSS 文件。同样，在导出工作表或工作表的任何区域时，也可以导出单个 HTML 文件。

使用 HtmlSaveOptions 类中的各种方法，可以通过各种设置控制导出的内容，如导出标题、网格线、文档属性或应用其他设置，如可缩放宽度、页面标题、显示工具提示文本等。

HtmlSaveOptions 类中的 setExportCssSeparately 方法单独导出 CSS 文件（在附加文件夹中），因为其默认值为 True。但是，可以将其设置为false，以便将css样式数据直接导出到每个工作表，而不创建单独的 CSS 文件。

HtmlSaveOptions 类中的 setCssExportType 方法为用户提供了选项，用于决定如何使用 CssExportType 枚举将 CSS 文件与 HTML 文件一起导出。CssExportType 枚举允许用户将 CSS 导出到单独的文件（在附加文件夹中）、HTML 中的 style 标记中或 HTML 元素内的 style 属性中。

注意： 如果使用未经许可的GcExcel版本：
将工作簿导出为HTML时：工作簿中会附加一个“评估警告”页，并在每个工作表的开头显示一条“评估警告”消息。
将工作表或范围导出为HTML时：在工作表或范围文件的开头添加“评估警告”消息。

导出工作簿为HTML

IWorkbook 接口的 save 方法可用于将工作簿导出为 HTML 文件。

请参阅以下示例代码，将工作簿导出成一个 zip 文件夹，其包含工作簿的 HTML 文件和其他文件。

// Create a zip file stream
FileOutputStream outputStream = new FileOutputStream("SaveWorkbookToHTML.zip");
// Create a new workbook
Workbook workbook = new Workbook();
workbook.open("NetProfit.xlsx");
// Save workbook to html format
workbook.save(outputStream, SaveFileFormat.Html);

导出工作表为HTML

IWorkbook接口的save方法可用于将工作表导出为HTML文件。工作表的标题和网格线也可以使用HtmlSaveOptions类的 setExportHeadings 和 setExportGridlines 方法导出。setExportSheetName方法可用于定义需要导出的工作表。

请参阅以下示例代码，将工作表导出成一个zip文件夹，其包含工作表的HTML文件和其他文件。

// Create a zip file stream
FileOutputStream outputStream = null;
outputStream = new FileOutputStream("SaveWorksheetToHTML.zip");

// Create a new workbook
Workbook workbook = new Workbook();
workbook.open("ProjectTracker.xlsx");
HtmlSaveOptions options = new HtmlSaveOptions();

// Set exporting row/column headings
options.setExportHeadings(true);

// Set exporting gridlines
options.setExportGridlines(true);

// Export first sheet
options.setExportSheetName(workbook.getWorksheets().get(0).getName());

// Set exported html file name
options.setExportFileName("HiringDetails");
workbook.save(outputStream, options);

当设置了HtmlSaveOptions类的指定方法时，工作表也可以导出到单个HTML文件中，如下代码所示。

// Create a workbook
Workbook workbook = new Workbook();

// Open an xlsx file
workbook.open("ProjectTracker.xlsx");

// Create HtmlSaveOptions
HtmlSaveOptions options = new HtmlSaveOptions();

// Export first sheet
options.setExportSheetName(workbook.getWorksheets().get(0).getName());

// Set exported image as base64
options.setExportImageAsBase64(true);

// Set the css export type to internal CSS.
options.setCssExportType(CssExportType.Internal);

// Or, set the css export type to inline CSS.
// options.setCssExportType(CssExportType.Inline);

// Set not to export single tab in html
options.setExportSingleTab(false);

// Save first worksheet to html
workbook.save("SaveWorksheetToSingleHTML.html", options);

导出工作表的区域为HTML

IWorkbook接口的save方法可用于将工作表的任何范围导出为HTML文件。HtmlSaveOptions类的setExportArea方法可用于定义需要导出的范围。

请参阅以下示例代码，将工作表中的一片区域导出成一个zip文件夹，其包含导出区域的HTML文件和其他文件。

// Get detail range and set style.
for (IPivotLine item : pivottable.getPivotRowAxis().getPivotLines()) {
    if (item.getLineType() == PivotLineType.Subtotal) {
        item.getPivotLineCells().get(0).getRange().getInterior().setColor(Color.GetGreenYellow());
    }
}

当设置了HtmlSaveOptions类的特定方法时，工作表中的范围也可以导出到单个HTML文件中，如下代码所示。

// Create a new workbook
Workbook workbook = new Workbook();
workbook.open("ProjectTracker.xlsx");

// Create HtmlSaveOptions
HtmlSaveOptions options = new HtmlSaveOptions();

// Specify exported sheet name
options.setExportSheetName(workbook.getWorksheets().get(0).getName());

// Set export area
options.setExportArea("D2:G23");

// Set exported image as base64
options.setExportImageAsBase64(true);

// Set the css export type to internal CSS.
options.setCssExportType(CssExportType.Internal);

// Or, set the css export type to inline CSS.
// options.setCssExportType(CssExportType.Inline);

// Set not to export single tab in html
options.setExportSingleTab(false);

// Save the specified range of first worksheet to html
workbook.save("WorksheetRangeToHTML.html", options);

type=warning
注意：setExportCssSeparately 方法现已过时，但具有此属性的现有应用程序将继续正常运行。

限制

导出到HTML文件时不支持以下功能：

图表
渐变填充
切片器
- 数据透视表切片器或报表连接
- 切片器项目的自定义高度
- 切片器设置
- 切片器样式（颜色属性除外）
- 切片器头部样式
- 围绕“项目”面板的滚动查看器
- 无数据时的切片器项目样式