前端小技巧:实现自定义右键菜单(Context Menu)

MudOnTire

logo

鼠标右击网页会弹出默认的浏览器菜单,但是很多时候我们需要自定义右键菜单(比如:在线文档编辑器、定制视频播放器等)。今天我们就来快速实现一个自定义右键菜单。

预览:

demo

contextmenu 事件监听

首先,我们需要禁用浏览器弹出默认菜单的行为,通过阻止 contextMenu 事件的默认行为,并同时触发自定义菜单的显示:

document.addEventListener("contextmenu", (e) => {
  e.preventDefault();
  showMenu(e);
});

构造菜单

1. 实现单例

一个页面中菜单应该只有一个实例,所以我们运用单例模式去创建菜单,典型的单例构造器可以实现为:

const ContextMenu = function (options) {
  // 唯一实例
  let instance;

  // 创建实例方法
  function createMenu() {
    // todo
  }

  return {
    // 获取实例的唯一方式
    getInstance: function () {
      if (!instance) {
        instance = createMenu();
      }
      return instance;
    },
  };
};

2. 创建菜单实例

即实现上面的 createMenu 方法。

菜单的具体配置通过 options 传入,options 的结构定义为:

 options: {
  menus: [{
    name: string, // 菜单名称
    onClick: Function // 菜单点击回调
  }]
 }

通过遍历 options.menus 生成菜单列表,并挂载到 body 中,并最终返回菜单的实例:

function createMenu() {
  const ul = document.createElement("ul");
  ul.classList.add("custom-context-menu");
  const { menus } = options;
  if (menus && menus.length > 0) {
    for (let menu of menus) {
      const li = document.createElement("li");
      li.textContent = menu.name;
      li.onclick = menu.onClick;
      ul.appendChild(li);
    }
  }
  const body = document.querySelector("body");
  body.appendChild(ul);
  return ul;
}

创建菜单的主要逻辑就完成了。

3. 初始化菜单

接下来向 ContextMenu 中传入 options 以初始化单例构造器:

const menuSinglton = ContextMenu({
  menus: [
    {
      name: "custom menu 1",
      onClick: function (e) {
        console.log("menu1 clicked");
      },
    },
    {
      name: "custom menu 2",
      onClick: function (e) {
        console.log("menu2 clicked");
      },
    },
    {
      name: "custom menu 3",
      onClick: function (e) {
        console.log("menu3 clicked");
      },
    },
  ],
});

初始化完成后,便可以通过 menuSinglton.getInstance() 获取菜单实例了。

显示菜单

当我们右击页面时,获取到鼠标的坐标,设置菜单为固定定位(position: fixed),并将其左上角位置设置为鼠标坐标,以实现菜单在鼠标点击位置的弹出:

function showMenu(e) {
  const menus = menuSinglton.getInstance();
  menus.style.top = `${e.clientY}px`;
  menus.style.left = `${e.clientX}px`;
  menus.style.display = "block";
}

隐藏菜单

最后,当我们点击页面中的其他区域时需要将菜单隐藏:

function hideMenu(e) {
  const menus = menuSinglton.getInstance();
  menus.style.display = "none";
}

document.addEventListener("click", hideMenu);

大功告成!!

本文Demo参考:Codepen Trick by Day (2020-07-05) Custom Context Menus

每天一个小技巧,量变引起质变,希望你和我一起每天多学一点,让技术有趣一点。

所有示例将会汇总到我的 tricks-by-day github项目中,欢迎大家莅临指导 😊

阅读 3.1k

半路出家老菜鸟
一个年近三十,半路出家,搬砖糊口,又做着春秋大梦的老菜鸟的小小日记。
6.7k 声望
3.5k 粉丝
0 条评论
6.7k 声望
3.5k 粉丝
文章目录
宣传栏