JLabel含Icon时文本换行、对齐问题及背景闪烁动画需求

问题场景 #

• 带背景Icon的短文本出现意外换行，需保持正常单行显示
• 无背景Icon的长文本需强制单行不换行
• Icon移除后文本对齐异常，需修正
• 需要背景闪烁动画的实现思路

相关代码 #

package test.client.swing.machine.view;

import java.awt.*;

import javax.swing.*;
import javax.swing.border.Border;
import javax.swing.border.EmptyBorder;

import test.client.swing.machine.view.ImageFactory.BorderType;

import static test.client.swing.machine.view.ComponentNameConstants.LABEL_VALUE_BUTTON_LABEL;
import static test.client.swing.machine.view.ComponentNameConstants.LABEL_VALUE_BUTTON_VALUE;


public class LabelValueButtonDynamic extends SimpleGraphicButton {

    protected final JLabel left = new JLabel();
    protected JLabel right = new JLabel();
    protected String label;
    protected Object value;
    protected boolean showBackground = true;

    public LabelValueButtonDynamic(ImageFactory imageFactory, String label, Object value, Border border,
                            String imageNamePattern, BorderType bType, int width) {
        super(imageFactory);
        try {
            loadDynamicImages(imageNamePattern, bType, width);
        } catch (IllegalArgumentException e) {
            loadStandardImages(imageNamePattern);
        }
        setBorder(border);
        init(label, value); //NOSONAR needs to be overrideable
    }

    public String getLabel() {
        return label;
    }

    public void setLabel(String label) {
        this.label = label;
        left.setText(label);
    }

    public Object getValue() {
        return value;
    }

    public void setValue(Object value) {
        this.value = value;
        right.setText(String.valueOf(value));
    }

    @Override
    public void setForeground(Color c) {
        super.setForeground(c);
        if (left != null) {
            left.setForeground(c);
        }
        if (right != null) {
            right.setForeground(Color.RED);
        }
        // repaint anscheinend nicht nötig
        // repaint();
    }

    @Override
    public void setFont(Font f) {
        super.setFont(f);
        if (left != null) {
            left.setFont(f);
        }
        if (right != null) {
            right.setFont(f);
        }
        // repaint anscheinend nicht nötig
        //repaint();
    }

    @Override
    public Font getFont() {
        return left != null ? left.getFont() : super.getFont();
    }

    protected void init(String label, Object value) {

        showBackground = true;
        setLabel(label);
        setValue(value);
        setLayout(new BoxLayout(this, BoxLayout.LINE_AXIS));
        if (getComponentOrientation().isHorizontal()) {
            //          add(Box.createHorizontalStrut(5));
            add(left);
            add(Box.createGlue());
            add(right);
            //          add(Box.createHorizontalStrut(15));

            left.setAlignmentY(0.5f); // XXX optimalen Wert für AlignmentY finden (0.5 ist zu weit oben)
            right.setAlignmentY(0.5f);
            right.setIcon(new ImageIcon(loadStandardImage("btn_bonus_radio_button_unselected.png",
                    null)));
            right.setHorizontalAlignment(0);
            right.setHorizontalTextPosition(0);
        } else {
            //          add(Box.createVerticalStrut(5));
            add(left);
            add(Box.createVerticalGlue());
            add(right);
            //          add(Box.createVerticalStrut(15));
        }
        left.setFont(Constants.getFontBold());
        left.setName(LABEL_VALUE_BUTTON_LABEL);
        right.setFont(Constants.getFontBoldMedium());
        right.setName(LABEL_VALUE_BUTTON_VALUE);
        right.setPreferredSize(right.getPreferredSize());
    }

    public void showCircle(boolean show){
        if(show){
            right.setIcon(new ImageIcon(loadStandardImage("btn_bonus_radio_button_unselected.png",
                    null)));
            right.setHorizontalAlignment(javax.swing.SwingConstants.CENTER);
            right.setHorizontalTextPosition(javax.swing.SwingConstants.CENTER);
        }
        else{
            right.setHorizontalAlignment(LEFT);
            right.setHorizontalTextPosition(LEFT);
            right.setIcon(null);
        }
        repaint();
    }
}

