如何在PHPSpreadsheet中为空单元格设置带条件格式的占位提示

你之前的两段代码都存在逻辑问题，对应错误点如下：

• 第一段代码调用了不存在的setText()方法：PhpSpreadsheet的条件格式类仅支持修改单元格样式，无法直接为空白单元格设置默认显示文本，该方法本身不存在，自然不会生效。
• 第二段代码使用CONDITION_NOTCONTAINSTEXT时没有指定匹配文本，导致条件永久触发，所以不管你输入什么内容都会应用灰色字体样式，无法自动切换。

正确实现方案 #

你需要使用自定义公式类型的条件格式+自定义数字格式实现需求，Excel本身支持通过自定义格式在满足条件时显示指定占位文本，不需要修改单元格实际值，完全符合你的要求：

• 空单元格时触发条件，通过自定义格式显示红色的「Enter text here」
• 单元格有输入内容时不触发条件，自动使用默认样式显示实际输入内容

可运行的完整代码如下：

<?php
require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Style\Conditional;
use PhpOffice\PhpSpreadsheet\Style\Color;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$spreadsheet = new Spreadsheet();
$activeSheet = $spreadsheet->getActiveSheet();
$targetCell = 'C3';

// 初始化条件格式
$conditional = new Conditional();
// 条件类型设为自定义公式
$conditional->setConditionType(Conditional::CONDITION_EXPRESSION);
// 公式判断单元格是否为空，公式内的单元格地址要和目标单元格保持一致
$conditional->addCondition('ISBLANK('.$targetCell.')');
// 满足条件时设置自定义数字格式，显示占位文本
$conditional->getStyle()->getNumberFormat()->setFormatCode('"Enter text here"');
// 满足条件时字体设为红色
$conditional->getStyle()->getFont()->getColor()->setARGB(Color::COLOR_RED);

// 把条件格式应用到目标单元格
$conditionalStyles = $activeSheet->getStyle($targetCell)->getConditionalStyles();
$conditionalStyles[] = $conditional;
$activeSheet->getStyle($targetCell)->setConditionalStyles($conditionalStyles);

// 导出文件
$writer = new Xlsx($spreadsheet);
$writer->save('hello world.xlsx');

效果说明 #

生成的Excel文件打开后，C3单元格默认是空值，会自动显示红色的「Enter text here」，输入任意内容后占位文本会消失，自动显示输入的内容且字体恢复为默认黑色，删除内容后会重新显示占位文本，完全匹配你的需求。如果需要应用到多个单元格，选择对应范围后公式内使用不带$的相对地址即可自动适配。

内容的提问来源于stack exchange，提问作者Ivan