Разработка кастомных компонентов JavaFX: практика и примеры

public class RatingControl extends Control {
private IntegerProperty rating = new SimpleIntegerProperty(0);
private IntegerProperty maxRating = new SimpleIntegerProperty(5);

public RatingControl() {
// Устанавливаем CSS-класс для стилизации
getStyleClass().add("rating-control");
// Устанавливаем стандартное поведение
setSkin(new RatingControlSkin(this));
}

// Геттеры и сеттеры для свойств
public final IntegerProperty ratingProperty() {
return rating;
}

public final int getRating() {
return rating.get();
}

public final void setRating(int value) {
rating.set(value);
}

// Аналогично для maxRating
// ...
}

public class RatingControlSkin extends SkinBase<RatingControl> {
private HBox starsContainer;

public RatingControlSkin(RatingControl control) {
super(control);

starsContainer = new HBox();
starsContainer.setAlignment(Pos.CENTER_LEFT);
starsContainer.setSpacing(5);

updateStars();

// Подписываемся на изменения рейтинга
control.ratingProperty().addListener((obs, oldVal, newVal) -> updateStars());
control.maxRatingProperty().addListener((obs, oldVal, newVal) -> updateStars());

getChildren().add(starsContainer);
}

private void updateStars() {
starsContainer.getChildren().clear();

for (int i = 1; i <= getSkinnable().getMaxRating(); i++) {
final int starValue = i;
Label star = new Label("★");
star.getStyleClass().add("star");

if (i <= getSkinnable().getRating()) {
star.getStyleClass().add("filled");
} else {
star.getStyleClass().add("empty");
}

star.setOnMouseClicked(e -> getSkinnable().setRating(starValue));

starsContainer.getChildren().add(star);
}
}
}

public class CustomProgressBar extends Region {
private DoubleProperty progress = new SimpleDoubleProperty(0);
private Rectangle bar;
private Rectangle background;

public CustomProgressBar() {
// Создаем фон
background = new Rectangle();
background.setFill(Color.LIGHTGRAY);

// Создаем полосу прогресса
bar = new Rectangle();
bar.setFill(Color.BLUE);

// Добавляем элементы на сцену
getChildren().addAll(background, bar);

// Привязываем ширину полосы к прогрессу
bar.widthProperty().bind(
widthProperty().multiply(progress));

// Привязываем размеры фона к размерам компонента
background.widthProperty().bind(widthProperty());
background.heightProperty().bind(heightProperty());
bar.heightProperty().bind(heightProperty());
}

// Геттеры и сеттеры для свойства progress
public DoubleProperty progressProperty() {
return progress;
}

public double getProgress() {
return progress.get();
}

public void setProgress(double value) {
progress.set(Math.max(0, Math.min(1, value)));
}
}

.rating-control {
-fx-padding: 10;
-fx-background-color: transparent;
}

.rating-control .star {
-fx-font-size: 24px;
-fx-cursor: hand;
}

.rating-control .star.filled {
-fx-text-fill: gold;
}

.rating-control .star.empty {
-fx-text-fill: #cccccc;
}

scene.getStylesheets().add(getClass().getResource("/styles/rating-control.css").toExternalForm());

private static final StyleablePropertyFactory<RatingControl> FACTORY = 
new StyleablePropertyFactory<>(Control.getClassCssMetaData());

private final StyleableProperty<Color> starColor = 
FACTORY.createStyleableColorProperty(this, "starColor", "-fx-star-color", c -> c.starColorProperty);

static {
// Регистрируем CSS-метаданные
FACTORY.registerStyleable(StyleableProperties.STAR_COLOR);
}

// Публичное свойство для доступа из кода
public Color getStarColor() { return starColor.getValue(); }
public void setStarColor(Color value) { starColor.setValue(value); }
public StyleableProperty<Color> starColorProperty() { return starColor; }

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.VBox?>
<?import com.example.controls.RatingControl?>

