HTML5表单的常见问题解答(FAQ)

有关HTML5表单的布局、脚本支持和范围的一些常见问题(FAQ)。

布局

  1. 为什么条码和签名字段不显示在我的表单中?

    答案:条码和签名字段与HTML或移动场景无关。 这些字段显示为非交互区域。 但是,AEM Forms Designer提供了一个新的签名涂抹字段,可以使用它代替签名字段。 您还可以为条码添加自定义构件并集成它。

  2. XFA文本字段是否支持富文本?

    答案:不支持在AEM Forms Designer中允许丰富内容的XFA字段,该字段呈现为普通文本,不支持从用户界面设置文本样式。 此外,具有comb属性的XFA字段显示为普通字段,但根据comb数字的值,允许的字符数仍有限制。

  3. 使用可重复子表单是否存在任何限制?

    答案:可重复子表单的初始计数应为1或更多。 不支持初始计数为零的可重复子表单。 您还可以选择使用可重复的子表单,而不是在加载表单时显示它。 要实现用例:

    1. 将可重复子表单的初始计数设置为1。

      初数

    2. 使用表单的初始化事件隐藏子表单的主实例。 例如,下面的代码在表单初始化时隐藏子表单的主实例。 它还验证应用程序类型以确保脚本仅在客户端执行:

      if ((xfa.host.appType == "HTML 5" || xfa.host.appType == "Exchange-Pro" || xfa.host.appType == "Reader")&&(_RepeatSubform.count == 1)&&(form1.Page1.Subform1.RepeatSubform.Key.rawValue == null)) {
      RepeatSubform.presence = "hidden";
      }  
      
    3. 打开用于添加子表单实例以进行编辑的脚本。 添加如下代码以添加子表单脚本的实例。

      下面的代码检查子表单的隐藏实例。 如果找到子表单的隐藏实例,请删除子表单的隐藏实例,并插入子表单的新实例。 如果找不到子表单的隐藏实例,则只需插入子表单的新实例即可。

      if (RepeatSubform.presence == "hidden")
      { 
      RepeatSubform.instanceManager.insertInstance(0);
      RepeatSubform.instanceManager.removeInstance(1);
      }
      else
      {
      RepeatSubform.instanceManager.addInstance(1);
      }
      
    4. 打开用于删除要编辑的子表单实例的脚本。 添加如下代码以删除子表单脚本的实例。

      代码检查子表单的计数。 如果子表单的计数达到1,则代码将隐藏子表单,而不是删除子表单。

      if (RepeatSubform.instanceManager.count == 1) {
      RepeatSubform.presence = "hidden";
      } else {
      RepeatSubform.instanceManager.removeInstance(RepeatSubform.instanceManager.count - 1);
      }
      
    5. 打开表单的预提交事件进行编辑。 将以下脚本添加到事件,以在编辑之前删除脚本的隐藏实例。 它可防止在提交时发送隐藏子表单的数据。

      if(RepeatSubform.instanceManager.count == 1 && RepeatSubform.presence == "hidden") {
      RepeatSubform.instanceManager.removeInstance(0);
      }
      
  4. 是否对使用隐藏子表单有任何限制?

    答案:具有跨页面拆分的复杂层次结构的隐藏子表单会导致布局问题。 一种解决方法是将子表单标记为初始可见,然后根据某些逻辑或数据在初始化脚本中隐藏子表单。

  5. 为什么某些文本被截断或在HTML5中显示不正确?

    答案:如果未为Draw或Caption文本元素提供足够的空间来显示内容,则文本在移动表单再现中会被截断。 此截断也可在AEM Forms Designer的“设计”视图中看到。 尽管此截断可在PDF中处理,但无法在HTML5表单中处理。 要避免此问题,请提供足够的空间来绘制或题注文本,以便它不会在AEM Forms Designer的设计模式中截断。

  6. 我正在观察与丢失内容或重叠内容相关的布局问题。 原因何在?

    答案:如果在同一位置(如“矩形”)存在“绘制文本”或“绘制图像”元素以及另一个重叠元素,则“绘制文本”内容在以后按文档顺序出现时(在AEM Forms设计器层次结构视图中)将不可见。 PDF支持透明图层,但HTML/浏览器不支持透明图层。

  7. 为什么HTML表单中显示的某些字体与设计表单时使用的字体不同?

    答案:HTML5表单不嵌入字体(与字体嵌入在表单中的PDF forms相反)。 要使表单的HTML版本按预期呈现,请确保在XDP中指定的字体在服务器和客户端计算机上可用。 如果服务器上不提供所需的字体,则使用回退字体。 此外,如果您在表单模板中使用客户端设备上不可用的字体,则使用浏览器的默认字体来呈现文本。

  8. HTML表单中是否支持vAlign和hAlign属性?

    是,支持vAlign和hAlign属性。 Internet Explorer和多行字段中不支持vAlign属性。

  9. HTML5表单是否支持希伯来语字符?

    HTML5表单支持除Microsoft Internet Explorer外的所有浏览器中的希伯来语字符。

  10. HTML5表单对数字字段是否有任何限制?

    答案:是的,HTML5表单有一些限制。 如果数字数大于picture子句中指定的计数,则数字未本地化,并以英语区域设置显示。

  11. 为什么HTML表单比PDF forms大?

    要将XDP渲染为HTML表单,需要大量中间数据结构和对象(如表单dom、数据dom和布局dom)。

    对于PDF forms,Adobe Acrobat有一个内置的XTG引擎,用于创建中间数据结构和对象。 Acrobat还负责布局和脚本。

    对于HTML5表单,浏览器没有内置的XTG引擎来创建中间数据结构和来自原始XDP字节的对象。 因此,对于HTML5表单,在服务器上生成中间结构并发送给客户端。 在客户端,基于javascript的脚本和布局引擎使用这些中间结构。

    中间结构的大小取决于原始XDP的大小以及与XDP合并的数据。

  12. 在使用xdp中的表时是否存在任何限制?

    答案:复杂表在渲染中会导致问题。

    • 不支持表中的节(子表单集)。
    • 某些表中的页眉或页脚行被标记为重复。 将这些表拆分到多个页面可能会遇到一些问题。
  13. 可访问的表是否有任何限制?

    答案:是的,可访问表具有以下限制:

    • 不支持表中的嵌套表和子表单。
    • 表的顶行或左列仅支持标题。 中间表元素不支持标题。 您可以将标题应用到多个行和列标题,前提是所有此类行和列与表的最顶行或最左列一起使用。
    • Rowspan并且 colspan不支持从表内的随机位置进行。
    • 不能动态添加或删除包含行范围值大于1的元素的行实例。
  14. 屏幕阅读器的工具提示和题注的阅读顺序是什么?

    • 当同时存在题注和工具提示时,将读取唯一的题注。 如果题注不可用,则会读取工具提示。 您还可以使用表单设计器指定在XDP中读取的优先级
    • 悬停某个元素时,将显示工具提示。 如果工具提示不可用,则显示语音文本。 如果语音文本不可用,则显示字段名称。
  15. 悬停某个字段时,将显示工具提示。 如何禁用它?

    要在悬停时禁用工具提示,请在设计器的“辅助功能”面板中选择“无”。

  16. 在设计器中,用户可以配置单选按钮和复选框的自定义外观属性。 是否,在呈现表单时,HTML5表单会考虑此类自定义外观属性?

    答案:HTML5表单会忽略单选按钮和复选框的自定义外观属性。 单选按钮和复选框根据基础浏览器的规范显示。

  17. 在支持的浏览器中打开HTML5表单时,相邻放置的字段的边框不正确对齐或子表单显示重叠。 当在Forms Designer中预览同一HTML5表单时,字段和布局不会出现不对齐,子表单显示在正确位置。 如何解决此问题?

    当子表单设置为流内容且子表单具有隐藏的边框元素时,相邻放置的域的边框不正确对齐或子表单出现重叠。 要解决此问题,可以从相应的XDP中删除或注释隐藏的<border>元素。 例如,以下<border>元素被标记为注释:

                <!--<border>
                   <edge presence="hidden"/>
                   <corner thickness="0.175mm" presence="hidden"/>
                </border> -->
    

