Domino v12中XPage集成Bootstrap遇问题及升级咨询

这个错误的核心原因是混用了原生HTML表单与XPage的表单处理机制——Domino XPage对表单提交有专属规则，原生<form>标签的提交请求会被服务器判定为无效命令。具体解决步骤：

• 替换原生表单标签：将HTML的<form>替换为XPage原生的<xp:form>组件，所有表单控件嵌套在该组件内。XPage表单会自动处理提交请求的路由，避免服务器无法识别的命令。
• 调整验证属性使用：
  • 不要给原生<input>手动添加required=""，改用XPage控件的验证机制：比如用<xp:inputText>替代原生<input>，设置required="true"，搭配<xp:validateRequired>组件实现后端验证。
  • 若坚持使用原生HTML控件，需阻止XPage的默认提交行为，通过自定义JS处理表单提交；或给<xp:form>设置disableValidators="true"禁用XPage自动验证，避免冲突。
• 清理无效属性：XPage对HTML属性兼容性有限，novalidate这类属性不要直接加在表单上，改用XPage的disableValidators属性控制是否跳过验证。

Domino v12自带的Bootstrap4主题无法直接升级，需通过自定义主题替换资源，步骤如下：

• 新建自定义主题：在Domino Designer中打开应用的「主题」面板，新建主题文件（比如bootstrap5.theme）。
• 覆盖Bootstrap资源：
  1. 将Bootstrap5的bootstrap.min.css、bootstrap.bundle.min.js（包含Popper.js）上传到Domino服务器的domino/html目录下的子文件夹（比如bootstrap5）。
  2. 在主题文件中添加资源引用：

<theme extends="webstandard">
  <!-- 移除Bootstrap4的默认资源 -->
  <resource mode="override">
    <content-type>text/css</content-type>
    <href></href>
  </resource>
  <!-- 引入Bootstrap5 CSS -->
  <resource>
    <content-type>text/css</content-type>
    <href>/bootstrap5/bootstrap.min.css</href>
  </resource>
  <!-- 引入Bootstrap5 JS -->
  <resource>
    <content-type>text/javascript</content-type>
    <href>/bootstrap5/bootstrap.bundle.min.js</href>
  </resource>
</theme>

• 调整样式类适配：Bootstrap5与4存在部分类名变更（比如ml-*/mr-*改为ms-*/me-*，card-deck改为card-group），需逐一修改XPage中使用的Bootstrap类名，确保样式正常显示。
• 设置应用使用自定义主题：在应用的「应用属性」中，将主题设置为新建的bootstrap5主题，重启应用后生效。

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