feat!: replace classNameGenerator with partNameGenerator

Close #148

Author: javier-godoy

src/main/java/com/flowingcode/vaadin/addons/gridhelpers/GridHelper.java

@@ -83,20 +83,20 @@ public final class GridHelper<T> implements Serializable {
   @Getter(value = AccessLevel.PACKAGE)
   private final Grid<T> grid;
 
-  private final GridHelperClassNameGenerator<T> helperClassNameGenerator;
+  private final GridHelperPartNameGenerator<T> helperPartNameGenerator;
 
-  protected void setHelperClassNameGenerator(
+  protected void setHelperPartNameGenerator(
       Class<?> clazz, SerializableFunction<T, String> generator) {
-    getHelper(grid).helperClassNameGenerator.setHelperClassNameGenerator(clazz, generator);
+    getHelper(grid).helperPartNameGenerator.setHelperPartNameGenerator(clazz, generator);
     grid.getDataCommunicator().reset();
   }
 
   private boolean selectOnClick;
 
   private GridHelper(Grid<T> grid) {
     this.grid = grid;
-    helperClassNameGenerator = new GridHelperClassNameGenerator<>();
-    setClassNameGenerator(grid.getClassNameGenerator());
+    helperPartNameGenerator = new GridHelperPartNameGenerator<>();
+    setPartNameGenerator(grid.getPartNameGenerator());
     grid.addItemClickListener(this::onItemClick);
     grid.addAttachListener(this::onAttach);
     if (grid.isAttached()) {
@@ -161,26 +161,24 @@ public static SelectionMode getSelectionMode(Grid<?> grid) {
   }
 
   /**
-   * Sets the function that is used for generating CSS class names for all the cells in the rows in
-   * this grid. Returning {@code null} from the generator results in no custom class name being set.
-   * Multiple class names can be returned from the generator as space-separated.
+   * Sets the function that is used for generating CSS part names for all the cells in the rows in
+   * this grid. Returning {@code null} from the generator results in no custom part name being set.
+   * Multiple part names can be returned from the generator as space-separated.
    *
-   * <p>If {@link Column#setClassNameGenerator(SerializableFunction)} is used together with this
-   * method, resulting class names from both methods will be effective. Class names generated by
-   * grid are applied to the cells before the class names generated by column. This means that if
-   * the classes contain conflicting style properties, column's classes will win.
+   * <p>
+   * If {@link Column#setPartNameGenerator(SerializableFunction)} is used together with this method,
+   * resulting part names from both methods will be effective.
    *
-   * @param classNameGenerator the class name generator to set, not {@code null}
-   * @throws NullPointerException if {@code classNameGenerator} is {@code null}
-   * @see Column#setClassNameGenerator(SerializableFunction)
+   * @param partNameGenerator the part name generator to set.
+   * @see Column#setPartNameGenerator(SerializableFunction)
    */
-  public void setClassNameGenerator(SerializableFunction<T, String> classNameGenerator) {
-    grid.setClassNameGenerator(helperClassNameGenerator);
-    if (classNameGenerator instanceof GridHelperClassNameGenerator) {
-      helperClassNameGenerator.setGridClassNameGenerator(
-          ((GridHelperClassNameGenerator<T>) classNameGenerator).getGridClassNameGenerator());
+  public void setPartNameGenerator(SerializableFunction<T, String> partNameGenerator) {
+    grid.setPartNameGenerator(helperPartNameGenerator);
+    if (partNameGenerator instanceof GridHelperPartNameGenerator) {
+      helperPartNameGenerator.setGridPartNameGenerator(
+          ((GridHelperPartNameGenerator<T>) partNameGenerator).getGridPartNameGenerator());
     } else {
-      helperClassNameGenerator.setGridClassNameGenerator(classNameGenerator);
+      helperPartNameGenerator.setGridPartNameGenerator(partNameGenerator);
     }
   }
 

…elpers/GridHelperClassNameGenerator.java …helpers/GridHelperPartNameGenerator.javasrc/main/java/com/flowingcode/vaadin/addons/gridhelpers/GridHelperClassNameGenerator.java renamed to src/main/java/com/flowingcode/vaadin/addons/gridhelpers/GridHelperPartNameGenerator.java src/main/java/com/flowingcode/vaadin/addons/gridhelpers/GridHelperClassNameGenerator.java renamed to src/main/java/com/flowingcode/vaadin/addons/gridhelpers/GridHelperPartNameGenerator.java

@@ -2,7 +2,7 @@
  * #%L
  * Grid Helpers Add-on
  * %%
- * Copyright (C) 2022 - 2024 Flowing Code
+ * Copyright (C) 2022 - 2025 Flowing Code
  * %%
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,27 +31,30 @@
 import lombok.Setter;
 
 @SuppressWarnings("serial")
-final class GridHelperClassNameGenerator<T> implements SerializableFunction<T, String> {
+final class GridHelperPartNameGenerator<T> implements SerializableFunction<T, String> {
 
-  private Map<Class<?>, SerializableFunction<T, String>> helperClassNameGenerators =
+  private Map<Class<?>, SerializableFunction<T, String>> helperPartNameGenerators =
       new HashMap<>();
 
-  @Getter @Setter private SerializableFunction<T, String> gridClassNameGenerator;
+  @Getter
+  @Setter
+  private SerializableFunction<T, String> gridPartNameGenerator;
 
   private transient boolean invoked;
 
-  void setHelperClassNameGenerator(Class<?> clazz, SerializableFunction<T, String> generator) {
+  void setHelperPartNameGenerator(Class<?> clazz, SerializableFunction<T, String> generator) {
     if (generator != null) {
-      helperClassNameGenerators.put(clazz, generator);
+      helperPartNameGenerators.put(clazz, generator);
     } else {
-      helperClassNameGenerators.remove(clazz);
+      helperPartNameGenerators.remove(clazz);
     }
   }
 
   private Stream<SerializableFunction<T, String>> generators() {
+
     return Stream.concat(
-        Optional.ofNullable(gridClassNameGenerator).map(Stream::of).orElseGet(Stream::empty),
-        helperClassNameGenerators.values().stream());
+        Optional.ofNullable(gridPartNameGenerator).map(Stream::of).orElseGet(Stream::empty),
+        helperPartNameGenerators.values().stream());
   }
 
   @Override

src/main/java/com/flowingcode/vaadin/addons/gridhelpers/SelectionFilterHelper.java

@@ -2,7 +2,7 @@
  * #%L
  * Grid Helpers Add-on
  * %%
- * Copyright (C) 2022 - 2024 Flowing Code
+ * Copyright (C) 2022 - 2025 Flowing Code
  * %%
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -59,11 +59,11 @@ public void setSelectionFilter(SerializablePredicate<T> predicate) {
     currentSingleSelectedItem = null;
     if (predicate != null) {
       deselectIf(predicate.negate());
-      helper.setHelperClassNameGenerator(
+      helper.setHelperPartNameGenerator(
           this.getClass(), row -> predicate.test(row) ? null : "fcGh-noselect");
       selectionListenerRegistration = grid.addSelectionListener(this::onSelection);
     } else {
-      helper.setHelperClassNameGenerator(this.getClass(), null);
+      helper.setHelperPartNameGenerator(this.getClass(), null);
     }
   }
 

src/main/resources/META-INF/frontend/fcGridHelper/vaadin-grid.css

@@ -2,7 +2,7 @@
  * #%L
  * Grid Helpers Add-on
  * %%
- * Copyright (C) 2022 - 2024 Flowing Code
+ * Copyright (C) 2022 - 2025 Flowing Code
  * %%
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -50,7 +50,7 @@
   --fcgh-toggle-right: 24px;
 }
 
-table[aria-multiselectable="true"] .fcGh-noselect[first-column] ::slotted(*) {
+table[aria-multiselectable="true"] [part~="fcGh-noselect"][first-column] ::slotted(*) {
   opacity: var(--fcgh-noselect-opacity, 0.5);
   pointer-events: none;
 }