脚本

  1. HTML Forms的JavaScript实现中是否存在任何限制?

    答案:

    • 对xfa.connectionSet脚本的支持有限。 对于connectionSet,仅支持对Web服务的服务器端调用。 有关详细信息,请参阅脚本支持
    • 客户端脚本中不支持$record和$data。 但是,如果脚本以formReady、layoutReady块编写,则脚本仍然有效,因为这些事件在服务器端运行。
    • 不支持XFA Draw元素特定的脚本,如更改Draw文本(或在字段出现时更改Caption文本)。
  2. 使用formCalc有任何限制吗?

    答案:当前仅实现formCalc脚本的子集。 有关详细信息,请参阅脚本支持

  3. 是否有推荐的命名约定,是否有要避免的保留关键字?

    • 在AEM Forms Designer中,建议不要以下划线()开头的对象(如子表单或文本字段)的名称。 要在名称的开头使用下划线,请在下划线后面添加前缀,*<prefix><objectname>。*
    • 所有HTML5表单API都是保留关键字。 对于自定义API/函数,请使用与HTML5表单API不相同的名称。
  4. HTML5表单是否支持浮动字段?

    是,HTML5 Forms支持浮动字段。 要启用浮动字段,请向渲染用户档案添加以下属性:

    注意

    默认情况下,字段不启用浮动。 您可以使用Forms Designer设置字段的浮动属性。

    1. 打开CRXde lite并导航到/content/xfaforms/profiles/default节点。

    2. 添加String类型的属性mfDataDependentFloatingField,并将该属性的值设置为​true

    3. 单击​保存全部。 现在,使用更新的呈现用户档案为HTML Forms启用浮动字段。

      注意

      要为特定表单启用浮动字段而不更新呈现用户档案,请将mfDataDependentFloatingField=true属性作为URL参数传递。

  5. HTML5表单是否多次执行初始化脚本和表单就绪事件?

    是的,初始化脚本和表单就绪事件在服务器上执行多次,至少一次在客户端执行。 建议根据某些业务逻辑(表单或字段数据)编写诸如初始化或表单:就绪事件之类的脚本,以便根据数据和幂等状态(如果数据相同)执行操作。

设计XDP

  1. HTML5表单中是否有保留的关键字?

    答案:所有HTML5表单API都是保留关键字。 对于自定义API/函数,请使用与HTML5表单API不相同的名称。 除保留关键字外,如果您使用以下划线(_)开头的对象名称,建议在下划线之后添加唯一的前缀。 添加前缀有助于避免与HTML5表单内部API发生任何可能的冲突。 例如,_fpField1

On this page