使用自定义CSS文件渲染HTML Forms

本文档中的示例和示例仅适用于JEE环境中的AEM Forms。

Forms服务会响应Web浏览器的HTTP请求来呈现HTML表单。呈现HTML表单时，Forms服务可以引用自定义CSS文件。您可以创建自定义CSS文件以满足您的业务要求，并在使用Forms服务渲染HTML表单时引用该CSS文件。

Forms服务会静默解析自定义CSS文件。也就是说，如果自定义CSS文件不符合CSS标准，Forms服务不会报告可能遇到的错误。在这种情况下，Forms服务将忽略样式，并继续保留位于CSS文件中的其余样式。

以下列表指定自定义CSS文件支持的样式：

类级别选择器样式对:如果自定义CSS文件中存在选择器，则会使用HTML表单中用作类样式的选择器。将忽略未使用的类样式。
标识符级别选择器样式对:如果在HTML表单中使用所有标识符样式，则会使用这些样式。
元素级别选择器样式对:如果在HTML表单中使用所有元素样式，则会使用这些样式。
样式优先级:支持样式优先级（与重要信息一样），并可在自定义CSS文件中使用。
媒体类型:一个或多个选择器样式对可封装在@media样式中以定义媒体类型。Forms服务不检查指定的媒体类型是否受支持。在自定义CSS文件中指定的媒体类型将合并到HTML表单中。

您可以使用FormsIVS应用程序检索示例CSS文件。上载表单，在“测试表单设计”页面中选择该表单，然后单击生成CSS。在单击按钮之前，无需设置HTML转换类型。接下来选择保存。您可以编辑此CSS文件以满足您的业务要求。

注意

在渲染使用自定义CSS文件的HTML表单之前，您必须对渲染HTML表单有扎实的了解。 (请参阅将Forms渲染为HTML。)

注意

有关Forms服务的更多信息，请参阅AEM Forms的服务参考。

步骤的摘要

要渲染使用CSS文件的HTML表单，请执行以下任务：

包括项目文件。
创建Forms Java API对象。
引用CSS文件。
渲染HTML表单。
将表单数据流写入客户端Web浏览器。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请确保包含代理文件。

创建Forms Java API对象

您必须先创建一个Forms客户端对象，然后才能以编程方式执行Forms服务支持的操作。

引用CSS文件

要渲染使用自定义CSS文件的HTML表单，请确保引用现有CSS文件。

渲染HTML表单

要渲染HTML表单，必须指定在Designer中创建并另存为XDP文件的表单设计。还必须选择HTML转换类型。例如，您可以指定为Internet Explorer 5.0或更高版本渲染动态HTML的HTML转换类型。

渲染HTML表单还需要值，例如渲染其他表单类型所需的URI值。

将表单数据流写入客户端Web浏览器

当Forms服务呈现HTML表单时，它会返回一个表单数据流，您必须将该数据流写入客户端Web浏览器，以使用户能够看到HTML表单。

另请参阅

使用Java API渲染使用CSS文件的HTML表单

包括AEM Forms Java库文件

设置连接属性

Forms Service API快速入门

呈现交互式PDF forms

将Forms渲染为HTML

创建可渲染Forms的Web应用程序

使用Java API渲染使用CSS文件的HTML表单

使用Forms API(Java)渲染使用自定义CSS文件的HTML表单：

包含项目文件

在Java项目的类路径中包含客户端JAR文件，如adobe-forms-client.jar。
创建Forms Java API对象
- 创建包含连接属性的ServiceClientFactory对象。
- 使用其构造函数创建FormsServiceClient对象，并传递ServiceClientFactory对象。
引用CSS文件
- 使用HTMLRenderSpec对象的构造函数创建对象。
- 要呈现使用自定义CSS文件的HTML表单，请调用HTMLRenderSpec对象的setCustomCSSURI方法，并传递指定CSS文件位置和名称的字符串值。
渲染HTML表单

