如何默认勾选复选框？PHPWord中实现该功能的技术问询

我之前也碰到过这个棘手的问题！PHPWord官方文档确实没明确说明怎么实现默认勾选的复选框，直接调用addFormField方法如果参数配置不对，很容易达不到预期效果。

其实要搞定这个需求，核心是在调用addFormField时，指定字段类型为checkbox，同时在选项数组里正确配置checked和defaultValue参数。下面是经过验证可行的代码示例：

// 先获取文档的section对象
$section = $phpWord->addSection();

// 添加默认勾选的复选框
$section->addFormField('default_checked_box', 'checkbox', [
    'checked' => true,
    'defaultValue' => 1,
    'size' => 12, // 可选参数，用来调整复选框的显示大小
]);

如果你的PHPWord版本比较旧，上面的方法可能不生效，这时候可以直接操作底层的OOXML结构来强制设置勾选状态，绕过PHPWord的封装限制：

$checkbox = $section->addFormField('default_checked_box', 'checkbox', [
    'size' => 12,
]);

// 直接操作XML元素设置勾选属性
$xmlWriter = $checkbox->getXmlWriter();
$xmlWriter->startElement('w:checked');
$xmlWriter->writeAttribute('w:val', 'true');
$xmlWriter->endElement();

这种直接操作XML的方式虽然稍微麻烦一点，但兼容性更好，能确保生成的Word文档里复选框默认处于勾选状态。

内容的提问来源于stack exchange，提问作者Dmitrijs M.