如何在JTextPane中垂直排列ImageIcon（逐个上下显示）

修复JTextPane的换行问题 #

你用jTextPane.setText("\n")会清空所有内容，因为这个方法是替换整个文档内容，而非追加换行。正确做法是通过StyledDocument来追加换行元素，在插入每个图片后添加换行：

import javax.swing.text.BadLocationException;
import javax.swing.text.StyledDocument;

public static void insertImage(BufferedImage img, JTextPane jTextPane) {
    ImageIcon icon = new ImageIcon(img);
    StyledDocument doc = jTextPane.getStyledDocument();
    
    try {
        // 插入图片
        jTextPane.insertIcon(icon);
        // 在图片后追加换行
        doc.insertString(doc.getLength(), "\n", null);
    } catch (BadLocationException e) {
        e.printStackTrace();
    }
}

每次插入图片后会自动添加换行，新图片将显示在上一个下方，避免横向滚动。若需要更大间距，可将"\n"替换为"\n\n"。

推荐替代组件：JPanel + BoxLayout #

如果需要混合展示图片与其他数据，JPanel配合垂直布局比JTextPane更直观易维护，无需处理Swing文档模型的复杂逻辑：

初始化布局 #

import javax.swing.*;
import java.awt.*;

// 创建垂直排列的内容面板
JPanel contentPanel = new JPanel();
contentPanel.setLayout(new BoxLayout(contentPanel, BoxLayout.Y_AXIS));
// 包裹滚动面板以支持滚动
JScrollPane scrollPane = new JScrollPane(contentPanel);
scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);

添加图片和文本的方法 #

// 添加图片
public static void addImage(BufferedImage img, JPanel panel) {
    ImageIcon icon = new ImageIcon(img);
    JLabel imgLabel = new JLabel(icon);
    // 给图片添加边距优化显示
    imgLabel.setBorder(BorderFactory.createEmptyBorder(8, 8, 8, 8));
    panel.add(imgLabel);
    // 通知面板更新布局
    panel.revalidate();
    panel.repaint();
}

// 添加文本
public static void addText(String text, JPanel panel) {
    JLabel textLabel = new JLabel(text);
    textLabel.setBorder(BorderFactory.createEmptyBorder(4, 8, 4, 8));
    panel.add(textLabel);
    panel.revalidate();
    panel.repaint();
}

该方案优势：

• 布局逻辑清晰，可灵活调整图片、文本的间距与对齐方式
• 无需处理文档模型的异常与复杂操作
• 扩展性更强，比如可为图片添加点击事件、右键菜单等交互

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