解决方案 #

一、文本换行与对齐修正 #

1. 带Icon短文本防换行

JLabel默认会在容器空间不足时自动换行，要强制单行显示，需修改init方法中对right的设置：

// 替换init方法中right的相关设置
right.setIcon(new ImageIcon(loadStandardImage("btn_bonus_radio_button_unselected.png", null)));
right.setHorizontalAlignment(SwingConstants.CENTER);
right.setHorizontalTextPosition(SwingConstants.CENTER);
right.setIconTextGap(6); // 调整图标与文本的间距，避免拥挤
// 设置最大宽度为无限大，让标签尽可能水平扩展，避免换行
right.setMaximumSize(new Dimension(Integer.MAX_VALUE, right.getPreferredSize().height));
// 移除固定PreferredSize的代码，让布局管理器自动计算空间
// right.setPreferredSize(right.getPreferredSize());

2. 无Icon长文本强制单行

修改showCircle方法，确保移除Icon后文本不换行且左对齐：

public void showCircle(boolean show){
    if(show){
        right.setIcon(new ImageIcon(loadStandardImage("btn_bonus_radio_button_unselected.png", null)));
        right.setHorizontalAlignment(SwingConstants.CENTER);
        right.setHorizontalTextPosition(SwingConstants.CENTER);
        right.setMaximumSize(new Dimension(Integer.MAX_VALUE, right.getPreferredSize().height));
    }
    else{
        right.setIcon(null);
        right.setHorizontalAlignment(SwingConstants.LEFT);
        right.setHorizontalTextPosition(SwingConstants.RIGHT); // 无图标时清除文本位置占位
        right.setMaximumSize(new Dimension(Integer.MAX_VALUE, right.getPreferredSize().height));
        right.setLineWrap(false); // 显式关闭自动换行
        right.setAutoscrolls(true); // 可选：文本过长时允许滚动查看
    }
    revalidate(); // 触发布局重新计算，替换单纯的repaint
    repaint();
}

3. Icon移除后的对齐修复

核心是在移除Icon时，将horizontalAlignment设为LEFT，同时取消对preferredSize的固定设置，让标签自适应容器的可用空间，确保文本左对齐且不被压缩换行。

二、背景闪烁动画实现思路 #

利用Swing的javax.swing.Timer定时切换背景状态，实现闪烁效果，步骤如下：

1. 定义Timer实例，设置闪烁间隔（比如500ms切换一次）
2. 在Timer的监听事件中，切换背景的显示状态（如切换背景色、背景图或透明度）
3. 提供启动/停止闪烁的方法，控制动画生命周期

示例代码片段：

private Timer blinkTimer;
private boolean isBgVisible = true;
private Color originalBg; // 保存原始背景色

// 初始化闪烁Timer
private void initBlinkTimer() {
    originalBg = getBackground();
    blinkTimer = new Timer(500, e -> {
        isBgVisible = !isBgVisible;
        // 根据状态切换背景：这里以背景色为例，也可以切换背景Icon
        setBackground(isBgVisible ? originalBg : new Color(originalBg.getRed(), originalBg.getGreen(), originalBg.getBlue(), 100));
        repaint();
    });
}

// 启动闪烁
public void startBlink() {
    if (blinkTimer != null && !blinkTimer.isRunning()) {
        blinkTimer.start();
    }
}

// 停止闪烁并恢复原始背景
public void stopBlink() {
    if (blinkTimer != null && blinkTimer.isRunning()) {
        blinkTimer.stop();
        isBgVisible = true;
        setBackground(originalBg);
        repaint();
    }
}

如果是自定义绘制背景（比如通过重写paintComponent），只需在绘制逻辑中根据isBgVisible状态决定是否绘制背景即可。

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