@htmlos/contextmenu
TypeScript icon, indicating that this package has built-in type declarations

0.1.25 • Public • Published

Html5 ContextMenu

npm

A simple and easy-to-use contextmenu library for html5

DEMO https://htmlos.github.io/ContextMenu/

Features

  • [X] Supports html5, vue, react and other frameworks
  • [X] Support infinite submenu
  • [X] Support menu item click event callback
  • [X] Support menu item disabled
  • [X] Support menu item icon
  • [X] Support menu item hotkey description
  • [X] Support auto fixed position (keep all menus visible in browser visible area)
  • [X] Support auto hide (when clicking outside area of ​​menu/adjusting browser window size/scrolling page/pressing ESC)
  • [X] Support custom css style & animation

Browser Compatibility

Browser Chrome FireFox IE Edge Safari Opera
Version 27 21 9 12 6 15

Usage

  • Install
# npm
npm i @htmlos/contextmenu
# yarn
yarn add @htmlos/contextmenu
  • Import
import {ContextMenu, ContextMenuOptions} from "@htmlos/contextmenu";
import "@htmlos/contextmenu/dist/contextmenu.css";
  • Custom style: please refer to contextmenu.css

    • Internally use position: fixed, which will cause some styles of some elements to be invalid (such as .contextmenu and .contextmenu_item of margin, need to use padding adjustment)
    • Don't use animation attribute for .contextmenu, this may not only be invisible during the loading process, but also affect the subsequent automatic positioning
    • Do not use animations that affect the size. If used, it may cause typographical disturbances, because the menu is already fixed size after being visible
    • Other attributes please test by yourself
  • Config:

// ContextMenu.config(options: ContextMenuOptions);
ContextMenu.config({
  i18n: function(s){
    return your_translate_function(s) || s;
  },
  style: {
      // custom animation: [string, number] => [className, duration],
      // defaults to [ "contextmenu-in", 0], [ "contextmenu-out", 0]
      contextmenuIn: ['fade-in', 200],
      contextmenuOut: ['fade-out', 200],
  },
});
  • Show
const menu=[
  { // item
    name: "reload",
    icon: "./reload.png",
    disabled: false,
    onclick: ()=>{},
    hotkey: "ctrl+r",
    children: [
      //...
    ]
  },
  {}, // divider
  //...
]

menu[0].children=menu; // nested infinite submenu

Contextmenu.show(menu);
  • Hide
// auto hide or manually
Contextmenu.hide();

Build

yarn config set disturl https://npm.taobao.org/dist -g
yarn config set electron_mirror https://npm.taobao.org/mirrors/electron/ -g
yarn config set sass_binary_site https://npm.taobao.org/mirrors/node-sass/ -g
yarn config set phantomjs_cdnurl https://npm.taobao.org/mirrors/phantomjs/ -g
yarn config set chromedriver_cdnurl https://cdn.npm.taobao.org/dist/chromedriver -g
yarn config set operadriver_cdnurl https://cdn.npm.taobao.org/dist/operadriver -g
yarn config set fse_binary_host_mirror https://npm.taobao.org/mirrors/fsevents -g

yarn install
yarn build

License

MIT

Package Sidebar

Install

npm i @htmlos/contextmenu

Weekly Downloads

48

Version

0.1.25

License

MIT

Unpacked Size

322 kB

Total Files

73

Last publish

Collaborators

  • robotic