Primefaces Autocomplete下拉框点击滚动条后消失问题求助

针对你遇到的这个Autocomplete组件滚动异常问题，我结合你的代码片段和PrimeFaces常见的坑，整理了几个可行的解决思路：

• 先修正scrollHeight属性的语法错误
  你的代码里scrollHeight="30..."明显是截断了不完整的数值，PrimeFaces要求这个属性是合法的整数（比如你原本想设置的300）。不完整的属性值会导致下拉面板的渲染逻辑异常，先把它补全为scrollHeight="300"，这是最基础的排查步骤。

• 排查onclick事件的触发冲突
  你设置的onclick="PF('dlg2').search('')"会在**每次点击下拉框区域（包括滚动条）**时触发搜索方法，这会强制下拉面板重新渲染，直接导致滚动时面板消失。建议调整触发逻辑：

  • 换成onfocus事件：onfocus="PF('dlg2').search('')"，只有输入框获得焦点时才触发搜索，滚动条点击不会触发；
  • 或者给onclick加判断，只在点击输入框本身时触发：onclick="if(event.target.tagName === 'INPUT') PF('dlg2').search('')"

• 强制提升下拉面板的层级与透明度
  有时候面板会因为z-index不足被其他元素覆盖，或者渲染时出现透明度异常，看起来像是褪色消失。给你的自定义类加CSS样式：

  .custom-autocomplete .ui-autocomplete-panel {
      z-index: 9999 !important;
      opacity: 1 !important;
  }
  

  这个样式会强制下拉面板保持最高层级和完全不透明，避免被其他元素遮挡或异常透明。

• 临时排查forceSelection的兼容性问题
  forceSelection="true"虽然是业务常用属性，但在某些PrimeFaces版本中，它和scrollHeight结合会出现渲染bug。你可以临时把它改成forceSelection="false"测试：

  • 如果滚动恢复正常，说明是版本bug，建议升级到PrimeFaces最新稳定版；
  • 如果必须保留forceSelection，确保completeMethod返回的列表是稳定的，不要在滚动时动态变更列表内容，避免触发面板重绘。

• 检查widgetVar的命名冲突
  你的widgetVar用了dlg2，这个名字很容易和页面上的对话框组件重名，导致JS调用混乱。把它改成更独特的名字（比如taxCountryAutocomplete），同时把onclick里的PF('dlg2')同步改成PF('taxCountryAutocomplete')，排除命名冲突的可能。

内容的提问来源于stack exchange，提问作者Arturs Soms