Merge branch 'feature/filters-visability-handling' of https://github.com/devforth/adminforth into feature/filters-visability-handling

Author: NoOne7135

adminforth/documentation/docs/tutorial/03-Customization/08-pageInjections.md

@@ -37,6 +37,17 @@ Now create file `ApartsPie.vue` in the `custom` folder of your project:
         :options="{
           chart: {
             height: 250,
+            events: {
+              dataPointSelection: function (event, chartContext, config) {
+                if (config.selectedDataPoints[0].length) {
+                  const selectedRoomsCount = data[config.dataPointIndex].rooms;
+                  adminforth.list.updateFilter({field: 'number_of_rooms', operator: 'eq', value: selectedRoomsCount});
+                } else {
+                  // clear filter
+                  adminforth.list.updateFilter({field: 'number_of_rooms', value: undefined});
+                }
+              }
+            }
           },
           dataLabels: {
             enabled: true,

adminforth/spa/src/afcl/Table.vue

@@ -4,7 +4,7 @@
       <table class="afcl-table w-full text-sm text-left rtl:text-right text-lightTableText dark:text-darkTableText overflow-x-auto">
           <thead class="afcl-table-thread text-xs text-lightTableHeadingText uppercase bg-lightTableHeadingBackground dark:bg-darkTableHeadingBackground dark:text-darkTableHeadingText">
             <tr>
-              <th scope="col" class="px-6 py-3" ref="headerRefs"
+              <th scope="col" class="px-6 py-3" ref="headerRefs" :key="`header-${column.fieldName}`"
                 v-for="column in columns"
               >
                 <slot v-if="$slots[`header:${column.fieldName}`]" :name="`header:${column.fieldName}`" :column="column" />
@@ -34,13 +34,14 @@
             <tr
               v-else="!isLoading"
               v-for="(item, index) in dataPage"
+              :key="`row-${index}`"
               ref="rowRefs"
               :class="{
                 'afcl-table-body odd:bg-lightTableOddBackground odd:dark:bg-darkTableOddBackground even:bg-lightTableEvenBackground even:dark:bg-darkTableEvenBackground': evenHighlights,
                 'border-b border-lightTableBorder dark:border-darkTableBorder': index !== dataPage.length - 1 || totalPages > 1,
               }"
             >
-              <td class="px-6 py-4" 
+              <td class="px-6 py-4" :key="`cell-${index}-${column.fieldName}`"
                 v-for="column in props.columns"
               >
                 <slot v-if="$slots[`cell:${column.fieldName}`]" 

adminforth/types/FrontendAPI.ts

@@ -82,10 +82,9 @@ export interface FrontendAPIInterface {
          */
         closeThreeDotsDropdown(): void;
 
-
         /**
-         * Set a filter in the list
-         * Works only when user located on the list page.
+         * Set a filter in the list.
+         * Works only when user located on the list page. If filter already exists, it will be replaced with the new one.
          * Can be used to set filter from charts or other components in pageInjections.
          * 
          * Filters are automatically marked as hidden (won't count in badge) if:
@@ -103,11 +102,15 @@ export interface FrontendAPIInterface {
          * adminforth.list.setFilter({field: 'internal_status', operator: 'eq', value: 'active'})
          * ```
          * 
+         * Please note that you can set/update filter even for fields which have showIn.filter=false in resource configuration.
+         * Also you can set filter for virtual columns. For example Universal search plugin calls updateFilter for virtual column which has showIn.filter=false (because we dont want to show this column in filter dropdown, plugin renders its own filter UI)
+         * 
          * @param filter - The filter to set
          */
         setFilter(filter: FilterParams): void;
 
         /**
+         * DEPRECATED: does the same as setFilter, kept for backward compatibility
          * Update a filter in the list
          * 
          * Filters visibility in badge is automatically determined by column configuration: