Frames, Windows and Faces

There are several faces speedbar generates to provide a consistent color scheme across display types. You can customize these faces using your favorite method. They are:

speedbar-button-face

Face used on expand/contract buttons.

speedbar-file-face

Face used on Files. Should also be used on non-directory like nodes.

speedbar-directory-face

Face used for directories, or nodes which consist of groups of other nodes.

speedbar-tag-face

Face used for tags in a file, or for leaf items.

speedbar-selected-face

Face used to highlight the selected item. This would be the current file being edited.

speedbar-highlight-face

Face used when the mouse passes over a button.

You can also customize speedbar’s initial frame parameters by changing the alist speedbar-frame-parameters. This variable is used to set up initial details. Height is also automatically added when speedbar is created, though you can override it.

If the speedbar is displayed in a window, you can also customize the side on which the speedbar-window is displayed by changing the speedbar-window-side option.

The size of the speedbar-window, when opened on the left or right side, can be defined by changing the speedbar-window-default-width option, which defines the default window size. The width of the speedbar window can be greater than speedbar-window-max-width, but if it is closed and later reopened, the width will be equal to speedbar-window-max-width.

By default, speedbar-window is displayed in a dedicated window, so display-buffer will never use this window. Setting speedbar-window-dedicated-window to nil changes this behavior.