将表单桥与用于表单5的自定义门户集成HTML integrating-form-bridge-with-custom-portal-for-html-forms

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

FormBridge是一个HTML5 Forms Bridge API,允许您与表单进行交互。 有关FormBridge API引用,请参阅 FormBridge API引用.

您可以使用FormBridge API从表单页面获取或设置表单字段的值并提交表单。 例如,您可以使用API来构建类似于向导的体验。

现有的HTML应用程序可以利用FormBridge API与表单进行交互,并将其嵌入到HTML页面中。 您可以使用以下步骤来使用表单桥API设置字段的值。

将HTML5表单集成到网页 integrating-html-forms-to-a-web-page

  1. 选择用户档案或创建用户档案

    1. 在CRX DE界面中,导航到: https://[server]:[port]/crx/de.

    2. 使用管理员凭据登录。

    3. 创建用户档案或选择现有用户档案。

      有关如何创建用户档案的详细信息,请参阅 创建新用户档案.

  2. 修改HTML配置文件

    在配置文件渲染器中包含XFA运行时、XFA区域设置库和XFA表单HTML代码片段,设计网页,并将表单放在网页内。

    例如,使用以下代码片段创建一个包含两个输入字段和一个表单的应用程序,以演示表单与外部应用程序之间的交互。

    code language-xml
    <%@ page session="false"
                   contentType="text/html; charset=utf-8"%><%
    %><%@ taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %><%
    %><!DOCTYPE html>
    <html manifest="${param.offlineSpec}">
        <head>
           <cq:include script="formRuntime.jsp"/>
            <!-- Portal Scripts and Styles -->
           <cq:include script="portalheader.jsp"/>
        </head>
        <body>
            <div id="leftdiv" >
                <div id="leftdivcontentarea">
                    <!-- Portal Body -->
                  <cq:include script="portalbody.jsp"/>
                </div>
            </div>
            <div id="rightdiv">
                <div id="formBody">
                <cq:include script="config.jsp"/>
                <!-- Form body -->
                <cq:include script="formBody.jsp"/>
                <!  --To assist in page transitions -- add navigation, based on scrolling -->
                <cq:include  script="../nav/scroll/nav_footer.jsp"/>
                <cq:include script="footer.jsp"/>
                </div>
            </div>
        </body>
    </html>
    
    note note
    NOTE
    行9,包含用于CSS样式的其他JSP引用和用于设计页面的JavaScript文件。
    的 <div id="rightdiv"> 标记为 18号线 包含XFA表单的HTML代码片段。
    页面的样式设置为两个容器: left. 正确的容器具有表单。 左侧容器有两个输入字段和外部HTML页面的一部分。
    以下屏幕快照显示了表单在浏览器中的显示方式。

    门户

    左侧是 HTML页面. 包含字段的右侧是 xfa表单.

  3. 访问页面中的表单字段

    下面是一个示例脚本,您可以添加该脚本以在表单字段中设置值。

    例如,如果要将 EmployeeName 使用字段中的值 名字姓氏,调用 window.formBridge.setFieldValue 函数。

    同样,您也可以通过调用​ window.formBridge.getFieldValue ​ API来读取值。

    code language-none
    $(function() {
                $(".input").blur(function() {
                    window.formBridge.setFieldValue(
                                'xfa.form.form1.#subform[0].EmployeeName',
                                 $("#lname").val()+' '+$("#fname").val()
                               )
                    });
            });
    
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da