<VBox xmlns="http://javafx.com/javafx/17" 
xmlns:fx="http://javafx.com/fxml/1" 
fx:controller="com.example.MainController">
<RatingControl fx:id="ratingControl" maxRating="10" />
</VBox>

public static class RatingControlBuilder extends ControlBuilder<RatingControl> {
@Override
public void buildObject(RatingControl control, Object value) {
super.buildObject(control, value);
}

@Override
public void setPropertyValue(RatingControl control, String property, Object value) {
if ("rating".equals(property)) {
control.setRating(Integer.parseInt(value.toString()));
} else if ("maxRating".equals(property)) {
control.setMaxRating(Integer.parseInt(value.toString()));
} else {
super.setPropertyValue(control, property, value);
}
}
}

// Определяем класс события
public class RatingChangeEvent extends Event {
public static final EventType<RatingChangeEvent> RATING_CHANGED = 
new EventType<>(Event.ANY, "RATING_CHANGED");

private final int oldValue;
private final int newValue;

public RatingChangeEvent(int oldValue, int newValue) {
super(RATING_CHANGED);
this.oldValue = oldValue;
this.newValue = newValue;
}

public int getOldValue() { return oldValue; }
public int getNewValue() { return newValue; }
}

// Дополняем RatingControl для поддержки события
public class RatingControl extends Control {
// ... существующий код ...

// Генерируем событие при изменении рейтинга
public RatingControl() {
// ... существующий код инициализации ...

ratingProperty().addListener((obs, oldVal, newVal) -> {
fireEvent(new RatingChangeEvent(oldVal.intValue(), newVal.intValue()));
});
}

// Удобные методы для работы с событиями
public void addRatingChangeListener(EventHandler<RatingChangeEvent> handler) {
addEventHandler(RatingChangeEvent.RATING_CHANGED, handler);
}

public void removeRatingChangeListener(EventHandler<RatingChangeEvent> handler) {
removeEventHandler(RatingChangeEvent.RATING_CHANGED, handler);
}
}

public class ZoomableCanvas extends Canvas {
private double scale = 1.0;

public ZoomableCanvas(double width, double height) {
super(width, height);

// Обработка масштабирования колесиком мыши
setOnScroll(e -> {
double delta = e.getDeltaY() * 0.005;
scale += delta;
scale = Math.max(0.1, Math.min(10, scale)); // Ограничиваем масштаб
redraw();
e.consume();
});

// Поддержка мультитач-масштабирования
addEventHandler(ZoomEvent.ZOOM, e -> {
scale *= e.getZoomFactor();
scale = Math.max(0.1, Math.min(10, scale));
redraw();
e.consume();
});

// Инициализация рисования
redraw();
}

private void redraw() {
GraphicsContext gc = getGraphicsContext2D();
gc.clearRect(0, 0, getWidth(), getHeight());

gc.save();
gc.scale(scale, scale);
// Ваш код отрисовки
gc.restore();
}
}

public interface Command {
void execute();
void undo();
}

public class RatingChangeCommand implements Command {
private final RatingControl control;
private final int oldValue;
private final int newValue;

public RatingChangeCommand(RatingControl control, int oldValue, int newValue) {
this.control = control;
this.oldValue = oldValue;
this.newValue = newValue;
}

@Override
public void execute() {
control.setRating(newValue);
}

@Override
public void undo() {
control.setRating(oldValue);
}
}

// Использование в контроллере
public class UndoableRatingController {
private Stack<Command> undoStack = new Stack<>();
private RatingControl ratingControl;

public UndoableRatingController(RatingControl control) {
this.ratingControl = control;
control.addRatingChangeListener(e -> {
Command cmd = new RatingChangeCommand(control, e.getOldValue(), e.getNewValue());
undoStack.push(cmd);
});
}

public void undo() {
if (!undoStack.isEmpty()) {
Command cmd = undoStack.pop();
cmd.undo();
}
}
}