调用FormsServiceClient对象的(Deprecated) (Deprecated) renderHTMLForm方法并传递以下值：
- 指定表单设计名称（包括文件扩展名）的字符串值。如果您引用的表单设计是Forms应用程序的一部分，请确保指定完整路径，如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
- 指定HTML首选项类型的TransformTo枚举值。例如，要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定TransformTo.MSDHTML。
- com.adobe.idp.Document对象，其中包含要与表单合并的数据。如果不想合并数据，请传递一个空的com.adobe.idp.Document对象。
- 存储HTML运行时选项的HTMLRenderSpec对象。
- 指定HTTP_USER_AGENT标头值的字符串值，如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)。
- URLSpec对象，用于存储呈现HTML表单所需的URI值。
- 用于存储文件附件的java.util.HashMap对象。这是一个可选参数，如果您不想将文件附加到表单，可以指定null。
(Deprecated) renderHTMLForm方法返回一个FormsResult对象，该对象包含必须写入客户端Web浏览器的表单数据流。
将表单数据流写入客户端Web浏览器
- 通过调用FormsResult对象“s getOutputContent”方法创建com.adobe.idp.Document对象。
- 通过调用getContentType方法获取com.adobe.idp.Document对象的内容类型。
- 通过调用setContentType方法并传递com.adobe.idp.Document对象的内容类型来设置javax.servlet.http.HttpServletResponse对象的内容类型。
- 通过调用javax.servlet.h\ttp.HttpServletResponse对象的getOutputStream方法，创建一个javax.servlet.ServletOutputStream对象，用于将表单数据流写入客户端Web浏览器。
- 通过调用com.adobe.idp.Document对象的getInputStream方法创建java.io.InputStream对象。
- 通过调用InputStream对象的read方法并将字节数组作为参数传递，创建一个字节数组并用表单数据流填充该数组。
- 调用javax.servlet.ServletOutputStream对象的write方法，将表单数据流发送到客户端Web浏览器。将字节数组传递到write方法。

另请参阅

使用自定义CSS文件渲染HTML Forms

快速入门（SOAP模式）：使用Java API呈现使用CSS文件的HTML表单

包括AEM Forms Java库文件

设置连接属性

使用Web服务API渲染使用CSS文件的HTML表单

使用Forms API（Web服务）渲染使用自定义CSS文件的HTML表单：

包含项目文件
- 创建使用Forms服务WSDL的Java代理类。
- 在类路径中包含Java代理类。
创建Forms Java API对象

创建FormsService对象并设置身份验证值。
引用CSS文件
- 使用HTMLRenderSpec对象的构造函数创建对象。
- 要呈现使用自定义CSS文件的HTML表单，请调用HTMLRenderSpec对象的setCustomCSSURI方法，并传递指定CSS文件位置和名称的字符串值。
渲染HTML表单

调用FormsService对象的(Deprecated) renderHTMLForm方法并传递以下值：
- 指定表单设计名称（包括文件扩展名）的字符串值。如果您引用的表单设计是Forms应用程序的一部分，请确保指定完整路径，如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
- 指定HTML首选项类型的TransformTo枚举值。例如，要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定TransformTo.MSDHTML。
- BLOB对象，其中包含要与表单合并的数据。如果不想合并数据，请传递null。 (请参阅使用可流动布局预填充Forms。)
- 存储HTML运行时选项的HTMLRenderSpec对象。
- 指定HTTP_USER_AGENT标头值的字符串值，如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)。如果不想设置此值，可以传递空字符串。
- URLSpec对象，用于存储呈现HTML表单所需的URI值。
- 用于存储文件附件的java.util.HashMap对象。这是一个可选参数，如果您不想将文件附加到表单，可以指定null。
- 由(Deprecated) renderHTMLForm方法填充的空com.adobe.idp.services.holders.BLOBHolder对象。此参数值存储呈现的表单。
- 由(Deprecated) renderHTMLForm方法填充的空com.adobe.idp.services.holders.BLOBHolder对象。此参数存储输出XML数据。
- 由(Deprecated) renderHTMLForm方法填充的空javax.xml.rpc.holders.LongHolder对象。此参数以表单形式存储页数。
- 由(Deprecated) renderHTMLForm方法填充的空javax.xml.rpc.holders.StringHolder对象。此参数存储区域设置值。
- 由(Deprecated) renderHTMLForm方法填充的空javax.xml.rpc.holders.StringHolder对象。此参数存储所用的HTML呈现值。
- 将包含此操作结果的空com.adobe.idp.services.holders.FormsResultHolder对象。
(Deprecated) renderHTMLForm方法使用必须写入客户端Web浏览器的表单数据流填充作为最后一个参数值传递的com.adobe.idp.services.holders.FormsResultHolder对象。
将表单数据流写入客户端Web浏览器
- 通过获取com.adobe.idp.services.holders.FormsResultHolder对象value数据成员的值，创建FormResult对象。
- 通过调用FormsResult对象的getOutputContent方法，创建包含表单数据的BLOB对象。
- 通过调用getContentType方法获取BLOB对象的内容类型。
- 通过调用setContentType方法并传递BLOB对象的内容类型来设置javax.servlet.http.HttpServletResponse对象的内容类型。
- 通过调用javax.servlet.http.HttpServletResponse对象的getOutputStream方法，创建一个javax.servlet.ServletOutputStream对象，用于将表单数据流写入客户端Web浏览器。
- 创建一个字节数组，并通过调用BLOB对象的getBinaryData方法来填充该数组。此任务将FormsResult对象的内容分配给字节数组。
- 调用javax.servlet.http.HttpServletResponse对象的write方法，将表单数据流发送到客户端Web浏览器。将字节数组传递到write方法。