Class FlatLaf
- java.lang.Object
-
- javax.swing.LookAndFeel
-
- javax.swing.plaf.basic.BasicLookAndFeel
-
- com.formdev.flatlaf.FlatLaf
-
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
FlatDarkLaf,FlatLightLaf,FlatPropertiesLaf,IntelliJTheme.ThemeLaf
public abstract class FlatLaf extends BasicLookAndFeel
The base class for all Flat LaFs.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceFlatLaf.DisabledIconProviderA provider for disabled icons.
-
Field Summary
Fields Modifier and Type Field Description static ObjectNULL_VALUESpecial value returned by functions used inrunWithUIDefaultsGetter(Function, Runnable)orregisterUIDefaultsGetter(Function)to indicate that the UI value should becomenull.
-
Constructor Summary
Constructors Constructor Description FlatLaf()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static UIDefaults.ActiveValuecreateActiveFontValue(float scaleFactor)booleanequals(Object obj)protected PropertiesgetAdditionalDefaults()UIDefaultsgetDefaults()IcongetDisabledIcon(JComponent component, Icon icon)Map<String,String>getExtraDefaults()Gets extra UI defaults; ornull.static Map<String,String>getGlobalExtraDefaults()Gets global extra UI defaults; ornull.StringgetID()Returns the look and feel identifier.protected List<Class<?>>getLafClassesForDefaultsLoading()static StringgetPreferredFontFamily()Returns the preferred font family to be used for (nearly) all fonts; ornull.static StringgetPreferredLightFontFamily()Returns the preferred font family to be used for "light" fonts; ornull.static StringgetPreferredMonospacedFontFamily()Returns the preferred font family to be used for monospaced fonts; ornull.static StringgetPreferredSemiboldFontFamily()Returns the preferred font family to be used for "semibold" fonts; ornull.static Map<String,Class<?>>getStyleableInfos(JComponent c)Returns information about styleable values of a component.static <T> TgetStyleableValue(JComponent c, String key)Returns the (styled) value for the given key from the given component.booleangetSupportsWindowDecorations()Returns whether FlatLaf supports custom window decorations.static Function<String,Color>getSystemColorGetter()Returns the system color getter function, ornull.inthashCode()static voidhideMnemonics()voidinitialize()static voidinitIconColors(UIDefaults defaults, boolean dark)Adds the default color palette for action icons and object icons to the given UIDefaults.static booleaninstall(LookAndFeel newLookAndFeel)Deprecated.usesetup(LookAndFeel)instead; this method will be removed in a future versionstatic voidinstallLafInfo(String lafName, Class<? extends LookAndFeel> lafClass)Adds the given look and feel to the set of available look and feels.abstract booleanisDark()static booleanisLafDark()Checks whether the current look and feel is dark.booleanisNativeLookAndFeel()static booleanisShowMnemonics()booleanisSupportedLookAndFeel()static booleanisUseNativeWindowDecorations()Returns whether native window decorations are enabled.static ObjectparseDefaultsValue(String key, String value, Class<?> valueType)Parses a UI defaults value string and converts it into a binary object.static voidregisterCustomDefaultsSource(File folder)Registers a folder where FlatLaf searches for properties files with custom UI defaults.static voidregisterCustomDefaultsSource(String packageName)Registers a package where FlatLaf searches for properties files with custom UI defaults.static voidregisterCustomDefaultsSource(String packageName, ClassLoader classLoader)Registers a package where FlatLaf searches for properties files with custom UI defaults.static voidregisterCustomDefaultsSource(URL packageUrl)Registers a package where FlatLaf searches for properties files with custom UI defaults.voidregisterUIDefaultsGetter(Function<Object,Object> uiDefaultsGetter)Registers a UI defaults getter function that is invoked before the standard getter.static voidrepaintAllFramesAndDialogs()Repaint all displayable frames and dialogs.static voidrevalidateAndRepaintAllFramesAndDialogs()Revalidate and repaint all displayable frames and dialogs.static voidrunWithUIDefaultsGetter(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.voidsetExtraDefaults(Map<String,String> extraDefaults)Sets extra UI defaults, which are only used when setting up the application look and feel.static voidsetGlobalExtraDefaults(Map<String,String> globalExtraDefaults)Sets global extra UI defaults, which are only used when setting up the application look and feel.static voidsetPreferredFontFamily(String preferredFontFamily)Sets the preferred font family to be used for (nearly) all fonts.static voidsetPreferredLightFontFamily(String preferredLightFontFamily)Sets the preferred font family to be used for "light" fonts.static voidsetPreferredMonospacedFontFamily(String preferredMonospacedFontFamily)Sets the preferred font family to be used for monospaced fonts.static voidsetPreferredSemiboldFontFamily(String preferredSemiboldFontFamily)Sets the preferred font family to be used for "semibold" fonts.static voidsetSystemColorGetter(Function<String,Color> systemColorGetter)Sets a system color getter function that is invoked when functionsystemColor()is used in FlatLaf properties files.static booleansetup(LookAndFeel newLookAndFeel)Sets the application look and feel to the given LaF usingUIManager.setLookAndFeel(javax.swing.LookAndFeel).static voidsetUseNativeWindowDecorations(boolean enabled)Sets whether native window decorations are enabled.static voidshowMnemonics(Component c)static booleansupportsNativeWindowDecorations()Returns whether native window decorations are supported on current platform.voiduninitialize()static voidunregisterCustomDefaultsSource(File folder)static voidunregisterCustomDefaultsSource(String packageName)static voidunregisterCustomDefaultsSource(String packageName, ClassLoader classLoader)static voidunregisterCustomDefaultsSource(URL packageUrl)voidunregisterUIDefaultsGetter(Function<Object,Object> uiDefaultsGetter)Unregisters a UI defaults getter function that was invoked before the standard getter.static voidupdateUI()Update UI of all application windows immediately.static voidupdateUILater()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 Detail
-
NULL_VALUE
public static final Object 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:
runWithUIDefaultsGetter(Function, Runnable),registerUIDefaultsGetter(Function)
-
-
Method Detail
-
setup
public static boolean setup(LookAndFeel newLookAndFeel)
Sets the application look and feel to the given LaF usingUIManager.setLookAndFeel(javax.swing.LookAndFeel).- Since:
- 1.2
-
install
@Deprecated public static boolean install(LookAndFeel newLookAndFeel)
Deprecated.usesetup(LookAndFeel)instead; this method will be removed in a future version
-
installLafInfo
public static void installLafInfo(String lafName, Class<? extends LookAndFeel> lafClass)
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
public String 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:
getIDin 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
trueon Windows 10/11 (see exception below) and on Linux,falseotherwise.Returns also
falseon Windows 10/11 if:- FlatLaf native window border support is available (requires Windows 10/11)
- running in JetBrains Runtime 11 (or later) (source code on github) and JBR supports custom window decorations
JFrame.setDefaultLookAndFeelDecorated(boolean)orJDialog.setDefaultLookAndFeelDecorated(boolean)is not necessary.- Overrides:
getSupportsWindowDecorationsin classLookAndFeel
-
isNativeLookAndFeel
public boolean isNativeLookAndFeel()
- Specified by:
isNativeLookAndFeelin classLookAndFeel
-
isSupportedLookAndFeel
public boolean isSupportedLookAndFeel()
- Specified by:
isSupportedLookAndFeelin classLookAndFeel
-
getDisabledIcon
public Icon getDisabledIcon(JComponent component, Icon icon)
- Overrides:
getDisabledIconin classLookAndFeel
-
initialize
public void initialize()
- Overrides:
initializein classBasicLookAndFeel
-
uninitialize
public void uninitialize()
- Overrides:
uninitializein classBasicLookAndFeel
-
getDefaults
public UIDefaults getDefaults()
- Overrides:
getDefaultsin classBasicLookAndFeel
-
getAdditionalDefaults
protected Properties getAdditionalDefaults()
-
createActiveFontValue
public static UIDefaults.ActiveValue createActiveFontValue(float scaleFactor)
- Since:
- 1.1
-
initIconColors
public static void initIconColors(UIDefaults defaults, boolean dark)
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.
-
registerCustomDefaultsSource
public static void registerCustomDefaultsSource(String packageName)
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.propertiesfor classFlatLightLaforFlatDarkLaf.propertiesfor classFlatDarkLaf.FlatLaf.propertiesis 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
public static void unregisterCustomDefaultsSource(String packageName)
-
registerCustomDefaultsSource
public static void registerCustomDefaultsSource(String packageName, ClassLoader classLoader)
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
public static void unregisterCustomDefaultsSource(String packageName, ClassLoader classLoader)
-
registerCustomDefaultsSource
public static void registerCustomDefaultsSource(URL packageUrl)
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
public static void unregisterCustomDefaultsSource(URL packageUrl)
- Since:
- 2
-
registerCustomDefaultsSource
public static void registerCustomDefaultsSource(File folder)
Registers a folder where FlatLaf searches for properties files with custom UI defaults.See
registerCustomDefaultsSource(String)for details.- Parameters:
folder- a folder
-
unregisterCustomDefaultsSource
public static void unregisterCustomDefaultsSource(File folder)
-
getGlobalExtraDefaults
public static Map<String,String> getGlobalExtraDefaults()
Gets global extra UI defaults; ornull.- Since:
- 2
-
setGlobalExtraDefaults
public static void setGlobalExtraDefaults(Map<String,String> globalExtraDefaults)
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:
setExtraDefaults(Map)
-
getExtraDefaults
public Map<String,String> getExtraDefaults()
Gets extra UI defaults; ornull.- Since:
- 2
-
setExtraDefaults
public void setExtraDefaults(Map<String,String> extraDefaults)
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:
setGlobalExtraDefaults(Map)
-
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 parametervalueTypeisnullvalue- the value stringvalueType- the expected value type, ornull- Returns:
- the binary value
- Throws:
IllegalArgumentException- on syntax errors- Since:
- 2
-
getSystemColorGetter
public static Function<String,Color> getSystemColorGetter()
Returns the system color getter function, ornull.- Since:
- 3
-
setSystemColorGetter
public static void setSystemColorGetter(Function<String,Color> systemColorGetter)
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
nullfor 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
-
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_DECORATIONSis 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.selectionTypeorComponent.hideMnemonics.- Since:
- 1.1.2
-
isShowMnemonics
public static boolean isShowMnemonics()
-
showMnemonics
public static void showMnemonics(Component c)
-
hideMnemonics
public static void hideMnemonics()
-
registerUIDefaultsGetter
public void registerUIDefaultsGetter(Function<Object,Object> uiDefaultsGetter)
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(Function),runWithUIDefaultsGetter(Function, Runnable)
-
unregisterUIDefaultsGetter
public void unregisterUIDefaultsGetter(Function<Object,Object> uiDefaultsGetter)
Unregisters a UI defaults getter function that was invoked before the standard getter.- Since:
- 1.6
- See Also:
registerUIDefaultsGetter(Function),runWithUIDefaultsGetter(Function, Runnable)
-
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:
registerUIDefaultsGetter(Function),unregisterUIDefaultsGetter(Function)
-
getStyleableInfos
public static Map<String,Class<?>> getStyleableInfos(JComponent c)
Returns information about styleable values of a component.This is equivalent to:
((StyleableUI)c.getUI()).getStyleableInfos(c)- Since:
- 2.5
-
getStyleableValue
public static <T> T getStyleableValue(JComponent c, String key)
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
public static String getPreferredFontFamily()
Returns the preferred font family to be used for (nearly) all fonts; ornull.- Since:
- 3
-
setPreferredFontFamily
public static void setPreferredFontFamily(String preferredFontFamily)
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
public static String getPreferredLightFontFamily()
Returns the preferred font family to be used for "light" fonts; ornull.- Since:
- 3
-
setPreferredLightFontFamily
public static void setPreferredLightFontFamily(String preferredLightFontFamily)
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
public static String getPreferredSemiboldFontFamily()
Returns the preferred font family to be used for "semibold" fonts; ornull.- Since:
- 3
-
setPreferredSemiboldFontFamily
public static void setPreferredSemiboldFontFamily(String preferredSemiboldFontFamily)
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
public static String getPreferredMonospacedFontFamily()
Returns the preferred font family to be used for monospaced fonts; ornull.- Since:
- 3
-
setPreferredMonospacedFontFamily
public static void setPreferredMonospacedFontFamily(String preferredMonospacedFontFamily)
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
-
-