vitarx-router 4.0.0-beta.25 → 4.0.0-beta.26

package/dist/components/RouterLink.js

@@ -1,9 +1,11 @@
 import { createView, isFunction, isPlainObject, logger } from 'vitarx';
+import { isExternalLink } from '../core/index.js';
 import { useLink } from '../core/shared/index.js';
 const EXTRA_PROPS = [
     'to',
     'replace',
     'viewTransition',
+    'exactMatchMode',
     'disabled',
     'callback',
     'onclick',
@@ -41,7 +43,7 @@ const EXTRA_PROPS = [
 export function RouterLink(props, location) {
     const link = useLink(props);
     if (__VITARX_DEV__) {
-        if (!link.route.value) {
+        if (!link.route.value && !isExternalLink(link.href.value)) {
             logger.warn(`[RouterLink] No match found for to: ${isPlainObject(props.to) ? JSON.stringify(props.to) : String(props.to)}`, location);
         }
     }

package/dist/core/common/utils.js

@@ -49,7 +49,7 @@ export function isNavIndex(val) {
  */
 export function hasOnlyChangeHash(route1, route2) {
     return (route1.hash !== route2.hash &&
-        route1.path === route2.path &&
+        route1.matched.at(-1) === route2.matched.at(-1) &&
         isDeepEqual(route1.query, route2.query));
 }
 /**

package/dist/core/router/router.js

@@ -590,6 +590,8 @@ export class Router {
         if (!context.to)
             return null;
         if (hasOnlyChangeHash(context.to, context.from)) {
+            // 更新路由位置的 hash 值并触发 hashUpdate 回调
+            this._routeLocation.hash = context.to.hash;
             this._routeLocation.href = context.to.href;
             this.hashUpdate?.(context.to);
             context.result.state = NavState.success;

package/dist/core/router/web.js

@@ -140,9 +140,14 @@ export class WebRouter extends Router {
             if ('el' in target && target.el) {
                 const { el, ...rest } = target;
                 if (isString(el)) {
-                    // 对选择器字符串进行转义
-                    const escapedSelector = el.replace(/([!"#$%&'()*+,.\/:;<=>?@[\\\]^`{|}~])/g, '\\$1');
-                    const element = document.querySelector(escapedSelector);
+                    let element = null;
+                    try {
+                        element = document.querySelector(el);
+                    }
+                    catch (e) {
+                        logger.warn(`[Router] Invalid selector "${el}", skipping scroll to element`, e);
+                        return;
+                    }
                     if (element) {
                         if (element.scrollIntoView) {
                             element.scrollIntoView(rest);

package/dist/core/shared/link.d.ts

@@ -1,7 +1,7 @@
 import { type Computed } from 'vitarx';
-import type { NavigateResult, NavTarget, RouteIndex, RouteLocation, RoutePath, URLHash } from '../types/index.js';
-export type HTTPUrl = `http://${string}` | `https://${string}`;
-type LinkToTarget<T extends RouteIndex = RouteIndex> = NavTarget<T> | T | `${RoutePath}?${string}` | URLHash | HTTPUrl;
+import type { NavigateResult, NavTarget, RouteIndex, RouteLocation } from '../types/index.js';
+type LinkToTarget<T extends RouteIndex = RouteIndex> = NavTarget<T> | T | string;
+export type LinkExactMatchMode = 'path' | 'href' | 'hash' | 'query';
 export interface UseLinkOptions<T extends RouteIndex = RouteIndex> {
     /**
      * 要跳转的目标
@@ -23,6 +23,17 @@ export interface UseLinkOptions<T extends RouteIndex = RouteIndex> {
      * @default false
      */
     viewTransition?: boolean;
+    /**
+     * 精确匹配模式
+     *
+     * - 'path'：精确匹配路径
+     * - 'href'：精确匹配完整链接
+     * - 'hash'：精确匹配路径和锚点
+     * - 'query'：精确匹配路径和查询参数
+     *
+     * @default 'path'
+     */
+    exactMatchMode?: LinkExactMatchMode;
 }
 export interface UseLinkReturn {
     /**
@@ -88,6 +99,7 @@ export declare function isPathExactMatch(currentPath: string, targetPath: string
  * @param props.to - 要跳转的目标，可以是路由目标对象、路由索引、带查询参数的路径字符串、哈希值或 HTTP/HTTPS 链接。
  * @param [props.replace] - 是否使用 `router.replace()` 而不是 `router.push()`。优先级低于 `to.replace`。默认为 `false`。
  * @param [props.viewTransition] - 如果支持则使用 `document.startViewTransition()` 进行视图过渡。默认为 `false`。
+ * @param [props.exactMatchMode] - 精确匹配模式。可选值有：'path'、'href'、'hash'、'query'。默认为 'path'。
  * @returns 返回一个包含链接属性和导航方法的对象。
  * @returns {Computed<string>} returns.href - 链接的 `href` 属性值。
  * @returns {Computed<RouteLocation | null>} returns.route - 匹配的路由信息，如果未匹配则返回 `null`。

package/dist/core/shared/link.js

@@ -2,7 +2,7 @@ import { computed, isPlainObject, isString } from 'vitarx';
 import { NavState } from '../common/constant.js';
 import { isExternalLink, isNavTarget, isRoutePath } from '../common/utils.js';
 import { useRouter } from './inject.js';
-import { cloneRouteLocation, parseQuery, removeTrailingSlash } from './utils.js';
+import { cloneRouteLocation, parseQuery, removeTrailingSlash, stringifyQuery } from './utils.js';
 /**
  * 处理视图转换
  * @param callback
@@ -63,6 +63,7 @@ export function isPathExactMatch(currentPath, targetPath) {
  * @param props.to - 要跳转的目标，可以是路由目标对象、路由索引、带查询参数的路径字符串、哈希值或 HTTP/HTTPS 链接。
  * @param [props.replace] - 是否使用 `router.replace()` 而不是 `router.push()`。优先级低于 `to.replace`。默认为 `false`。
  * @param [props.viewTransition] - 如果支持则使用 `document.startViewTransition()` 进行视图过渡。默认为 `false`。
+ * @param [props.exactMatchMode] - 精确匹配模式。可选值有：'path'、'href'、'hash'、'query'。默认为 'path'。
  * @returns 返回一个包含链接属性和导航方法的对象。
  * @returns {Computed<string>} returns.href - 链接的 `href` 属性值。
  * @returns {Computed<RouteLocation | null>} returns.route - 匹配的路由信息，如果未匹配则返回 `null`。
@@ -95,7 +96,7 @@ export function useLink(props) {
         else {
             return null;
         }
-        // 处理字符串目标
+        // 处理路由路径
         if (isString(target.index)) {
             // 兼容纯锚点连接跳转
             if (target.index.startsWith('#')) {
@@ -150,7 +151,20 @@ export function useLink(props) {
         const matchedRoute = route.value;
         if (!matchedRoute)
             return false;
-        return isPathExactMatch(router.route.path, matchedRoute.path);
+        const isMatched = isPathExactMatch(router.route.path, matchedRoute.path);
+        if (!isMatched)
+            return false;
+        const mode = props.exactMatchMode || 'path';
+        switch (mode) {
+            case 'href':
+                return router.route.href === matchedRoute.href;
+            case 'hash':
+                return router.route.hash === matchedRoute.hash;
+            case 'query':
+                return stringifyQuery(router.route.query) === stringifyQuery(matchedRoute.query);
+            default:
+                return true;
+        }
     });
     /**
      * 导航处理函数

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitarx-router",
-  "version": "4.0.0-beta.25",
+  "version": "4.0.0-beta.26",
   "description": "Official routing solution for Vitarx framework with declarative routing, navigation guards, dynamic routes, file-based routing with HMR, and full TypeScript support.",
   "author": "ZhuChonglin <8210856@qq.com>",
   "license": "MIT",
@@ -55,6 +55,9 @@
   "peerDependenciesMeta": {
     "vite": {
       "optional": true
+    },
+    "vitarx": {
+      "optional": true
     }
   },
   "dependencies": {