编辑“︁Java标签”︁（章节）

== Java标签（JLabel） ==

'''Java标签'''（JLabel）是Swing组件库中最基础的GUI组件之一，用于显示不可编辑的文本、图像或两者组合。它通常用于标识其他组件（如文本框、下拉框）或提供界面说明信息。

=== 基本特性 ===
* 继承自<code>javax.swing.JComponent</code>
* 默认透明背景（可通过<code>setOpaque(true)</code>设为不透明）
* 支持HTML格式化文本（以<code>&lt;html&gt;</code>开头）
* 支持文本与图标的多种对齐方式

=== 构造函数 ===
{| class="wikitable"
|-
! 构造函数 !! 描述
|-
| <code>JLabel()</code> || 创建空标签
|-
| <code>JLabel(String text)</code> || 创建带文本的标签
|-
| <code>JLabel(Icon image)</code> || 创建带图标的标签
|-
| <code>JLabel(String text, Icon icon, int horizontalAlignment)</code> || 创建包含文本、图标并指定对齐方式的标签
|}

=== 基础示例 ===
以下示例展示如何创建简单的文本标签：

<syntaxhighlight lang="java">
import javax.swing.*;

public class BasicLabelExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("标签示例");
        JLabel label = new JLabel("欢迎学习Java GUI编程！");
        
        // 设置标签属性
        label.setHorizontalAlignment(SwingConstants.CENTER);
        frame.add(label);
        
        frame.setSize(300, 200);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }
}
</syntaxhighlight>

'''输出效果'''：窗口中央显示居中对齐的文本"欢迎学习Java GUI编程！"

=== 进阶功能 ===

==== 1. 图标与文本组合 ====
<syntaxhighlight lang="java">
// 创建带图标的标签
ImageIcon icon = new ImageIcon("path/to/icon.png");
JLabel label = new JLabel("带图标的标签", icon, SwingConstants.LEFT);

// 设置文本相对于图标的位置
label.setVerticalTextPosition(SwingConstants.BOTTOM);
label.setHorizontalTextPosition(SwingConstants.CENTER);
</syntaxhighlight>

==== 2. HTML格式化 ====
<syntaxhighlight lang="java">
JLabel htmlLabel = new JLabel("<html><b>粗体</b> <i>斜体</i> <font color='red'>红色文本</font></html>");
</syntaxhighlight>

==== 3. 动态更新 ====
<syntaxhighlight lang="java">
// 创建计数器标签
JLabel counterLabel = new JLabel("计数: 0");

// 更新标签文本
int count = 0;
timer = new Timer(1000, e -> {
    count++;
    counterLabel.setText("计数: " + count);
});
timer.start();
</syntaxhighlight>

=== 对齐方式详解 ===
通过<code>setHorizontalAlignment()</code>和<code>setVerticalAlignment()</code>控制对齐：

<mermaid>
pie
    title 水平对齐方式占比
    "LEFT" : 35
    "CENTER" : 45
    "RIGHT" : 20
</mermaid>

常用对齐常量：
* <code>SwingConstants.LEFT/RIGHT/CENTER</code>
* <code>SwingConstants.TOP/BOTTOM</code>

=== 实际应用案例 ===
'''用户登录界面'''中的标签使用：

<syntaxhighlight lang="java">
JPanel loginPanel = new JPanel(new GridLayout(3, 2));
loginPanel.add(new JLabel("用户名:"));
loginPanel.add(new JTextField());
loginPanel.add(new JLabel("密码:"));
loginPanel.add(new JPasswordField());
loginPanel.add(new JLabel()); // 空白标签占位
loginPanel.add(new JButton("登录"));
</syntaxhighlight>

=== 性能优化建议 ===
1. 避免频繁更新标签内容（特别是含HTML的标签）
2. 对于静态内容，设置<code>setEnabled(false)</code>可减少渲染开销
3. 大量标签时考虑使用<code>JLayer</code>进行批量管理

=== 数学公式应用 ===
当标签用于显示数学公式时（需配合HTML）：

<math>E = mc^2</math> 可表示为：
<syntaxhighlight lang="java">
JLabel mathLabel = new JLabel("<html>E = mc<sup>2</sup></html>");
</syntaxhighlight>

=== 常见问题解答 ===
'''Q: 为什么我的标签不显示？'''
A: 可能原因：
* 忘记将标签添加到容器
* 容器布局管理器覆盖了标签尺寸
* 文本颜色与背景相同

'''Q: 如何实现多行文本？'''
A: 使用HTML换行标签：
<syntaxhighlight lang="java">
new JLabel("<html>第一行<br>第二行</html>");
</syntaxhighlight>

=== 扩展阅读 ===
* 深入理解Swing组件层次结构
* 自定义标签渲染器（LabelUI）
* 国际化文本在标签中的应用

{{Java GUI组件}}

[[Category:编程语言]]
[[Category:Java]]
[[Category:Java GUI编程]]