鼠标右键菜单:自定义右键弹出菜单

把浏览器默认的右键菜单换成自己的——首页、复制、刷新、搜索、友链申请……看起来很酷,但这个效果有一堆坑,而且其中一个是会拖垮页面的严重性能问题。这篇把原版的问题讲清楚,再给一个干净的实现。

下面每块都能点「预览效果」直接看——在预览里点右键就能看到菜单。

原版 · 实际效果

先看看它想做成什么样(这是我按原版逻辑重写的等价版本,去掉了外部库依赖):

HTML右键菜单 · 原版效果还原原版·有问题
<style>
.ucm-demo{padding:44px 20px;text-align:center;background:#fff;font:14px/1.9 sans-serif;color:#4a5568;min-height:200px}
.ucm-demo h4{margin:0 0 8px;font-size:15px;color:#2d3748}
div.usercm{background:#fff;font-size:13px!important;width:130px;
  box-shadow:0px 0px 15px #333;position:absolute;display:none;z-index:10000;
  opacity:0.9;border-radius:8px;overflow:hidden}
div.usercm ul{list-style-type:none;margin:0;padding:0;display:block}
div.usercm ul li{margin:0;padding:0;line-height:35px}
div.usercm ul li a{color:#666;padding:0 15px;display:block;text-decoration:none;cursor:pointer}
div.usercm ul li a:hover{color:#fff;background:rgba(170,222,18,.88)}
div.usercm ul li a i{margin-right:10px;font-style:normal}
</style>

<div class="ucm-demo">
  <h4>在这里点右键 →</h4>
  <p>会弹出自定义菜单,点其他地方关闭。</p>
</div>

<div class="usercm" id="usercm"><ul>
  <li><a><i>🏠</i><span>首页</span></a></li>
  <li><a><i>📋</i><span>复制拷贝</span></a></li>
  <li style="border-bottom:1px solid gray"><a><i>🔄</i><span>刷新网页</span></a></li>
  <li><a><i>🔍</i><span>百度搜索</span></a></li>
  <li><a><i>🔗</i><span>友链申请</span></a></li>
</ul></div>

<script>
(function () {
  'use strict';
  var cm = document.getElementById('usercm');
  var zone = document.querySelector('.ucm-demo');
  zone.addEventListener('contextmenu', function (e) {
    e.preventDefault();
    cm.style.left = e.pageX + 'px';
    cm.style.top = e.pageY + 'px';
    cm.style.display = 'block';
  });
  document.addEventListener('click', function () { cm.style.display = 'none'; });
})();
</script>

这是按原版逻辑还原的效果(去掉了 jQuery / layer.js / font-awesome 依赖)。在预览区点右键试试。注意:原版代码有个严重的性能问题 —— 它在每次鼠标移动时都重新绑定一遍事件,详见正文。

原版 · 源码与问题

HTML右键菜单 · 原版源码(jQuery 版)原版·有问题
<script src="https://cdn.jsdelivr.net/npm/sweetalert2@8"></script><style type="text/css">a{text-decoration:none}div.usercm{background-repeat:no-repeat;background-position:center center;background-size:cover;background-color:#fff;font-size:13px!important;width:130px;-moz-box-shadow:1px 1px 3px rgba(0,0,0,.3);box-shadow:0px 0px 15px#333;position:absolute;display:none;z-index:10000;opacity:0.9;border-radius:8px}div.usercm ul{list-style-type:none;list-style-position:outside;margin:0px;padding:0px;display:block}div.usercm ul li{margin:0px;padding:0px;line-height:35px}div.usercm ul li a{color:#666;padding:0 15px;display:block}div.usercm ul li a:hover{color:#fff;background:rgba(170,222,18,0.88)}div.usercm ul li a i{margin-right:10px}a.disabled{color:#c8c8c8!important;cursor:not-allowed}a.disabled:hover{background-color:rgba(255,11,11,0)!important}div.usercm{background:#fff!important}</style><div class="usercm"style="left: 199px; top: 5px; display: none;"><ul><li><a href="https://cloon.cn/"><i class="fa fa-meh-o fa-fw"></i><span>首页</span></a></li><li><a href="javascript:void(0);"onclick="getSelect();"><i class="fa fa-copy fa-fw"></i><span>复制拷贝</span></a></li><li style="border-bottom:1px solid gray"><a href="javascript:window.location.reload();"><i class="fa fa-refresh fa-fw"></i><span>刷新网页</span></a></li><li><a href="javascript:void(0);"onclick="baiduSearch();"><i class="fa fa-search fa-fw"></i><span>百度搜索</span></a></li><li><a href="https://cloon.cn/%e7%94%b3%e8%af%b7%e5%8f%8b%e9%93%be.html/"><i class="fa fa-meh-o fa-fw"></i><span>友链申请</span></a></li><li><a href="https://cloon.cn/sample-page.html/"><i class="fa fa-pencil-square-o fa-fw"></i><span>免责声明</span></a></li></ul></div><script type="text/javascript">(function(a){a.extend({mouseMoveShow:function(b){var d=0,c=0,h=0,k=0,e=0,f=0;a(window).mousemove(function(g){d=a(window).width();c=a(window).height();h=g.clientX;k=g.clientY;e=g.pageX;f=g.pageY;h+a(b).width()>=d&&(e=e-a(b).width()-5);k+a(b).height()>=c&&(f=f-a(b).height()-5);a("html").on({contextmenu:function(c){3==c.which&&a(b).css({left:e,top:f}).show()},click:function(){a(b).hide()}})});},disabledContextMenu:function(){window.oncontextmenu=function(){return!1}}})})(jQuery);function getSelect(){""==(window.getSelection?window.getSelection():document.selection.createRange().text)?layer.msg("啊噢...你没还没选择文字呢!"):document.execCommand("Copy")}function baiduSearch(){var a=window.getSelection?window.getSelection():document.selection.createRange().text;""==a?layer.msg("啊噢...你没还没选择文字呢!"):window.open("https://www.baidu.com/s?wd="+a)}$(function(){for(var a=navigator.userAgent,b="Android;iPhone;SymbianOS;Windows Phone;iPad;iPod".split(";"),d=!0,c=0;c<b.length;c++)if(0<a.indexOf(b[c])){d=!1;break}d&&($.mouseMoveShow(".usercm"),$.disabledContextMenu())});</script>

原版源码:依赖 jQuery + sweetalert2 + layer.js + font-awesome 四个库,且有一个严重的性能问题 —— 在 mousemove 回调里反复绑定 contextmenu,实测移动 30 次就累积 30 个监听器。问题已逐条说明。

① 严重性能问题:每次鼠标移动都重新绑定事件

这是最要命的一处。原版把 contextmenu 和 click 的绑定写在了 mousemove 的回调里面:

```js

a(window).mousemove(function(g){

...

a("html").on({contextmenu: function(){...}, click: function(){...}}); // ← 每次移动都绑一遍

});

```

我做了对照实验,移动鼠标 30 次后派发一次右键事件:

写法 一次右键触发了几次
匿名函数(原版这种) 30 次
具名函数 1 次

原因是:匿名函数每次都是新对象,浏览器不会去重,于是每移动一像素就多一个监听器挂在 html 上。鼠标随便划拉几秒钟就能累积几百个,浏览一分钟轻松上千。后果是右键一次要执行上千次同样的逻辑,页面越来越卡,内存也一路涨。

这个 bug 很隐蔽——刚打开页面时完全正常,用久了才卡,很难联想到是右键菜单的问题。

改法:绑定只做一次,放到 mousemove 外面。

② 引了 4 个库,其中 sweetalert2 根本没用到

```html

<script src="https://cdn.jsdelivr.net/npm/sweetalert2@8"></script>

```

扫了一遍代码,sweetalert2 从头到尾没被调用。真正用到的只有:

库 用在哪 必需?
jQuery $.extend、$(window).mousemove 是
layer.js layer.msg() 两处提示 是
font-awesome 5 个 fa fa-* 图标 class 是
sweetalert2 无 否,纯多余

为一个菜单引四个库,其中一个是白加载的。而且 sweetalert2 本身体积不小,CDN 一慢就拖累首屏。

③ 全局 a{text-decoration:none} 会污染全站

内联样式第一条就是 a{text-decoration:none}——标签选择器,作用于页面上所有链接。我实测过:

链接位置 加了这条之后
正文里(主题设了 underline) 仍是 underline(主题选择器优先级更高)
页脚、侧栏等主题没特别设置的 下划线没了

也就是说,只要主题没给某处链接显式设过下划线,这条规则就会把它去掉——改动了全站不该动的地方。内联 <style> 还没法用 !important 之外的方式覆盖。

改法:限定作用域,比如 .usercm ul li a{text-decoration:none}。

④ document.execCommand('Copy') 已废弃

```js

function getSelect(){ ... document.execCommand("Copy") }

```

document.execCommand() 已被标准废弃,各浏览器逐步移除。现代做法是 navigator.clipboard.writeText()。

⑤ 用 UA 判断移动端,且移动端禁用右键没意义

```js

var b = "Android;iPhone;SymbianOS;Windows Phone;iPad;iPod".split(";")

```

UA 判断本来就容易误判(平板、模拟器、改 UA 的浏览器),更要紧的是:移动端压根没有"右键"这回事。这段代码在移动端的逻辑是"禁用右键菜单"——在触屏设备上完全没作用,白跑。

⑥ disabledContextMenu 用 window.oncontextmenu= 赋值

和前面几篇一样的问题:onXXX = 是赋值,会覆盖其他监听。应该用 addEventListener。

⑦ 内联 onclick

onclick="getSelect();" 这类内联事件在 CSP 环境下会被拦截(前面「禁用 F12」那篇实测过),而且函数必须是全局的,污染命名空间。

修复版 · 零依赖,一次绑定

HTML右键菜单 · 修复版(零依赖)已修复
<style>
/* 作用域限定在 .wxz-cm 内,不会污染全站链接 */
.wxz-cm{position:fixed;min-width:132px;background:#fff;border-radius:8px;
  box-shadow:0 4px 18px rgba(0,0,0,.22);z-index:10000;display:none;overflow:hidden;
  font:13px/1 -apple-system,BlinkMacSystemFont,"PingFang SC",sans-serif}
.wxz-cm.on{display:block}
.wxz-cm ul{list-style:none;margin:0;padding:0}
.wxz-cm li{border-bottom:1px solid #f0f2f7}
.wxz-cm li:last-child{border-bottom:0}
.wxz-cm a{display:flex;align-items:center;gap:10px;padding:0 15px;line-height:35px;
  color:#4a5568;text-decoration:none;cursor:pointer}
.wxz-cm a:hover{background:#eef4ff;color:#2b6cb0}
.wxz-cm a i{font-style:normal;font-size:13px}
.wxz-cm a.is-disabled{color:#c8c8c8;cursor:not-allowed}
.wxz-cm a.is-disabled:hover{background:transparent;color:#c8c8c8}
.cm-zone{padding:56px 20px;text-align:center;background:#fff;
  font:14px/1.9 sans-serif;color:#4a5568;min-height:210px}
.cm-zone h4{margin:0 0 8px;font-size:15px;color:#2d3748}
#cm-toast{position:fixed;left:50%;bottom:28px;transform:translate(-50%,10px);
  padding:9px 16px;border-radius:8px;background:rgba(26,32,44,.94);color:#fff;
  font:13px/1 sans-serif;opacity:0;pointer-events:none;transition:.2s;z-index:10001}
#cm-toast.on{opacity:1;transform:translate(-50%,0)}
</style>

<div class="cm-zone">
  <h4>在这里点右键 →</h4>
  <p>选中一段文字再点右键,「复制选中文字」和「搜索选中内容」会生效。</p>
</div>

<div class="wxz-cm" id="wxz-cm"><ul>
  <li><a data-act="home"><i>🏠</i><span>首页</span></a></li>
  <li><a data-act="copy"><i>📋</i><span>复制选中文字</span></a></li>
  <li><a data-act="reload"><i>🔄</i><span>刷新网页</span></a></li>
  <li><a data-act="search"><i>🔍</i><span>搜索选中内容</span></a></li>
</ul></div>
<div id="cm-toast"></div>

<script>
(function () {
  'use strict';
  var cm = document.getElementById('wxz-cm');
  var toast = document.getElementById('cm-toast');
  var zone = document.querySelector('.cm-zone');
  var timer = null;

  function say(t) {
    if (!toast) return;
    toast.textContent = t;
    toast.classList.add('on');
    if (timer) clearTimeout(timer);
    timer = setTimeout(function () { toast.classList.remove('on'); }, 2000);
  }

  /* 只在边缘时"翻转",避免菜单被窗口裁掉 */
  function place(x, y) {
    cm.style.visibility = 'hidden';
    cm.classList.add('on');
    var w = cm.offsetWidth, h = cm.offsetHeight;
    var vw = window.innerWidth, vh = window.innerHeight;
    if (x + w > vw - 8) x = Math.max(8, x - w);
    if (y + h > vh - 8) y = Math.max(8, y - h);
    cm.style.left = x + 'px';
    cm.style.top = y + 'px';
    cm.style.visibility = '';
  }

  function close() { cm.classList.remove('on'); }

  /* 关键修复:contextmenu 只绑定一次,绝不能放进 mousemove 里 */
  zone.addEventListener('contextmenu', function (e) {
    e.preventDefault();
    place(e.clientX, e.clientY);
  });

  document.addEventListener('click', function (e) {
    if (!cm.contains(e.target)) close();
  });
  window.addEventListener('scroll', close, { passive: true });
  document.addEventListener('keydown', function (e) {
    if (e.key === 'Escape') close();
  });

  /* 用事件委托,不给每个 a 单独绑 */
  cm.addEventListener('click', function (e) {
    var a = e.target.closest ? e.target.closest('a') : null;
    if (!a) return;
    e.preventDefault();
    var act = a.getAttribute('data-act');
    var sel = String(window.getSelection() || '').trim();

    if (act === 'home') { say('跳转到首页'); close(); }
    else if (act === 'reload') { location.reload(); }
    else if (act === 'copy') {
      if (!sel) { say('啊噢…你还没选择文字呢'); close(); return; }
      // 现代 Clipboard API,替代已废弃的 execCommand
      if (navigator.clipboard && navigator.clipboard.writeText) {
        navigator.clipboard.writeText(sel).then(
          function () { say('已复制 ✓'); },
          function () { say('复制失败,请手动复制'); }
        );
      } else {
        say('当前浏览器不支持自动复制');
      }
      close();
    }
    else if (act === 'search') {
      if (!sel) { say('啊噢…你还没选择文字呢'); close(); return; }
      window.open('https://www.baidu.com/s?wd=' + encodeURIComponent(sel), '_blank', 'noopener');
      close();
    }
  });
})();
</script>

修复版:事件只绑定一次(不再随鼠标移动累积)、去掉四个库依赖、选择器限定作用域、改用 Clipboard API。在预览区点右键试试。

改了这些:

  • 事件只绑一次:contextmenu 提到 mousemove 外面,彻底根治监听器累积。
  • 零依赖:不引 jQuery / layer / sweetalert2 / font-awesome,图标用 emoji,提示用自己写的 toast。
  • 选择器限定作用域:.wxz-cm a 而不是全局 a。
  • navigator.clipboard.writeText() 替代废弃的 execCommand,并做了失败兜底。
  • 边缘翻转:菜单贴近窗口右边/下边时自动往回弹,不会被裁掉。
  • 事件委托:菜单项只绑一个 click,用 data-act 分发。
  • 关闭方式更全:点空白处、滚动、按 Esc 都关。
  • 去掉了没用的 sweetalert2。

深色款 · 毛玻璃风格

HTML右键菜单 · 深色毛玻璃款深色款
<style>
.cmz2{padding:56px 20px;text-align:center;min-height:210px;
  background:linear-gradient(135deg,#1a202c,#2d3748);
  font:14px/1.9 sans-serif;color:#e2e8f0}
.cmz2 h4{margin:0 0 8px;font-size:15px;color:#fff}
.cm2{position:fixed;min-width:140px;border-radius:10px;overflow:hidden;display:none;z-index:10000;
  background:rgba(26,32,44,.82);
  -webkit-backdrop-filter:blur(12px) saturate(160%);
  backdrop-filter:blur(12px) saturate(160%);
  border:1px solid rgba(255,255,255,.12);
  box-shadow:0 8px 32px rgba(0,0,0,.4);
  font:13px/1 -apple-system,BlinkMacSystemFont,"PingFang SC",sans-serif}
.cm2.on{display:block}
.cm2 ul{list-style:none;margin:0;padding:4px}
.cm2 a{display:flex;align-items:center;gap:10px;padding:9px 14px;
  color:#e2e8f0;text-decoration:none;cursor:pointer;border-radius:7px}
.cm2 a:hover{background:rgba(255,255,255,.12)}
.cm2 a i{font-style:normal}
#cm2-t{position:fixed;left:50%;bottom:28px;transform:translate(-50%,10px);
  padding:9px 16px;border-radius:8px;background:rgba(255,255,255,.94);color:#1a202c;
  font:13px/1 sans-serif;opacity:0;pointer-events:none;transition:.2s;z-index:10001}
#cm2-t.on{opacity:1;transform:translate(-50%,0)}
</style>

<div class="cmz2">
  <h4>在这里点右键 →</h4>
  <p>深色毛玻璃菜单,适合深色主题。</p>
</div>

<div class="cm2" id="cm2"><ul>
  <li><a data-a="home"><i>🏠</i><span>回到首页</span></a></li>
  <li><a data-a="copy"><i>📋</i><span>复制选中文字</span></a></li>
  <li><a data-a="search"><i>🔍</i><span>搜索选中内容</span></a></li>
  <li><a data-a="top"><i>⬆️</i><span>回到顶部</span></a></li>
</ul></div>
<div id="cm2-t"></div>

<script>
(function () {
  'use strict';
  var cm = document.getElementById('cm2'), t = document.getElementById('cm2-t');
  var zone = document.querySelector('.cmz2'), timer = null;
  function say(x) {
    t.textContent = x; t.classList.add('on');
    if (timer) clearTimeout(timer);
    timer = setTimeout(function () { t.classList.remove('on'); }, 2000);
  }
  function place(x, y) {
    cm.style.visibility = 'hidden'; cm.classList.add('on');
    var w = cm.offsetWidth, h = cm.offsetHeight;
    if (x + w > innerWidth - 8) x = Math.max(8, x - w);
    if (y + h > innerHeight - 8) y = Math.max(8, y - h);
    cm.style.left = x + 'px'; cm.style.top = y + 'px'; cm.style.visibility = '';
  }
  zone.addEventListener('contextmenu', function (e) { e.preventDefault(); place(e.clientX, e.clientY); });
  document.addEventListener('click', function (e) { if (!cm.contains(e.target)) cm.classList.remove('on'); });
  window.addEventListener('scroll', function () { cm.classList.remove('on'); }, { passive: true });
  cm.addEventListener('click', function (e) {
    var a = e.target.closest ? e.target.closest('a') : null;
    if (!a) return;
    e.preventDefault();
    var act = a.getAttribute('data-a'), sel = String(getSelection() || '').trim();
    cm.classList.remove('on');
    if (act === 'home') say('跳转到首页');
    else if (act === 'top') scrollTo({ top: 0, behavior: 'smooth' });
    else if (act === 'copy') {
      if (!sel) { say('啊噢…你还没选择文字呢'); return; }
      if (navigator.clipboard) navigator.clipboard.writeText(sel).then(function(){say('已复制 ✓');},function(){say('复制失败');});
    }
    else if (act === 'search') {
      if (!sel) { say('啊噢…你还没选择文字呢'); return; }
      open('https://www.baidu.com/s?wd=' + encodeURIComponent(sel), '_blank', 'noopener');
    }
  });
})();
</script>

深色毛玻璃款:菜单半透明 + 背景模糊,适合深色主题站点。在预览区点右键试试。

改的时候注意这几点

  • 事件绑定绝不能放进 mousemove 里——这是原版最严重的问题。匿名函数不会被去重,鼠标一动就多一个监听器,页面会越来越卡。
  • 别用全局标签选择器:a{...} 会影响全站。限定成 .菜单类名 a{...}。
  • 菜单要防溢出:靠近窗口右/下边缘时往回弹,否则菜单被裁掉看不见。
  • 移动端没右键:这类菜单在触屏设备上基本用不上,别指望它。想做移动端可以改成"长按触发",但体验也不好。
  • execCommand 已废弃:复制用 navigator.clipboard.writeText(),并写失败兜底(非 HTTPS 页面下 Clipboard API 不可用)。
  • 别把 contextmenu 绑到整个 document 然后 preventDefault:那样全站右键都被禁用,读者想"在新标签页打开""复制图片地址"都用不了,很招人烦。只在特定区域内替换是更友好的做法。
  • 关闭方式要给全:点空白、滚动、Esc 都该关掉菜单。
  • 改菜单项:在 <ul> 里增删 <li>,用 data-act 指定动作,JS 里加对应分支。

怎么用

修复版和深色款都是纯原生 JS,代码块整段粘进 WordPress 的「自定义 HTML」区块即可。

想全站生效,把 <style> 和菜单 <div> 放进 header.php,<script> 放进 footer.php。注意把 zone(触发区域)换成你真正想生效的容器,比如 document.querySelector('.post-content')。

兼容性

contextmenu 事件、navigator.clipboard、closest() 在 Chrome / Edge / Firefox / Safari 全系支持。backdrop-filter 需要 Chrome 76+ / Safari 9+(带 -webkit- 前缀),不支持时深色款会变成纯半透明色块,功能不受影响。Clipboard API 要求 HTTPS,HTTP 站点下自动复制会失败(已做兜底提示)。


代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。

作者:Flechazo

如若转载,请注明出处:维形筑网 https://wxzcw.com

赞 (0)
禁用 F12 与查看源码
上一篇 2026年10月29日 上午11:53
站点访问量统计:页脚显示总访问量与访客数
下一篇 2026年10月29日 下午12:37

相关推荐

维 形 筑 网