1. IronPDF
  2. 操作指南
  3. 创建 PDF 表单

如何在 Java 中创建 PDF 表单

Darrius Serrant
Darrius Serrant
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Java让开发人员通过将HTML转换为PDF来构建动态交互式PDF表单——文本输入、复选框、组合框和单选按钮。 这种HTML优先的方法使您可以使用标准的Web技术全面控制表单布局和行为，而无需学习专有的表单API。 一旦您了解了IronPDF如何建模表单字段，还可以通过编程方式填写现有的PDF表单。

传统的Java PDF库要求您通过低级别的PDF对象构建表单字段。 IronPDF走了一条不同的路径：在HTML和CSS中编写您的表单，然后将其渲染为一个保留了每个交互字段的PDF。 结果与Adobe Acrobat Reader和所有主流PDF查看器兼容。

快速开始：在Java中创建PDF表单

  1. 通过Maven Central将IronPDF for Java添加到项目中
  2. 使用 License.setLicenseKey() 设置您的许可证密钥
  3. 编写一个包含标准表单元素的 HTML 字符串（<input>, <textarea>, <select>）
  4. 调用 PdfDocument.renderHtmlAsPdf() 将 HTML 转换为 PDF
  5. 将生成的文档保存为 saveAs()
//:path=/static-assets/ironpdf-java/howto/create-forms/quickstart-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set license key before any rendering call
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML form with a text field and submit button
String formHtml = "<h2>Registration Form</h2>" +
                  "<form>" +
                  "<label>Name: <input type='text' name='fullname' placeholder='Enter name'></label><br>" +
                  "<button type='submit'>Submit</button>" +
                  "</form>";

// Render HTML to PDF — form fields are preserved
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(formHtml);
pdf.saveAs("registration-form.pdf");
//:path=/static-assets/ironpdf-java/howto/create-forms/quickstart-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set license key before any rendering call
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML form with a text field and submit button
String formHtml = "<h2>Registration Form</h2>" +
                  "<form>" +
                  "<label>Name: <input type='text' name='fullname' placeholder='Enter name'></label><br>" +
                  "<button type='submit'>Submit</button>" +
                  "</form>";

// Render HTML to PDF — form fields are preserved
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(formHtml);
pdf.saveAs("registration-form.pdf");
JAVA

如何用 Java 创建 PDF 表单

  1. 安装用于创建 PDF 表单的 Java 库。
  2. 创建一个包含表单字段的HTML字符串
  3. 使用 renderHtmlAsPdf 方法将 HTML 字符串转换为 PDF 文件
  4. 导出PDF文档
  5. 使用各种支持的表单字段类型

如何在 Java 中创建表格？

IronPDF通过将W3C HTML表单规格视为真理来源来从HTML创建PDF表单。 所有标准表单元素——<checkbox> 和 <radio>——在生成的 PDF 中均将作为交互式字段保留。 您可以使用CSS为这些元素设置样式，并包括自定义字体以符合您的品牌要求。

创建表格时，IronPDF 会在生成的 PDF 中保留 HTML 表单元素的交互特性。 用户可以直接在其 PDF 浏览器中填写表格，无需额外软件。 这些表单与Adobe Acrobat Reader及所有常规部署的PDF查看器兼容，使它们可以在企业和消费者环境中访问。 有关高级渲染选项，请参阅PDF生成设置文档。

提示IronPDF不需要运行的浏览器或安装的PDF打印驱动程序。 渲染引擎与库捆绑在一起，因此表单在开发机器、CI服务器和云部署中渲染一致。

如何创建文本输入和文本区域表单？

文本输入和文本区域是最常见的PDF表单元素——用于收集姓名、电子邮件地址、注释和多行描述。 IronPDF 将 <input type="text"> 映射为单行 PDF 文本字段，并将 <textarea> 映射为保留行和列尺寸的多行字段。

HTML 表单元素在转换为 PDF 时应保持其功能。 用户可以点击字段、键入文本，并使用Tab键在输入框之间移动，就像任何Web表单一样。 转换过程中将保留默认值、占位符文本以及 HTML5 验证属性（如 required 和 pattern）。 为了细粒度的布局控制，将表单元素与自定义纸张尺寸和边距设置结合使用。

//:path=/static-assets/ironpdf-java/howto/create-forms/text-input-textarea-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with single-line inputs and a multi-line textarea
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <form>
            First name: <br> <input type='text' name='firstname' value=''> <br>
            Last name: <br> <input type='text' name='lastname' value=''> <br>
            Address: <br> <textarea name='address' rows='4' cols='50'></textarea>
        </form>
    </body>
