Class FlatLaf
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
FlatDarkLaf
,FlatLightLaf
,FlatPropertiesLaf
,IntelliJTheme.ThemeLaf
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescription(package private) static class
static interface
A provider for disabled icons.private class
private static class
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static boolean
private static final String
private PropertyChangeListener
private String
private String
private MnemonicHandler
static final Object
Special value returned by functions used inrunWithUIDefaultsGetter(Function, Runnable)
orregisterUIDefaultsGetter(Function)
to indicate that the UI value should becomenull
.private PopupFactory
private Consumer
<UIDefaults> private static String
private static String
private static String
private static String
private boolean
private static boolean
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription(package private) void
applyAdditionalDefaults
(UIDefaults defaults) static UIDefaults.ActiveValue
createActiveFontValue
(float scaleFactor) (package private) static FontUIResource
createCompositeFont
(String family, int style, int size) final boolean
private Object
protected Properties
getDisabledIcon
(JComponent component, Icon icon) Gets extra UI defaults; ornull
.Gets global extra UI defaults; ornull
.getID()
Returns the look and feel identifier.static String
Returns the preferred font family to be used for (nearly) all fonts; ornull
.static String
Returns the preferred font family to be used for "light" fonts; ornull
.static String
Returns the preferred font family to be used for monospaced fonts; ornull
.static String
Returns the preferred font family to be used for "semibold" fonts; ornull
.Returns information about styleable values of a component.static <T> T
getStyleableValue
(JComponent c, String key) Returns the (styled) value for the given key from the given component.boolean
Returns whether FlatLaf supports custom window decorations.Returns the system color getter function, ornull
.final int
hashCode()
static void
private void
initDefaultFont
(UIDefaults defaults) private void
initFonts
(UIDefaults defaults) void
private void
Initialize Aqua LaF on macOS, which is required for using Mac screen menubar.static void
initIconColors
(UIDefaults defaults, boolean dark) Adds the default color palette for action icons and object icons to the given UIDefaults.private void
initResourceBundle
(UIDefaults defaults, String bundleName) static boolean
install
(LookAndFeel newLookAndFeel) Deprecated.static void
installLafInfo
(String lafName, Class<? extends LookAndFeel> lafClass) Adds the given look and feel to the set of available look and feels.abstract boolean
isDark()
private static boolean
static boolean
Checks whether the current look and feel is dark.boolean
static boolean
boolean
static boolean
Returns whether native window decorations are enabled.static Object
parseDefaultsValue
(String key, String value, Class<?> valueType) Parses a UI defaults value string and converts it into a binary object.private void
putAATextInfo
(UIDefaults defaults) private void
putDefaults
(UIDefaults defaults, Object value, String... keys) static void
registerCustomDefaultsSource
(File folder) Registers a folder where FlatLaf searches for properties files with custom UI defaults.static void
registerCustomDefaultsSource
(String packageName) Registers a package where FlatLaf searches for properties files with custom UI defaults.static void
registerCustomDefaultsSource
(String packageName, ClassLoader classLoader) Registers a package where FlatLaf searches for properties files with custom UI defaults.static void
registerCustomDefaultsSource
(URL packageUrl) Registers a package where FlatLaf searches for properties files with custom UI defaults.void
registerUIDefaultsGetter
(Function<Object, Object> uiDefaultsGetter) Registers a UI defaults getter function that is invoked before the standard getter.static void
Repaint all displayable frames and dialogs.private static void
static void
Revalidate and repaint all displayable frames and dialogs.static void
runWithUIDefaultsGetter
(Function<Object, Object> uiDefaultsGetter, Runnable runnable) Registers a UI defaults getter function that is invoked before the standard getter, runs the given runnable and unregisters the UI defaults getter function again.void
setExtraDefaults
(Map<String, String> extraDefaults) Sets extra UI defaults, which are only used when setting up the application look and feel.static void
setGlobalExtraDefaults
(Map<String, String> globalExtraDefaults) Sets global extra UI defaults, which are only used when setting up the application look and feel.static void
setPreferredFontFamily
(String preferredFontFamily) Sets the preferred font family to be used for (nearly) all fonts.static void
setPreferredLightFontFamily
(String preferredLightFontFamily) Sets the preferred font family to be used for "light" fonts.static void
setPreferredMonospacedFontFamily
(String preferredMonospacedFontFamily) Sets the preferred font family to be used for monospaced fonts.static void
setPreferredSemiboldFontFamily
(String preferredSemiboldFontFamily) Sets the preferred font family to be used for "semibold" fonts.static void
setSystemColorGetter
(Function<String, Color> systemColorGetter) Sets a system color getter function that is invoked when functionsystemColor()
is used in FlatLaf properties files.static boolean
setup
(LookAndFeel newLookAndFeel) Sets the application look and feel to the given LaF usingUIManager.setLookAndFeel(javax.swing.LookAndFeel)
.static void
setUseNativeWindowDecorations
(boolean enabled) Sets whether native window decorations are enabled.static void
static boolean
Returns whether native window decorations are supported on current platform.void
static void
unregisterCustomDefaultsSource
(File folder) static void
unregisterCustomDefaultsSource
(String packageName) static void
unregisterCustomDefaultsSource
(String packageName, ClassLoader classLoader) static void
unregisterCustomDefaultsSource
(URL packageUrl) void
unregisterUIDefaultsGetter
(Function<Object, Object> uiDefaultsGetter) Unregisters a UI defaults getter function that was invoked before the standard getter.static void
updateUI()
Update UI of all application windows immediately.static void
Update UI of all application windows later.Methods inherited from class javax.swing.plaf.basic.BasicLookAndFeel
createAudioAction, getAudioActionMap, initClassDefaults, initComponentDefaults, initSystemColorDefaults, loadSystemColors, playSound
Methods inherited from class javax.swing.LookAndFeel
getDescription, getDesktopPropertyValue, getDisabledSelectedIcon, getLayoutStyle, getName, installBorder, installColors, installColorsAndFont, installProperty, loadKeyBindings, makeComponentInputMap, makeIcon, makeInputMap, makeKeyBindings, provideErrorFeedback, toString, uninstallBorder
-
Field Details
-
DESKTOPFONTHINTS
- See Also:
-
customDefaultsSources
-
globalExtraDefaults
-
extraDefaults
-
systemColorGetter
-
desktopPropertyName
-
desktopPropertyName2
-
desktopPropertyListener
-
aquaLoaded
private static boolean aquaLoaded -
updateUIPending
private static boolean updateUIPending -
oldPopupFactory
-
mnemonicHandler
-
subMenuUsabilityHelperInstalled
private boolean subMenuUsabilityHelperInstalled -
postInitialization
-
uiDefaultsGetters
-
preferredFontFamily
-
preferredLightFontFamily
-
preferredSemiboldFontFamily
-
preferredMonospacedFontFamily
-
NULL_VALUE
Special value returned by functions used inrunWithUIDefaultsGetter(Function, Runnable)
orregisterUIDefaultsGetter(Function)
to indicate that the UI value should becomenull
.- Since:
- 1.6
- See Also:
-
-
Constructor Details
-
FlatLaf
public FlatLaf()
-
-
Method Details
-
setup
Sets the application look and feel to the given LaF usingUIManager.setLookAndFeel(javax.swing.LookAndFeel)
.- Since:
- 1.2
-
install
Deprecated.usesetup(LookAndFeel)
instead; this method will be removed in a future version -
installLafInfo
Adds the given look and feel to the set of available look and feels.Useful if your application uses
UIManager.getInstalledLookAndFeels()
to query available LaFs and display them to the user in a combobox. -
getID
Returns the look and feel identifier.Syntax: "FlatLaf - ${theme-name}"
Use
UIManager.getLookAndFeel().getID().startsWith( "FlatLaf" )
to check whether the current look and feel is FlatLaf.- Specified by:
getID
in classLookAndFeel
-
isDark
public abstract boolean isDark() -
isLafDark
public static boolean isLafDark()Checks whether the current look and feel is dark. -
getSupportsWindowDecorations
public boolean getSupportsWindowDecorations()Returns whether FlatLaf supports custom window decorations. This depends on the operating system and on the used Java runtime.This method returns
true
on Windows 10/11 (see exception below) and on Linux, otherwise returnsfalse
.Returns also
false
on Windows 10/11 if FlatLaf native window border support is available (requires Windows 10/11).In these cases, custom decorations are enabled by the root pane. Usage of
JFrame.setDefaultLookAndFeelDecorated(boolean)
orJDialog.setDefaultLookAndFeelDecorated(boolean)
is not necessary.- Overrides:
getSupportsWindowDecorations
in classLookAndFeel
-
isNativeLookAndFeel
public boolean isNativeLookAndFeel()- Specified by:
isNativeLookAndFeel
in classLookAndFeel
-
isSupportedLookAndFeel
public boolean isSupportedLookAndFeel()- Specified by:
isSupportedLookAndFeel
in classLookAndFeel
-
getDisabledIcon
- Overrides:
getDisabledIcon
in classLookAndFeel
-
initialize
public void initialize()- Overrides:
initialize
in classBasicLookAndFeel
-
uninitialize
public void uninitialize()- Overrides:
uninitialize
in classBasicLookAndFeel
-
initializeAqua
private void initializeAqua()Initialize Aqua LaF on macOS, which is required for using Mac screen menubar. (at least on Java 8, since 9 it seems to work without it)This loads the native library "osxui" and initializes JRSUI. Because both are not unloaded/uninitialized, Aqua LaF is initialized only once.
-
getDefaults
- Overrides:
getDefaults
in classBasicLookAndFeel
-
applyAdditionalDefaults
-
getLafClassesForDefaultsLoading
-
getAdditionalDefaults
-
initResourceBundle
-
initFonts
-
initDefaultFont
-
createCompositeFont
-
createActiveFontValue
- Since:
- 1.1
-
initIconColors
Adds the default color palette for action icons and object icons to the given UIDefaults.This method is public and static to allow using the color palette with other LaFs (e.g. Windows LaF). To do so invoke:
FlatLaf.initIconColors( UIManager.getLookAndFeelDefaults(), false );
afterUIManager.setLookAndFeel( ... );
.The colors are based on IntelliJ Platform Action icons and Noun icons
These colors may be changed by IntelliJ Platform themes.
-
putAATextInfo
-
fallbackAATextInfo
-
putDefaults
-
getCustomDefaultsSources
-
registerCustomDefaultsSource
Registers a package where FlatLaf searches for properties files with custom UI defaults.This can be used to specify application specific UI defaults that override UI values of existing themes or to define own UI values used in custom controls.
There may be multiple properties files in that package for multiple themes. The properties file name must match the used theme class names. E.g.
FlatLightLaf.properties
for classFlatLightLaf
orFlatDarkLaf.properties
for classFlatDarkLaf
.FlatLaf.properties
is loaded first for all themes.These properties files are loaded after theme and addon properties files and can therefore override all UI defaults.
Invoke this method before setting the look and feel.
If using Java modules, the package must be opened in
module-info.java
. Otherwise, useregisterCustomDefaultsSource(URL)
.- Parameters:
packageName
- a package name (e.g. "com.myapp.resources")
-
unregisterCustomDefaultsSource
-
registerCustomDefaultsSource
Registers a package where FlatLaf searches for properties files with custom UI defaults.See
registerCustomDefaultsSource(String)
for details.- Parameters:
packageName
- a package name (e.g. "com.myapp.resources")classLoader
- a class loader used to find resources, ornull
-
unregisterCustomDefaultsSource
-
registerCustomDefaultsSource
Registers a package where FlatLaf searches for properties files with custom UI defaults.See
registerCustomDefaultsSource(String)
for details.This method is useful if using Java modules and the package containing the properties files is not opened in
module-info.java
. E.g.FlatLaf.registerCustomDefaultsSource( MyApp.class.getResource( "/com/myapp/themes/" ) )
.- Parameters:
packageUrl
- a package URL- Since:
- 2
-
unregisterCustomDefaultsSource
- Since:
- 2
-
registerCustomDefaultsSource
Registers a folder where FlatLaf searches for properties files with custom UI defaults.See
registerCustomDefaultsSource(String)
for details.- Parameters:
folder
- a folder
-
unregisterCustomDefaultsSource
-
getGlobalExtraDefaults
Gets global extra UI defaults; ornull
.- Since:
- 2
-
setGlobalExtraDefaults
Sets global extra UI defaults, which are only used when setting up the application look and feel. E.g. usingUIManager.setLookAndFeel(LookAndFeel)
orsetup(LookAndFeel)
.The global extra defaults are useful for smaller additional defaults that may change. Otherwise, FlatLaf properties files should be used. See
registerCustomDefaultsSource(String)
.The keys and values are strings in same format as in FlatLaf properties files.
Sample that setups "FlatLaf Light" theme with white background color:
FlatLaf.setGlobalExtraDefaults( Collections.singletonMap( "@background", "#fff" ) ); FlatLightLaf.setup();
- Since:
- 2
- See Also:
-
getExtraDefaults
Gets extra UI defaults; ornull
.- Since:
- 2
-
setExtraDefaults
Sets extra UI defaults, which are only used when setting up the application look and feel. E.g. usingUIManager.setLookAndFeel(LookAndFeel)
orsetup(LookAndFeel)
.The extra defaults are useful for smaller additional defaults that may change. Otherwise, FlatLaf properties files should be used. See
registerCustomDefaultsSource(String)
.The keys and values are strings in same format as in FlatLaf properties files.
Sample that setups "FlatLaf Light" theme with white background color:
FlatLaf laf = new FlatLightLaf(); laf.setExtraDefaults( Collections.singletonMap( "@background", "#fff" ) ); FlatLaf.setup( laf );
- Since:
- 2
- See Also:
-
parseDefaultsValue
public static Object parseDefaultsValue(String key, String value, Class<?> valueType) throws IllegalArgumentException Parses a UI defaults value string and converts it into a binary object.- Parameters:
key
- the key, which is used to determine the value type if parametervalueType
isnull
value
- the value stringvalueType
- the expected value type, ornull
- Returns:
- the binary value
- Throws:
IllegalArgumentException
- on syntax errors- Since:
- 2
-
getSystemColorGetter
Returns the system color getter function, ornull
.- Since:
- 3
-
setSystemColorGetter
Sets a system color getter function that is invoked when functionsystemColor()
is used in FlatLaf properties files.The name of the system color is passed as parameter to the function. The function should return
null
for unknown system colors.Can be used to change the accent color:
FlatLaf.setSystemColorGetter( name -> { return name.equals( "accent" ) ? Color.red : null; } ); FlatLightLaf.setup();
- Since:
- 3
-
reSetLookAndFeel
private static void reSetLookAndFeel() -
updateUI
public static void updateUI()Update UI of all application windows immediately. Invoke after changing LaF. -
updateUILater
public static void updateUILater()Update UI of all application windows later. -
supportsNativeWindowDecorations
public static boolean supportsNativeWindowDecorations()Returns whether native window decorations are supported on current platform.This requires Windows 10/11, but may be disabled if running in special environments (JetBrains Projector, Webswing or WinPE) or if loading native library fails. If system property
FlatSystemProperties.USE_WINDOW_DECORATIONS
is set tofalse
, then this method also returnsfalse
.- Since:
- 1.1.2
-
isUseNativeWindowDecorations
public static boolean isUseNativeWindowDecorations()Returns whether native window decorations are enabled.- Since:
- 1.1.2
-
setUseNativeWindowDecorations
public static void setUseNativeWindowDecorations(boolean enabled) Sets whether native window decorations are enabled.Existing frames and dialogs will be updated.
- Since:
- 1.1.2
-
revalidateAndRepaintAllFramesAndDialogs
public static void revalidateAndRepaintAllFramesAndDialogs()Revalidate and repaint all displayable frames and dialogs.Useful to update UI after changing
TitlePane.menuBarEmbedded
.- Since:
- 1.1.2
-
repaintAllFramesAndDialogs
public static void repaintAllFramesAndDialogs()Repaint all displayable frames and dialogs.Useful to update UI after changing
TitlePane.unifiedBackground
,MenuItem.selectionType
orComponent.hideMnemonics
.- Since:
- 1.1.2
-
isDisplayableFrameOrDialog
-
isShowMnemonics
public static boolean isShowMnemonics() -
showMnemonics
-
hideMnemonics
public static void hideMnemonics() -
equals
-
hashCode
public final int hashCode() -
registerUIDefaultsGetter
Registers a UI defaults getter function that is invoked before the standard getter. This allows using different UI defaults for special purposes (e.g. using multiple themes at the same time).The key is passed as parameter to the function. If the function returns
null
, then the next registered function is invoked. If all registered functions returnnull
, then the current look and feel is asked. If the function returnsNULL_VALUE
, then the UI value becomesnull
.- Since:
- 1.6
- See Also:
-
unregisterUIDefaultsGetter
Unregisters a UI defaults getter function that was invoked before the standard getter.- Since:
- 1.6
- See Also:
-
runWithUIDefaultsGetter
public static void runWithUIDefaultsGetter(Function<Object, Object> uiDefaultsGetter, Runnable runnable) Registers a UI defaults getter function that is invoked before the standard getter, runs the given runnable and unregisters the UI defaults getter function again. This allows using different UI defaults for special purposes (e.g. using multiple themes at the same time). If the current look and feel is not FlatLaf, then the getter is ignored and the given runnable invoked.The key is passed as parameter to the function. If the function returns
null
, then the next registered function is invoked. If all registered functions returnnull
, then the current look and feel is asked. If the function returnsNULL_VALUE
, then the UI value becomesnull
.Example:
// create secondary theme UIDefaults darkDefaults = new FlatDarkLaf().getDefaults(); // create panel using secondary theme FlatLaf.runWithUIDefaultsGetter( key -> { Object value = darkDefaults.get( key ); return (value != null) ? value : FlatLaf.NULL_VALUE; }, () -> { // TODO create components that should use secondary theme here } );
- Since:
- 1.6
- See Also:
-
getStyleableInfos
Returns information about styleable values of a component.This is equivalent to:
((StyleableUI)c.getUI()).getStyleableInfos(c)
- Since:
- 2.5
-
getStyleableValue
Returns the (styled) value for the given key from the given component.This is equivalent to:
((StyleableUI)c.getUI()).getStyleableValue(c, key)
- Since:
- 2.5
-
getPreferredFontFamily
Returns the preferred font family to be used for (nearly) all fonts; ornull
.- Since:
- 3
-
setPreferredFontFamily
Sets the preferred font family to be used for (nearly) all fonts.Note: This must be invoked before setting the application look and feel.
- Since:
- 3
-
getPreferredLightFontFamily
Returns the preferred font family to be used for "light" fonts; ornull
.- Since:
- 3
-
setPreferredLightFontFamily
Sets the preferred font family to be used for "light" fonts.Note: This must be invoked before setting the application look and feel.
- Since:
- 3
-
getPreferredSemiboldFontFamily
Returns the preferred font family to be used for "semibold" fonts; ornull
.- Since:
- 3
-
setPreferredSemiboldFontFamily
Sets the preferred font family to be used for "semibold" fonts.Note: This must be invoked before setting the application look and feel.
- Since:
- 3
-
getPreferredMonospacedFontFamily
Returns the preferred font family to be used for monospaced fonts; ornull
.- Since:
- 3
-
setPreferredMonospacedFontFamily
Sets the preferred font family to be used for monospaced fonts.Note: This must be invoked before setting the application look and feel.
- Since:
- 3
-
setup(LookAndFeel)
instead; this method will be removed in a future version