There are some frequently asked questions (FAQ) about layout, scripting support, and scope of HTML5 forms.
Can I browse and change images at runtime for Image field?
Why do barcodes and signature field in not appear in my form?
Answer: Barcodes and signatures fields are not relevant in HTML or mobile scenarios. These fields appear as a non-interactive area. However, LiveCycle Designer provides a new signature scribble field that can be used instead of signature field. One can also add a custom widget for barcodes and integrate it.
Is Rich Text supported for the XFA Text Field?
Answer: The XFA field, which allows rich content in LiveCycle Designer, is not supported and is rendered as normal text without support for styling the text from the user interface. Also, XFA fields with comb property are displayed as a normal field, though there are still restrictions on number of allowed characters based on the value of comb digits.
Are there any limitations regarding using repeatable Subforms?
Answer: Repeatable Subforms with initial count of zero do not work. A workaround is to add a script on the formReady event that checks the instance count of that subform: If instance count is zero, add one instance and mark it hidden; else do nothing.
Why some text are truncated or are displayed incorrectly in HTML5?
Answer: Where a Draw or Caption text element has not been given enough space to display content, the text appear truncated in mobile form rendition. This truncation is also visible in the Design view of LiveCycle Designer. Though this truncation can be handled in the PDFs, it cannot be handled in the HTML5 forms. To avoid the issue, provide enough space to Draw or Caption Text so that it does not truncate in the design mode of the LiveCycle Designer.
I am observing layout issues related to missing content or overlapping content. What is the reason?
Answer: If there is a Draw Text or a Draw Image element along with another overlapping element at the same position (say a Rectangle), the Draw Text content are not visible if it comes later in the document order (in LiveCycle Designer Hierarchy view). PDF supports transparent layering but HTML/browsers do not support transparent layering.
Why are some fonts displayed in the HTML form different from the ones used while designing the form?
Answer: HTML5 forms do not embed fonts (in contrast to PDF forms where fonts are embedded inside the form). For the HTML version of form to render as expected, ensure that the fonts specified in the XDP are available on the server and on the client machine. If the required fonts are not available on server, then fall-back fonts are used. Moreover, if you use fonts in Form Template that are not available on the client device, then default fonts of the browser are used to render the text.
A lot of intermediate data structures and objects such as form dom, data dom, and layout dom are required to render an XDP to an HTML form.
For PDF Forms, Adobe Acrobat has a built-in XTG engine to create intermediate data structures, and objects. Acrobat also takes care of layout and scripts.
The size of the intermediate structure depends on the size of the original XDP and the data merged with the XDP.
Do accessible tables have any limitations?
Answer: Yes, accessible tables have the following limitations:
- Nested tables and subform inside a table are not supported.
- Headers are only supported for the top row or left columns of the table. Headers are not supported for mid-table elements. You can apply headers to multiple row and column headers are supported provided all such rows and columns are along with the topmost row or leftmost column of the table.
- Rowspan and colspan from a random location inside the table is not supported.
- You cannot dynamically add or remove instance of rows which contain elements with rowspan value greater than 1.
What is the reading order of tool tip and caption for screen readers?
- When both caption and tool tip are present, the only caption is read. If the caption is not available, then the tool tip is read. You can also specify the precedence for reading in an XDP using form designer
- When you hover an element, then tool tip is displayed. If tool-tip is not available speech text is displayed. If speech text is not available, then field name is displayed.
In Designer, a user can configure custom appearance properties of radio button and check boxes. Do, while rendering the forms, HTML5 forms take such custom appearance properties into account?
Answer: HTML5 forms ignore the custom appearance properties of radio button and check boxes. The radio buttons and check boxes appear as per the specifications of the underlying browser.
When an HTML5 Form is opened in a supported browser, the border of the fields placed adjacently is not aligned properly or subforms appear overlapped. When the same HTML5 Form is previewed in Forms Designer, the fields and layout do not appear misaligned and subforms appear in the correct position. How to fix the issue?
When a subform is set to flow content and the subform has a hidden border element, the border of the fields placed adjacently is not aligned properly or subforms appear overlapped. To resolve the issue, you can remove or comment the hidden <border> elements from the corresponding XDP. For example, the following <border> element is marked as a comment:
<!--<border> <edge presence="hidden"/> <corner thickness="0.175mm" presence="hidden"/> </border> -->
- There is limited support for xfa.connectionSet script. For connectionSet, only server-side invocation of web service is supported. For detailed information, see Scripting Support.
- There is no support for $record and $data in client side scripts. However, if the scripts are written in a formReady, layoutReady block, the scripts still work because these events run on the server side.
- XFA Draw element-specific scripts such as changing the Draw text (or Caption text in case of fields) are not supported.
Is there any recommended naming convention and are there any reserved keywords to avoid?
- In LiveCycle Designer, it is recommended not to begin the name of an object (such as a subform or a text field) with an underscore (_). To use underscore at the beginning of the name, add a prefix after the underscore, _<prefix><objectname>.
- All HTML5 forms APIs are reserved keywords. For custom APIs/functions, use a name that is not identical to HTML5 forms APIs.
Yes, HTML5 Forms support floating fields. To enable floating fields, add the following property to the rendering profile:
By default, the fields are not enabled for floating. You can use Forms Designer to set the floating property of the fields..
Are there any reserved keywords in HTML5 forms?
Answer: All HTML5 forms APIs are reserved keywords. For custom APIs/functions, use a name that is not identical to HTML5 forms APIs. Apart from reserved keywords, if you use object names that begin with an underscore (_), it is recommended to add a unique prefix after the underscore. Adding a prefix helps avoid any possible conflict with HTML5 forms internal APIs. For example, _fpField1