</html>
""";

// Render HTML — both <input> and <textarea> become interactive PDF fields
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("textAreaAndInputForm.pdf");
//:path=/static-assets/ironpdf-java/howto/create-forms/text-input-textarea-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with single-line inputs and a multi-line textarea
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <form>
            First name: <br> <input type='text' name='firstname' value=''> <br>
            Last name: <br> <input type='text' name='lastname' value=''> <br>
            Address: <br> <textarea name='address' rows='4' cols='50'></textarea>
        </form>
    </body>
</html>
""";

// Render HTML — both <input> and <textarea> become interactive PDF fields
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("textAreaAndInputForm.pdf");
JAVA

对 PdfDocument 类的 renderHtmlAsPdf 调用会将 HTML 转换为完全交互式的 PDF。 每一个命名的表单字段都在PDF的AcroForm字典中成为一个独立的字段，可以由任何符合标准的PDF查看器读取。 您在 name 属性中设置的字段名称（address）将在输出中保留，并在您后续提取表单数据时可被读取。

输出 PDF 文档：

如何创建复选框和组合框表单？

复选框和下拉列表涵盖了 PDF 表单中最常见的两种选择模式：二元开/关选项以及从列表中选择单个项目。IronPDF 将 <input type="checkbox"> 映射到 PDF 复选框字段，并将 <select> 元素映射到 PDF 下拉列表（下拉菜单）字段。

下拉列表字段允许用户从由 <option> 元素定义的固定选项列表中进行选择。 您可以通过在选项中添加 selected 属性来预设默认选项，使用 <optgroup> 将相关选项分组，并利用 CSS 使下拉菜单的外观与文档设计风格保持一致。 name 元素上的 <select> 属性将成为生成的 PDF 文件中的字段名称，从而使表单数据提取变得简单直接。 如果您需要使用其他工具处理表单，请参阅Apache PDFBox项目，了解PDF AcroForm字段如何存储此选择数据的详细信息。

//:path=/static-assets/ironpdf-java/howto/create-forms/checkbox-combobox-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with a checkbox and a select dropdown
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <h3>Task Completed</h3>
        <label>
            <input type='checkbox' id='taskCompleted' name='taskCompleted'> Mark task as completed
        </label>
        <h3>Select Priority</h3>
        <label for='priority'>Choose priority level:</label>
        <select id='priority' name='priority'>
            <option value='high'>High</option>
            <option value='medium' selected>Medium</option>
            <option value='low'>Low</option>
        </select>
    </body>
</html>
""";

// Render HTML — checkbox and combobox fields are preserved in the PDF
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("checkboxAndComboboxForm.pdf");
//:path=/static-assets/ironpdf-java/howto/create-forms/checkbox-combobox-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with a checkbox and a select dropdown
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <h3>Task Completed</h3>
        <label>
            <input type='checkbox' id='taskCompleted' name='taskCompleted'> Mark task as completed
        </label>
        <h3>Select Priority</h3>
        <label for='priority'>Choose priority level:</label>
        <select id='priority' name='priority'>
            <option value='high'>High</option>
            <option value='medium' selected>Medium</option>
            <option value='low'>Low</option>
        </select>
    </body>
</html>
""";

// Render HTML — checkbox and combobox fields are preserved in the PDF
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("checkboxAndComboboxForm.pdf");
JAVA

复选框字段存储一个布尔状态（PDF/A 标记中为 /On 或 /Off），下游代码在处理提交的表单时可读取该状态。 下拉列表会存储所选 <option> 的 value 属性。 两种字段类型在保存的PDF中保持交互性——用户可以选中方框或更改下拉选择，而无需任何额外的插件或JavaScript。

输出 PDF 文档：

如何创建单选按钮表单？

单选按钮呈现互斥选择：一旦用户在一个组中选择一个选项，同一组中任何以前选择的选项将被自动取消选择。 IronPDF 将具有相同 name 属性的 <input type="radio"> 元素映射到 PDF 的 AcroForm 字典中一个分组单选框字段。

同一组中的所有单选按钮必须具有相同的 name 属性值——这正是 PDF 中将它们关联起来的依据。 每个按钮的 value 属性决定了当选中该选项时，字段将存储的内容。 如果该组中未选中任何按钮，字段值为 None。 您可以在已加载的 PdfDocument 上使用 getForm() 和 getFields() 方法读取当前选定内容，从而构建预填表单或验证提交数据的工作流。 有关读取表单字段的实例化示例，请参阅PDF表单数据示例。

