@sumaris-net/ngx-components 18.12.4 → 18.12.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sumaris-net/ngx-components",
   "description": "SUMARiS Angular components",
-  "version": "18.12.4",
+  "version": "18.12.6",
   "author": "contact@e-is.pro",
   "license": "AGPL-3.0",
   "readmeFilename": "README.md",

package/src/app/shared/file/url.utils.d.ts

@@ -46,6 +46,28 @@ export declare abstract class UrlUtils {
      * @throws {Error} If the provided URL is missing or undefined.
      */
     static normalizeUrl(url: string): string;
+    /**
+     * This function completes a base URL with an object containing key-value pairs
+     * representing the query parameters to add. It properly encodes the
+     * parameters and ensures they are added with the appropriate separator ('?' or '&').
+     * Parameters with null or undefined values are automatically filtered out.
+     *
+     * @example
+     * // In a template
+     * <a [href]="'https://example.com' | appendQueryParams:{id: 123, name: 'test'}">Link</a>
+     * // Result: https://example.com?id=123&name=test
+     *
+     * @example
+     * // If the URL already contains parameters
+     * <a [href]="'https://example.com?page=1' | appendQueryParams:{sort: 'asc'}">Link</a>
+     * // Result: https://example.com?page=1&sort=asc
+     *
+     * @param url
+     * @param queryParams
+     */
+    static appendQueryParams(url: string | any[], queryParams: {
+        [key: string]: any;
+    }): string;
     /**
      * Extracts and returns the root URL from the given complete URL string.
      *

package/src/assets/manifest.json

@@ -2,7 +2,7 @@
   "name": "ngx-sumaris-components",
   "short_name": "ngx-sumaris-components",
   "manifest_version": 1,
-  "version": "18.12.4",
+  "version": "18.12.6",
   "default_locale": "fr",
   "description": "Angular components for building beautiful and responsive Apps",
   "icons": [{