使用自訂CSS檔案轉譯HTMLForms rendering-html-forms-using-custom-css-files
本檔案中的範例和範例僅適用於JEE環境上的AEM Forms 。
Forms服務會根據來自網頁瀏覽器的HTTP請求轉譯HTML表單。 呈現HTML表單時,Forms服務可參考自訂CSS檔案。 您可以建立自訂CSS檔案來符合業務需求,並在使用Forms服務轉譯HTML表單時參考該CSS檔案。
Forms服務會以無訊息方式剖析自訂CSS檔案。 也就是說,Forms服務不會報告在自訂CSS檔案不符合CSS標準時可能遇到的錯誤。 在此情況下,Forms服務會忽略樣式,繼續處理CSS檔案中的其餘樣式。
下列清單指定自訂CSS檔案支援的樣式:
- 類別層級選擇器樣式配對:如果存在於自訂CSS檔案中,則會使用在HTML表單中作為類別樣式使用的選取器。 未使用的類別樣式會被忽略。
- 識別碼層級選擇器樣式配對:所有識別碼樣式都會在HTML表單中使用。
- 元素層級選取器樣式配對:所有元素樣式都會在HTML表單中使用。
- 樣式優先順序:支援樣式優先順序(如重要),並且可用於自訂CSS檔案。
- 媒體型別:一或多個選擇器樣式配對可以包在@media樣式中來定義媒體型別。 Forms服務不會檢查指定的媒體型別是否受支援。 自訂CSS檔案中指定的媒體型別會在HTML表單中合併。
您可以使用FormsIVS應用程式擷取範例CSS檔案。 上傳表單,在「測試表單設計」頁面中選取表單,然後按一下「產生CSS」。 按一下按鈕之前,您不需要設定HTML轉換型別。 接著選取「儲存」。 您可以編輯此CSS檔案以符合您的業務需求。
步驟摘要 summary-of-steps
若要呈現使用CSS檔案的HTML表單,請執行下列工作:
- 包含專案檔案。
- 建立Forms Java API物件。
- 參考CSS檔案。
- 呈現HTML表單。
- 將表單資料流寫入使用者端網頁瀏覽器。
包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立Forms Java API物件
您必須先建立Forms使用者端物件,才能以程式設計方式執行Forms服務支援的操作。
參考CSS檔案
若要呈現使用自訂CSS檔案的HTML表單,請確定您參考現有的CSS檔案。
呈現HTML表單
若要呈現HTML表單,請指定在Designer中建立並儲存為XDP檔案的表單設計。 選取HTML轉換型別。 例如,您可以指定轉譯Internet Explorer 5.0或更新版本動態HTML的HTML轉換型別。
呈現HTML表單也需要值,例如呈現其他表單型別所需的URI值。
將表單資料流寫入使用者端網頁瀏覽器
Forms服務轉譯HTML表單時,會傳回您必須寫入使用者端網頁瀏覽器的表單資料流,才能讓使用者看到HTML表單。
另請參閱
呈現使用Java API之CSS檔案的HTML表單 render-an-html-form-that-uses-a-css-file-using-the-java-api
使用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
. - A
TransformTo
指定HTML偏好設定型別的列舉值。 例如,若要呈現與Internet Explorer 5.0或更新版本的動態HTML相容的HTML表單,請指定TransformTo.MSDHTML
. - A
com.adobe.idp.Document
包含要與表單合併之資料的物件。 如果您不想合併資料,請傳遞空白字元com.adobe.idp.Document
物件。 - 此
HTMLRenderSpec
儲存HTML執行階段選項的物件。 - 字串值,指定
HTTP_USER_AGENT
標頭值,例如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. - A
URLSpec
儲存轉譯HTML表單所需的URI值的物件。 - A
java.util.HashMap
儲存檔案附件的物件。 這是選用引數,您可以指定null
如果您不想將檔案附加至表單。
此
(Deprecated) renderHTMLForm
方法傳回FormsResult
包含必須寫入使用者端Web瀏覽器的表單資料流的物件。 - 字串值,指定表單設計名稱,包括副檔名。 如果您參照的表單設計屬於Forms應用程式的一部分,請務必指定完整路徑,例如
-
將表單資料流寫入使用者端網頁瀏覽器
- 建立
com.adobe.idp.Document
物件(透過叫用FormsResult
物件getOutputContent
方法。 - 取得
com.adobe.idp.Document
物件(透過叫用其getContentType
方法。 - 設定
javax.servlet.http.HttpServletResponse
物件的內容型別,透過叫用其setContentType
方法並傳遞的內容型別com.adobe.idp.Document
物件。 - 建立
javax.servlet.ServletOutputStream
用來將表單資料流寫入使用者端網頁瀏覽器的物件,方法是叫用javax.servlet.h\ttp.HttpServletResponse
物件的getOutputStream
方法。 - 建立
java.io.InputStream
物件(透過叫用com.adobe.idp.Document
物件的getInputStream
方法。 - 建立位元組陣列,並叫用
InputStream
物件的read
方法,並將位元組陣列作為引數傳遞。 - 叫用
javax.servlet.ServletOutputStream
物件的write
將表單資料流傳送至使用者端web瀏覽器的方法。 將位元組陣列傳遞至write
方法。
- 建立
另請參閱
快速入門(SOAP模式):呈現使用CSS檔案的HTML表單(使用Java API)
呈現使用網頁服務API的CSS檔案的HTML表單 render-an-html-form-that-uses-a-css-file-using-the-web-service-api
使用Forms API (網頁服務)呈現使用自訂CSS檔案的HTML表單:
-
包含專案檔案
- 建立使用Forms服務WSDL的Java Proxy類別。
- 在類別路徑中包含Java Proxy類別。
-
建立Forms Java API物件
建立
FormsService
物件並設定驗證值。 -
參考CSS檔案
- 建立
HTMLRenderSpec
物件(使用其建構函式)。 - 若要呈現使用自訂CSS檔案的HTML表單,請叫用
HTMLRenderSpec
物件的setCustomCSSURI
方法,並傳遞字串值,以指定CSS檔案的位置和名稱。
- 建立
-
呈現HTML表單
叫用
FormsService
物件的(Deprecated) renderHTMLForm
方法並傳遞下列值:- 字串值,指定表單設計名稱,包括副檔名。 如果您參照的表單設計屬於Forms應用程式的一部分,請務必指定完整路徑,例如
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
TransformTo
指定HTML偏好設定型別的列舉值。 例如,若要呈現與Internet Explorer 5.0或更新版本的動態HTML相容的HTML表單,請指定TransformTo.MSDHTML
. - A
BLOB
包含要與表單合併之資料的物件。 如果您不想合併資料,請傳遞null
. (請參閱 使用可流程配置預先填入Forms.) - 此
HTMLRenderSpec
儲存HTML執行階段選項的物件。 - 字串值,指定
HTTP_USER_AGENT
標頭值,例如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. 如果您不想設定此值,可以傳遞空字串。 - A
URLSpec
儲存轉譯HTML表單所需的URI值的物件。 - A
java.util.HashMap
儲存檔案附件的物件。 這是選用引數,您可以指定null
如果您不想將檔案附加至表單。 - 空白
com.adobe.idp.services.holders.BLOBHolder
由填入的物件(Deprecated) renderHTMLForm
方法。 此引數值會儲存演算後的表單。 - 空白
com.adobe.idp.services.holders.BLOBHolder
由填入的物件(Deprecated) renderHTMLForm
方法。 此引數會儲存輸出XML資料。 - 空白
javax.xml.rpc.holders.LongHolder
由填入的物件(Deprecated) renderHTMLForm
方法。 此引數會儲存表單中的頁數。 - 空白
javax.xml.rpc.holders.StringHolder
由填入的物件(Deprecated) renderHTMLForm
方法。 此引數會儲存地區設定值。 - 空白
javax.xml.rpc.holders.StringHolder
由填入的物件(Deprecated) renderHTMLForm
方法。 此引數會儲存所使用的HTML演算值。 - 空白
com.adobe.idp.services.holders.FormsResultHolder
將包含此作業結果的物件。
此
(Deprecated) renderHTMLForm
方法填入com.adobe.idp.services.holders.FormsResultHolder
以表單資料流傳遞作為最後一個引數值的物件,必須寫入使用者端Web瀏覽器。 - 字串值,指定表單設計名稱,包括副檔名。 如果您參照的表單設計屬於Forms應用程式的一部分,請務必指定完整路徑,例如
-
將表單資料流寫入使用者端網頁瀏覽器
- 建立
FormResult
物件,方法是取得com.adobe.idp.services.holders.FormsResultHolder
物件的value
資料成員。 - 建立
BLOB
包含表單資料的物件(透過叫用FormsResult
物件的getOutputContent
方法。 - 取得
BLOB
物件(透過叫用其getContentType
方法。 - 設定
javax.servlet.http.HttpServletResponse
物件的內容型別,透過叫用其setContentType
方法並傳遞的內容型別BLOB
物件。 - 建立
javax.servlet.ServletOutputStream
用來將表單資料流寫入使用者端網頁瀏覽器的物件,方法是叫用javax.servlet.http.HttpServletResponse
物件的getOutputStream
方法。 - 建立位元組陣列,並透過叫用
BLOB
物件的getBinaryData
方法。 此任務會指派FormsResult
物件至位元組陣列。 - 叫用
javax.servlet.http.HttpServletResponse
物件的write
將表單資料流傳送至使用者端web瀏覽器的方法。 將位元組陣列傳遞至write
方法。
- 建立
另請參閱