如何阻止JTextPane展示HTML内容时自动滚动到底部

JTextPane出现自动滚动到底部的核心原因是默认Caret组件的更新逻辑会在内容变更时将视口定位到Caret所在的末尾位置，可根据你的使用场景选择以下方案解决：

• 方案1：全局修改Caret更新策略（最常用）
  直接修改默认DefaultCaret的更新规则，彻底禁用内容更新触发的自动滚动行为，设置一次即可全局生效：

  JTextPane textPane = new JTextPane();
  // 配置为HTML展示模式
  textPane.setContentType("text/html");
  // 修改Caret更新策略
  DefaultCaret caret = (DefaultCaret) textPane.getCaret();
  caret.setUpdatePolicy(DefaultCaret.NEVER_UPDATE);
  

  该方案不会影响手动拖动滚动条、代码主动调用滚动方法的正常使用。

• 方案2：单次更新时临时保存恢复滚动位置
  如果你不需要全局禁用自动滚动，仅希望某次更新HTML内容时不触发滚动，可以在更新前后保存、恢复视口位置：

  JScrollPane scrollPane = new JScrollPane(textPane);
  // 保存更新前的视口位置
  Point prePosition = scrollPane.getViewport().getViewPosition();
  // 更新HTML内容
  textPane.setText("<html>你的新HTML内容</html>");
  // 等组件渲染完成后恢复原有位置
  SwingUtilities.invokeLater(() -> {
      scrollPane.getViewport().setViewPosition(prePosition);
  });
  

• 方案3：彻底禁用组件自动滚动
  如果你完全不需要JTextPane主动触发任何滚动行为，可以重写scrollRectToVisible方法：

  JTextPane textPane = new JTextPane() {
      @Override
      public void scrollRectToVisible(Rectangle rect) {
          // 空实现拦截所有自动滚动请求
      }
  };
  textPane.setContentType("text/html");
  

  该方案会拦截所有系统触发的自动滚动请求，手动滚动功能不受影响。

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