@ericchen1990/pano-view 2.2.0 → 2.2.2

package/README.md

@@ -810,10 +810,11 @@ xml/VR/frame-render events.
 
 ## PanoContextMenu
 
-`PanoViewer` mounts a default context menu that replaces the browser menu on
-right-click. Default items: **Reset view** and **Enter fullscreen** / **Exit
-fullscreen** (label and icon follow the current fullscreen state), with a
-separator between them.
+`PanoViewer` always suppresses the browser's native context menu on the
+viewer (canvas, chrome, and other overlays). It also mounts a default
+context menu on right-click. Default items: **Reset view** and **Enter
+fullscreen** / **Exit fullscreen** (label and icon follow the current
+fullscreen state), with a separator between them.
 
 ```tsx
 <PanoViewer style={{ height: 560 }}>
@@ -821,7 +822,8 @@ separator between them.
 </PanoViewer>
 ```
 
-Disable the default menu (restore the browser menu, or mount your own):
+Disable the default menu (the native browser menu stays suppressed; mount
+your own `PanoContextMenu` if you still want a custom menu):
 
 ```tsx
 <PanoViewer contextMenu={false}>

package/README.zh-CN.md

@@ -678,7 +678,7 @@ import {
 
 ## PanoContextMenu
 
-`PanoViewer` 挂载默认右键菜单，右键时替换浏览器菜单。默认项：**Reset view** 与 **Enter fullscreen** / **Exit fullscreen**（文案与图标随全屏状态变化），中间有分隔线。
+`PanoViewer` 会始终屏蔽浏览器原生右键菜单（画布、chrome 及其他 overlay 均生效），并挂载默认右键菜单。默认项：**Reset view** 与 **Enter fullscreen** / **Exit fullscreen**（文案与图标随全屏状态变化），中间有分隔线。
 
 ```tsx
 <PanoViewer style={{ height: 560 }}>
@@ -686,7 +686,7 @@ import {
 </PanoViewer>
 ```
 
-关闭默认菜单（恢复浏览器菜单，或挂载自定义菜单）：
+关闭默认菜单（浏览器原生菜单仍会被屏蔽；若仍需自定义菜单，请自行挂载 `PanoContextMenu`）：
 
 ```tsx
 <PanoViewer contextMenu={false}>

package/dist/index.cjs

@@ -4601,6 +4601,19 @@ var PanoViewer = (0, import_react22.forwardRef)(
       syncFullscreen();
       return subscribeFullscreenChange(syncFullscreen);
     }, []);
+    (0, import_react22.useEffect)(() => {
+      const root = rootRef.current;
+      if (!root) {
+        return;
+      }
+      const suppressNativeContextMenu = (event) => {
+        event.preventDefault();
+      };
+      root.addEventListener("contextmenu", suppressNativeContextMenu, true);
+      return () => {
+        root.removeEventListener("contextmenu", suppressNativeContextMenu, true);
+      };
+    }, []);
     const contextMenuActions = (0, import_react22.useMemo)(
       () => ({
         reset: () => {