//:path=/static-assets/ironpdf-java/howto/create-forms/radio-button-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with a radio button group — all three share name='traveltype'
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        Choose your preferred travel type: <br>
        <input type='radio' name='traveltype' value='Bike'> Bike <br>
        <input type='radio' name='traveltype' value='Car'> Car <br>
        <input type='radio' name='traveltype' value='Airplane'> Airplane
    </body>
</html>
""";

// Render HTML — all three radio inputs become one grouped field in the PDF
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("radioButtonForm.pdf");
//:path=/static-assets/ironpdf-java/howto/create-forms/radio-button-form.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// HTML with a radio button group — all three share name='traveltype'
String htmlContent = """
<html>
    <body>
        <h2>Editable PDF Form</h2>
        Choose your preferred travel type: <br>
        <input type='radio' name='traveltype' value='Bike'> Bike <br>
        <input type='radio' name='traveltype' value='Car'> Car <br>
        <input type='radio' name='traveltype' value='Airplane'> Airplane
    </body>
</html>
""";

// Render HTML — all three radio inputs become one grouped field in the PDF
PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save the document
pdfDoc.saveAs("radioButtonForm.pdf");
JAVA

由于这三个 <input type="radio"> 元素共享 name="traveltype" 属性，IronPDF 会在生成的 PDF 中创建一个 AcroForm 单选按钮组。 例如，在 Acrobat Reader 中选择"汽车"会将字段值设置为 Car，并清除之前的任何选择。 这一行为反映了用户对Web表单中单选按钮组的期望，使得从Web到PDF的数据收集过渡自然。

请注意单选按钮组的名称在整个表单中必须是唯一的。 在不同的逻辑组中重复使用相同的名称会将它们合并为一个字段，从而阻止独立选择。）}]

我如何应用PDF表单创建的最佳实践？

可靠的PDF表单需要关注渲染配置和长期的可维护性。 最常见的问题是表单在浏览器中显示正常，但转换后失去交互性——这通常是由于表单元素缺少 name 属性所致。 请务必为每个字段分配 name； IronPDF 使用此值作为 PDF 字段标识符，没有名称的字段可能会被删除或合并。

在分发之前，使用多个PDF查看器测试表单。 Adobe Acrobat Reader 是参考实施，但许多企业环境中部署了Foxit Reader或基于浏览器的查看器，它们都以略有不同的方式处理特殊情况。 请使用 IronPDF 在渲染过程中支持的 HTML5 验证属性（pattern），以便在表单填写时而非后端处理阶段就发现数据质量问题。 对于敏感文档，请应用密码和安全设置以防止未经授权的编辑。

部署到生产环境时，在第一次渲染调用之前设置许可证密钥，并将其保存在安全的配置存储中，而不是硬编码。 IronPDF 发布了AWS、Azure和Google Cloud环境的部署指南。 查看许可证密钥指南以了解试用和生产密钥行为的详细信息。

提示保持表单字段名称简短且由字母数字组成。 一些PDF阅读器会截断或拒绝包含空格或特殊字符的字段名称，这可能会破坏表单数据提取。

在Java中创建PDF表单的下一步是什么？

本指南涵盖了四种主要的交互式表单字段类型——文本输入、文本区、复选框、组合框和单选按钮——并演示了IronPDF如何将标准HTML表单标记转换为完全交互式的PDF。 每种字段类型都直接映射到其HTML对应项，因此现有的网页表单模板可以以最小的修改进行重用。

从这里开始，您可以考虑探索：

  • 读取并处理表单数据：使用 getForm() 和 getFields() 从已填写的 PDF 中提取提交的值。 表单数据示例显示了完整的回读工作流程。
  • 程序化预填充表单：结合填写PDF表单指南，为每个收件人生成预先填充的文档。
  • 保护您的表单：通过安全和元数据设置示例添加密码保护并限制编辑。
  • 高级渲染：通过PDF生成设置指南控制纸张尺寸、边距、页眉和页脚。

开始您的免费试用，无需付费许可证即可测试表单创建。 当您的项目准备好投入生产时，查看许可选项以获取适合您部署计划的选项。

准备看看IronPDF还能做些什么吗？ 在此查看完整的HTML到PDF教程：在Java中进行HTML到PDF转换

常见问题解答

用 Java 创建 PDF 表单的最简单方法是什么？

IronPDF for Java从标准HTML创建PDF表单。编写带有、