如何实现Java Swing中动态多行Tooltip不被屏幕边缘截断？

方案1：利用HTML自动换行（推荐） #

Swing支持Tooltip使用HTML格式，可将动态生成的文本包裹在带宽度限制的HTML标签中，让渲染器自动处理换行，无需手动插入<br>标签。

实现时可封装工具方法，将原始文本转换为带样式的HTML内容，宽度可参考屏幕比例设置，避免低分辨率屏幕下的截断问题：

package demos.text.field;

import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JTextField;
import javax.swing.WindowConstants;
import java.awt.Container;
import java.awt.Toolkit;

public class TextFieldDemo {
    public static void main(String[] args) {
        Container mainPanel = createMainPanel();
        JFrame frame = new JFrame("Text field demo");
        frame.setContentPane(mainPanel);
        frame.setLocationRelativeTo(null);
        frame.pack();
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }

    private static JPanel createMainPanel() {
        JPanel panel = new JPanel();
        panel.add(createTextField());
        return panel;
    }

    private static JTextField createTextField() {
        JTextField textField = new JTextField("Text field with a tooltip");
        String longTooltip = "A " + "very ".repeat(10) + "long tooltip that must be split";
        // 转换为带自动换行的HTML tooltip
        textField.setToolTipText(wrapTooltipForAutoWrap(longTooltip));
        return textField;
    }

    // 工具方法：包裹文本为自动换行的HTML
    private static String wrapTooltipForAutoWrap(String text) {
        // 设置tooltip最大宽度为屏幕的1/3（可按需调整）
        int screenWidth = Toolkit.getDefaultToolkit().getScreenSize().width;
        int maxWidth = screenWidth / 3;
        return String.format("<html><body style='width: %dpx;'>%s</body></html>", maxWidth, text);
    }
}

该方案依赖Swing内置HTML渲染能力，无需手动计算文本换行位置，简单高效且扩展性强，还可额外定制字体、颜色等样式。

方案2：自定义JToolTip组件 #

若不想使用HTML，可重写组件的createToolTip方法，返回开启换行属性的JToolTip：

private static JTextField createTextField() {
    JTextField textField = new JTextField("Text field with a tooltip") {
        @Override
        public JToolTip createToolTip() {
            JToolTip tip = super.createToolTip();
            // 开启自动换行并设置最大宽度
            tip.setMaximumSize(new Dimension(300, Integer.MAX_VALUE));
            tip.setWrapStyleWord(true);
            tip.setLineWrap(true);
            return tip;
        }
    };
    String longTooltip = "A " + "very ".repeat(10) + "long tooltip that must be split";
    textField.setToolTipText(longTooltip);
    return textField;
}

注意：部分LookAndFeel可能会忽略lineWrap和wrapStyleWord属性，兼容性不如HTML方案。

关键注意事项 #

• 动态文本无需手动处理换行逻辑，交给HTML渲染器或自定义Tooltip组件即可。
• 宽度设置建议参考屏幕尺寸，避免低分辨率屏幕下的截断。

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