Setting Component Backgrounds

When you lay out a Swing interface, components often end up crowded against the edges of their containers. A panel full of buttons can have its buttons touching the panel's boundary, and a text label can sit flush against the edge of its own area. Swing provides static methods in the BorderFactory class to create borders, and one of the most practical of these is createEmptyBorder, which adds an invisible margin of space around a component.

The word empty is literal. The border does not paint a line, a bevel, or a pattern. It only reserves room. Because nothing is drawn in that reserved room, whatever background color the component has will fill the space. This is the key idea to hold onto: the border adds space, and the component's own background shows through that space.

Read the diagram from the outside in. The component's full bounds include the reserved margin. Inside that margin is the empty border space, which paints nothing. The background color is the only thing that appears there. The content area is the smaller region left after the margin is removed, and it is where the component's own material, such as text or nested components, is placed.

The method takes four parameters, and they are always given in the same order: top, left, bottom, right. Each parameter is an integer that gives the width of the border along that edge of the component. Because the order is fixed, the first number always controls the top edge, the second the left edge, the third the bottom edge, and the fourth the right edge.

Each integer is a width, so a larger number reserves more room on that edge. A value of zero on an edge reserves nothing along that side. Because the parameters are positional, swapping two numbers changes the layout even though the call still looks plausible.

The same reasoning applies to any container. Whatever the container's background is, it shows through the reserved margin, and whatever it holds is laid out within the smaller content area.

The source gives a second common use: a JLabel. Without an empty border, a label does not have any space between its text and the edge of the label. Adding an empty border creates that space, so the text no longer touches the boundary of the label's area.

The text itself does not change. What changes is the content area it is placed in. The empty border reserves room on the edges, so the label's text is laid out within the smaller region and stays clear of the boundary.

Most errors with createEmptyBorder come from misreading the fixed parameter order or from assuming the border is visible. The items below show the mistakes that most often lead learners to unexpected layouts.