將表單網橋與HTML5表單的自訂入口整合

FormBridge是HTML5表單橋接器API,可讓您與表單互動。 有關FormBridge API參考,請參閱FormBridge API參考

您可以使用FormBridge API從HTML頁面取得或設定表單欄位的值,並提交表單。 例如,您可以使用API來建立類似精靈的體驗。

現有的HTML應用程式可運用FormBridge API與表單互動,並將其內嵌在HTML頁面中。 您可以使用下列步驟,使用表單橋接器API來設定欄位的值。

將HTML5表單整合至網頁

  1. 選擇配置檔案或建立配置檔案

    1. 在CRX DE介面中,導覽至:https://[server]:[port]/crx/de

    2. 使用管理員憑證登入。

    3. 建立設定檔或選擇現有設定檔。

      有關如何建立配置檔案的詳細資訊,請參閱建立新配置檔案

  2. 修改HTML設定檔

    在設定檔轉譯器中加入XFA執行階段、XFA地區設定程式庫,以及XFA表單HTML片段、設計網頁,並將表單放入網頁內。

    例如,使用下列程式碼片段,建立含有兩個輸入欄位和表單的應用程式,以示範表單與外部應用程式之間的互動。

    <%@ 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>
    
    注意

    第9行​包含用於設計頁面的CSS樣式和JavaScript檔案的其他JSP引用。

    第18行​上的<div id="rightdiv">標籤包含XFA表單的HTML片段。
    頁面會設定為兩個容器:left​和​right。 正確的容器有表單。 左側容器有兩個輸入欄位,且是外部HTML頁面的一部分。
    下列螢幕擷取畫面顯示表單在瀏覽器中的顯示方式。

    入口

    左側是​HTML頁面​的一部分。 包含欄位的右側是​xfa表單

  3. 從頁面存取表單欄位

    以下是您可新增以在表單欄位中設定值的範例指令碼。

    例如,如果要使用欄位​名字​和​姓氏​中的值來設定​EmployeeName,請調用​window.formBridge.setFieldValue​函式。

    同樣地,您也可以呼叫​window.formBridge.getFieldValue API來讀取值。

    $(function() {
                $(".input").blur(function() {
                    window.formBridge.setFieldValue(
                                'xfa.form.form1.#subform[0].EmployeeName',
                                 $("#lname").val()+' '+$("#fname").val()
                               )
                    });
            });
    

本頁內容