repository·master·Indexed 27 days ago
https://github.com/sshahine/jfoenixAn open-source Java library that implements Google Material Design using JavaFX components. It provides a variety of Material Design components such as JFXButton, JFXCheckBox, JFXDialog, JFXColorPicker, and JFXSnackbar. The library includes specialized functionality for form validation via ValidationControl and advanced color selection tools through JFXColorPalette and JFXColorPickerUI. Supports Java 8 (version 8.0.10) and Java 9+ (version 9.0.10).
To use JFoenix in a Gradle project, add mavenCentral() to your repositories block. Then, add the appropriate dependency based on your Java version:
9.0.10.8.0.10.repositories {
mavenCentral()
}
// For Java 9+
dependencies {
compile 'com.jfoenix:jfoenix:9.0.10'
}
// For Java 8
dependencies {
compile 'com.jfoenix:jfoenix:8.0.10'
}To build the JFoenix library from the source repository, use the Gradle wrapper.
Requirements:
JAVA_HOME environment variable to point to a Java 1.8 directory.Building the project will generate a JAR file (e.g., jfoenix-0.0.0-SNAPSHOT.jar) in the jfoenix/build/libs folder.
gradlew buildTo use JFoenix in a Maven project, add the following dependency to your pom.xml. Choose the version corresponding to your Java runtime:
9.0.10.8.0.10.<!-- For Java 9+ -->
<dependency>
<groupId>com.jfoenix</groupId>
<artifactId>jfoenix</artifactId>
<version>9.0.10</version>
</dependency>
<!-- For Java 8 -->
<dependency>
<groupId>com.jfoenix</groupId>
<artifactId>jfoenix</artifactId>
<version>8.0.10</version>
</dependency>To run the main demonstration application included in the repository, execute the following command using the Gradle wrapper. Ensure JAVA_HOME is set to a Java 1.8+ directory.
gradlew runJFoenix provides a variety of JavaFX components that implement Google Material Design. Available components include:
JFXButtonJFXCheckBoxJFXToggleButtonJFXDialogJFXListViewJFXHighlighterJFXChipViewJFXNodesListJFXMasonryPaneJFXSliderJFXSpinnerJFXSnackbarJFXColorPickerJFXDatePickerJFXTimePickerJFXTreeTableViewsetValidators(ValidatorBase... validators) to add one or more ValidatorBase implementations to a ValidationControl. You can also retrieve the current list of validators using getValidators(), which returns an ObservableList<ValidatorBase>.The JFXColorPalette requires a reference to its parent PopupControl to manage visibility and auto-hide behavior (especially when opening the custom color dialog). Use setPopupControl(PopupControl pc) to provide this reference.
public void setPopupControl(PopupControl pc)Node objects to automatically update their styles (both -fx-background-color and -fx-fill) whenever a color is selected in the picker. This is useful for updating preview shapes or UI elements in real-time.ValidationControl class acts as a wrapper for JavaFX Control objects to implement form validation. You can associate a list of ValidatorBase instances with a control and then trigger validation. When validate() is called, it iterates through the provided validators. If a validator finds errors, it becomes the activeValidator and validate() returns false. If all validators pass, it returns true and the activeValidator is cleared.resetValidation() to clear the current validation state. This method removes the error pseudo-class state from the associated control and clears the activeValidator.moveToColor(Color color) to animate the picker's selectors (Hue and SL) to a specific target color. This method handles the HSL conversion and triggers a parallel transition animation to move the UI elements to the correct positions.You can check if the JFXCustomColorPickerDialog is currently being displayed by calling isCustomColorDialogShowing() on the JFXColorPalette instance.
public boolean isCustomColorDialogShowing()