easyexcel 实现下拉框

### EasyExcel 实现 Excel 下拉框数据验证 在使用 EasyExcel 时，可以通过自定义 `SheetWriteHandler` 来实现 Excel 下拉框的数据验证功能。通过这种方式，可以在写入 Excel 文件时动态地为特定列添加下拉选项。 #### 基本步骤 1. **准备下拉框数据** 创建一个包含下拉选项的列表，例如： ```java List<String> dropdownOptions = Arrays.asList("选项1", "选项2", "选项3"); ``` 2. **创建自定义的 SheetWriteHandler** 自定义类需要实现 `SheetWriteHandler` 接口，并重写其方法以设置数据验证规则。 ```java public class DropdownSheetWriteHandler implements SheetWriteHandler { private final List<String> options; private final int columnIndex; public DropdownSheetWriteHandler(List<String> options, int columnIndex) { this.options = options; this.columnIndex = columnIndex; } @Override public void beforeSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { // 可选：在创建Sheet之前进行的操作 } @Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet = writeSheetHolder.getSheet(); DataValidationHelper helper = sheet.getDataValidationHelper(); // 创建下拉框的数据验证约束 DataValidationConstraint constraint = helper.createExplicitListConstraint(options.toArray(new String[0])); // 设置数据验证的范围（整个列） CellRangeAddressList regions = new CellRangeAddressList(1, 65535, columnIndex, columnIndex); DataValidation validation = helper.createValidation(constraint, regions.getCellRangeAddresses().get(0)); validation.setSuppressDropDownArrow(true); // 隐藏下拉箭头 validation.setShowErrorBox(true); // 显示错误提示 sheet.addValidationData(validation); } } ``` 3. **注册自定义的 SheetWriteHandler 并写入数据** 在写入 Excel 文件时，注册自定义的 `SheetWriteHandler`。 ```java List<String> dropdownOptions = Arrays.asList("选项1", "选项2", "选项3"); EasyExcel.write(filePath) .registerWriteHandler(new DropdownSheetWriteHandler(dropdownOptions, 1)) // 第二列为下拉框 .sheet("Sheet1") .doWrite(dataList); // dataList 是要写入的数据 ``` #### 解决下拉框选项过多的问题 当需要设置的下拉框选项数量较多时，直接将所有选项嵌入到公式中会导致字符串长度超过限制（如引用[^2]所述）。为了避免此问题，可以采取以下方法： - **将下拉框数据存储在隐藏的 Sheet 中** 将所有下拉框选项存储在一个隐藏的 Sheet 中，并通过公式引用该 Sheet 的单元格范围来设置数据验证。 示例代码如下： ```java public class HiddenDropdownSheetWriteHandler implements SheetWriteHandler { private final List<String> options; private final int columnIndex; public HiddenDropdownSheetWriteHandler(List<String> options, int columnIndex) { this.options = options; this.columnIndex = columnIndex; } @Override public void beforeSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { // 创建一个隐藏的 Sheet 来存储下拉框数据 Sheet hiddenSheet = writeWorkbookHolder.getWorkbook().createSheet("HiddenData"); for (int i = 0; i < options.size(); i++) { Row row = hiddenSheet.createRow(i); Cell cell = row.createCell(0); cell.setCellValue(options.get(i)); } // 隐藏该 Sheet writeWorkbookHolder.getWorkbook().setSheetHidden(writeWorkbookHolder.getWorkbook().getSheetIndex(hiddenSheet), true); } @Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet = writeSheetHolder.getSheet(); DataValidationHelper helper = sheet.getDataValidationHelper(); // 使用公式引用隐藏 Sheet 中的数据 String formula = "HiddenData!$A$1:$A$" + options.size(); DataValidationConstraint constraint = helper.createFormulaListConstraint(formula); // 设置数据验证的范围（整个列） CellRangeAddressList regions = new CellRangeAddressList(1, 65535, columnIndex, columnIndex); DataValidation validation = helper.createValidation(constraint, regions.getCellRangeAddresses().get(0)); validation.setSuppressDropDownArrow(true); // 隐藏下拉箭头 validation.setShowErrorBox(true); // 显示错误提示 sheet.addValidationData(validation); } } ``` 4. **注册并使用隐藏的 Sheet 写入处理程序** ```java List<String> dropdownOptions = new ArrayList<>(); for (int i = 1; i <= 100; i++) { dropdownOptions.add("选项" + i); } EasyExcel.write(filePath) .registerWriteHandler(new HiddenDropdownSheetWriteHandler(dropdownOptions, 1)) // 第二列为下拉框 .sheet("Sheet1") .doWrite(dataList); // dataList 是要写入的数据 ``` 通过上述方法，可以轻松实现 EasyExcel 导出带有下拉框的 Excel 文件，并且支持大量选项的场景。 ---