public class CircularProgressIndicator extends Region {
private DoubleProperty progress = new SimpleDoubleProperty(0);
private DoubleProperty diameter = new SimpleDoubleProperty(100);

public CircularProgressIndicator() {
setPrefSize(100, 100);

// CSS-стиль для региона
getStyleClass().add("circular-progress");
}

@Override
protected void layoutChildren() {
super.layoutChildren();
}

@Override
public void resize(double width, double height) {
super.resize(width, height);
diameter.set(Math.min(width, height));
}

@Override
protected void layoutChildren() {
// Пустая реализация, отрисовка происходит в CSS
}

@Override
protected double computePrefWidth(double height) {
return diameter.get();
}

@Override
protected double computePrefHeight(double width) {
return diameter.get();
}

// Getters и Setters для свойств
// ...
}

.circular-progress {
-fx-border-color: transparent;
-fx-background-color: transparent;
}

.circular-progress > .track {
-fx-fill: null;
-fx-stroke: #e4e4e4;
-fx-stroke-width: 4px;
}

.circular-progress > .bar {
-fx-fill: null;
-fx-stroke: linear-gradient(from 0% 0% to 100% 100%, #4285f4, #34a853);
-fx-stroke-width: 5px;
-fx-stroke-line-cap: round;
}

public class ColorSelector extends VBox {
private final ObjectProperty<Color> colorProperty = new SimpleObjectProperty<>(Color.WHITE);
private final TextField hexField;
private final Rectangle colorPreview;

public ColorSelector() {
// Превью цвета
colorPreview = new Rectangle(100, 50);
colorPreview.setStroke(Color.GRAY);
colorPreview.fillProperty().bind(colorProperty);

// Поле для ввода hex-кода
hexField = new TextField("#FFFFFF");
hexField.setPromptText("#RRGGBB");
hexField.setPrefWidth(100);

// Обработчик изменения текста
hexField.textProperty().addListener((obs, oldVal, newVal) -> {
if (newVal.matches("#[0-9A-Fa-f]{6}")) {
try {
colorProperty.set(Color.web(newVal));
} catch (Exception e) {
// Некорректный формат, игнорируем
}
}
});

// Обновление текстового поля при изменении цвета
colorProperty.addListener((obs, oldVal, newVal) -> {
String hex = String.format("#%02X%02X%02X",
(int)(newVal.getRed() * 255),
(int)(newVal.getGreen() * 255),
(int)(newVal.getBlue() * 255));

hexField.setText(hex);
});

// Набор предустановленных цветов
HBox presets = new HBox(5);
Color[] colors = {Color.BLACK, Color.RED, Color.GREEN, 
Color.BLUE, Color.YELLOW, Color.PURPLE};

for (Color color : colors) {
Rectangle rect = new Rectangle(20, 20, color);
rect.setStroke(Color.GRAY);
rect.setOnMouseClicked(e -> setColor(color));
presets.getChildren().add(rect);
}

// Собираем компонент
setSpacing(10);
setPadding(new Insets(10));
getChildren().addAll(colorPreview, hexField, presets);
}

// API для работы с цветом
public Color getColor() {
return colorProperty.get();
}

public void setColor(Color color) {
colorProperty.set(color);
}

public ObjectProperty<Color> colorProperty() {
return colorProperty;
}
}

public class OptimizedGraphView extends Canvas {
private boolean needsRedraw = true;
private List<Double> dataPoints;

public OptimizedGraphView(double width, double height) {
super(width, height);
dataPoints = new ArrayList<>();

// Только перерисовываем, когда компонент видим
widthProperty().addListener(e -> needsRedraw = true);
heightProperty().addListener(e -> needsRedraw = true);

// Анимационный таймер для отрисовки
AnimationTimer timer = new AnimationTimer() {
@Override
public void handle(long now) {
if (isVisible() && needsRedraw) {
redraw();
needsRedraw = false;
}
}
};
timer.start();
}

public void setDataPoints(List<Double> points) {
dataPoints = new ArrayList<>(points); // Копируем для потокобезопасности
needsRedraw = true;
}

private void redraw() {
GraphicsContext gc = getGraphicsContext2D();
gc.clearRect(0, 0, getWidth(), getHeight());

// Отрисовка данных
// ...
}
}