MPDF项目HTML属性支持详解

作为一款强大的PHP PDF生成库，MPDF对HTML标签属性的支持非常全面。本文将系统性地介绍MPDF支持的各类HTML属性，帮助开发者更好地控制PDF输出效果。

基础属性支持

MPDF支持大多数HTML标签的标准属性，使用时需要注意以下几点：

1. 属性值可以使用单引号或双引号包裹
2. 不支持简写形式的属性（如<input disabled>必须写成<input disabled="disabled">）
3. 推荐使用XHTML规范以获得最佳兼容性

核心通用属性：

• class、id和style属性在大多数HTML标签上都受支持
• lang属性用于设置语言（需启用$useLang配置）
• dir属性用于设置文本方向（rtl从右到左，ltr从左到右）

常用标签属性详解

段落与容器标签

<p align="center">居中对齐的段落</p>
<div align="justify">两端对齐的div</div>

支持属性：

• align: left | center | right | justify

表格相关属性

表格是PDF文档中常用的元素，MPDF提供了丰富的表格控制属性：

TABLE标签：

<table border="1" width="80%" bgcolor="#f0f0f0" cellspacing="2" cellpadding="5">

支持属性：

• border: 0或1控制边框显示
• width: 设置表格宽度
• bgcolor: 背景颜色
• cellSpacing/cellPadding: 单元格间距和内边距
• autosize: 自动调整表格大小（自定义属性）
• rotate: 表格旋转（90或-90度）

TD/TH单元格：

<td width="20%" height="30px" align="center" valign="middle" bgcolor="#eeeeee" colspan="2" rowspan="2">

列表属性

有序和无序列表支持以下属性：

<ol type="A" start="5" font-size="12pt">
<ul type="square" font-size="10pt">

• type: 控制列表标记样式
• start: 设置起始编号（仅有序列表）
• font-size: 控制列表项字体大小

图片属性

<img src="image.jpg" width="100px" height="80px" rotate="90">

支持属性：

• width/height: 设置尺寸
• max-width/min-height等: 限制尺寸范围
• rotate: 图片旋转（90, -90或180度）

表单元素支持

MPDF能够生成可交互的PDF表单，支持多种表单控件属性：

输入框

<input type="text" name="username" size="20" maxlength="50" required="required">

下拉选择

<select name="country" size="4" multiple="multiple">
  <option value="cn" selected="selected">中国</option>
</select>

文本域

<textarea name="comments" cols="40" rows="5" readonly="readonly"></textarea>

特殊元素支持

MPDF还支持一些HTML5元素：

进度条和计量器

<progress value="75" max="100" width="200px"></progress>
<meter value="6" min="0" max="10" low="3" high="8"></meter>

注意事项

1. 表格分页属性page-break-inside、autosize和rotate仅在嵌套表格的最外层表格上生效
2. 布尔属性必须使用完整形式（如selected="selected"）
3. 语言代码遵循HTML规范（如"zh-CN"表示简体中文）
4. 表格旋转后，对齐方式align会基于旋转后的位置计算

版本变更记录

• 2.0版本：移除了对TD标签border属性的支持
• 2.3版本：新增lang属性支持
• 4.0版本：默认启用语言支持
• 5.0版本：新增HTML和BODY标签的dir属性

通过合理使用这些HTML属性，开发者可以精确控制PDF文档的布局和样式，生成符合专业要求的PDF文档。