@lexriver/dome 2.0.0 → 2.0.1

package/README.md

@@ -1350,7 +1350,7 @@ DomeManipulator.scrollToY({
 Use DomeRouter for navigation in single page app.
 
 ```typescript
-DomeRouter.onRoute('/about', true, async (params, url) => {
+DomeRouter.onRoute('/about', true, async (params, url, scrollTo, query) => {
     const { PageAbout } = await import('./pages/PageAbout') // dynamic import component
     DomeManipulator.replaceAllChildrenAsync(divContainer, <PageAbout />, animationHide, animationShow) // replace current page with new page
 })
@@ -1507,12 +1507,18 @@ Parameters:
 Where `RouteAction` type is:
 ```typescript
 export type RouteAction = (
-    params:{[key:string]:string}, // parameters from url
-    url:string, 
-    scrollToPreviousPositionAsync:()=>Promise<void> // this function can be called to scroll to previous page position
+    params:{[key:string]:string|number}, // parameters from url path
+    url:string, // url path without query string
+    scrollToPreviousPositionAsync:()=>Promise<void>, // this function can be called to scroll to previous page position
+    query:{[key:string]:string} // query parameters from window.location.search
     ) => void|Promise<void>
 ```
 
+For example, for URL `/search?category=books&sort=price`, the `query` parameter will be:
+```typescript
+{category: 'books', sort: 'price'}
+```
+
 example:
 ```typescript
 DomeRouter.onRoute('/login', true, (params, url) => changePage(<PageLogin />))

package/out/src/DomeRouter.d.mts

@@ -1,6 +1,8 @@
 export type RouteAction = (params: {
+    [key: string]: string | number;
+}, url: string, scrollToPreviousPositionAsync: () => Promise<void>, query: {
     [key: string]: string;
-}, url: string, scrollToPreviousPositionAsync: () => Promise<void>) => void | Promise<void>;
+}) => void | Promise<void>;
 export declare namespace DomeRouter {
     let maxHistoryUrlsCount: number;
     function navigate(url: string): void;

package/out/src/DomeRouter.mjs

@@ -182,7 +182,20 @@ export var DomeRouter;
             return [name.substring(1), value];
         }
     }
+    function parseQueryString(search) {
+        const query = {};
+        if (!search || search[0] !== '?')
+            return query;
+        const params = new URLSearchParams(search.substring(1));
+        for (const [key, value] of params.entries()) {
+            query[key] = value;
+        }
+        return query;
+    }
     async function executeAsync(url = window.location.pathname, scrollToPosition) {
+        const queryString = window.location.search;
+        const query = parseQueryString(queryString);
+        url = url.split('?')[0]; // Strip query params
         //const url = window.location.pathname
         const urlSlices = getRouteSlices(url);
         // urlSlices = show, category, 345
@@ -225,7 +238,7 @@ export var DomeRouter;
                     await DomeManipulator.scrollToAsync({
                         pxFromTop: scrollToPosition
                     });
-                });
+                }, query);
             }
         }
         if (countOfFoundRoutes == 0 && onNotFoundAction) {

package/package.json

@@ -1,7 +1,7 @@
 {
     "sideEffects": false,
     "name": "@lexriver/dome",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "DOM manipulator",
     "type": "module",
     "exports": "./out/src/index.mjs",

package/src/DomeRouter.mts

@@ -3,9 +3,10 @@ import { DomeManipulator } from "./DomeManipulator.mjs"
 // const filename = '[DomeRouter]'
 
 export type RouteAction = (
-    params:{[key:string]:string}, 
+    params:{[key:string]:string|number}, 
     url:string,
-    scrollToPreviousPositionAsync:()=>Promise<void>
+    scrollToPreviousPositionAsync:()=>Promise<void>,
+    query:{[key:string]:string}
     ) => void|Promise<void>
 
 interface Route{
@@ -215,7 +216,20 @@ export namespace DomeRouter {
 
     }
 
+    function parseQueryString(search:string):{[key:string]:string}{
+        const query:{[key:string]:string} = {}
+        if(!search || search[0] !== '?') return query
+        const params = new URLSearchParams(search.substring(1))
+        for(const [key, value] of params.entries()){
+            query[key] = value
+        }
+        return query
+    }
+
     async function executeAsync(url:string = window.location.pathname, scrollToPosition:number){
+        const queryString = window.location.search
+        const query = parseQueryString(queryString)
+        url = url.split('?')[0]  // Strip query params
         //const url = window.location.pathname
         const urlSlices = getRouteSlices(url)
         // urlSlices = show, category, 345
@@ -259,7 +273,7 @@ export namespace DomeRouter {
                     await DomeManipulator.scrollToAsync({
                         pxFromTop: scrollToPosition
                     })
-                })
+                }, query)
             }
         }
         if(countOfFoundRoutes==0 && onNotFoundAction){