☰

GM_webextPref

A config library powered by webext-pref.

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.cn-greasyfork.org/scripts/371339/961539/GM_webextPref.js

如何安装

您需要先安装一个扩展，例如 篡改猴、Greasemonkey 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 Userscripts ，之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展，例如 Tampermonkey，才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

（我已经安装了用户脚本管理器，让我安装！）

如何安装

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

（我已经安装了用户样式管理器，让我安装！）

作者
eight
版本
0.4.2
创建于
2018-08-19
更新于
2021-08-18
大小
42.6 KB
许可证
MIT

GM_webextPref

Build Status codecov

Use webext-pref in userscripts. This library includes createPref, createView, a storage object implemented with GM API, and a dialog service.

Installation

You can @require this script from Greasy Fork.

This library is also hosted on npm so you can import it with a build tool:

npm install gm-webext-pref

import GM_webextPref from "gm-webext-pref";

Grant

This script uses following permissions:

// @grant GM_getValue
// @grant GM.getValue
// @grant GM_setValue
// @grant GM.setValue
// @grant GM_deleteValue
// @grant GM.deleteValue
// @grant GM_addValueChangeListener
// @grant GM_registerMenuCommand
// @grant GM.registerMenuCommand

Demo

https://rawgit.com/eight04/GM_webextPref/master/demo/demo.html

Usage

const pref = GM_webextPref({
  default: {
    useImage: true,
    excludeElements: "code, .highlight"
  },
  body: [
    {
      key: "useImage",
      type: "checkbox",
      label: "Use image"
    },
    {
      key: "excludeElements",
      type: "text",
      label: "Exclude elements"
    }
  ]
});

pref.ready()
  .then(() => {
    console.log(pref.get("useImage")); // true
  });

API

This module exports a single function.

GM_webextPref

const pref = GM_webextPref({
  default: Object,
  separator?: String,
  css?: String,
  ...options
});

Create a pref object. pref inherits all methods from the pref object returned by createPref.

default and separator would be sent to createPref.

css would be injected to the dialog for customization.

Other options would be passed to createUI and createBinding.

If GM_registerMenuCommand exists, the function would register a menu command like:

GM_registerMenuCommand(GM_info.script.name + " - Configure", pref.openDialog);

So that users can open the config dialog through monkey menu.

pref.openDialog

pref.openDialog();

Open the config dialog.

Changelog

  • 0.4.2 (Aug 18, 2021)

    • Add: pass more options to createBinding, createUI, and createPref.
    • Add: css option.

  • 0.4.1 (Aug 17, 2021)

    • Add: support GM4 menu.

  • 0.4.0 (Aug 19, 2020)

  • 0.3.0 (Aug 25, 2018)

    • Update webext-pref to 0.5.0. Now the script requires GM_deleteValue/GM.deleteValue APIs.

  • 0.2.1 (Aug 24, 2018)

    • Update webext-pref to 0.4.1. Add navbar tooltips.

  • 0.2.0 (Aug 21, 2018)

    • Update webext-pref to 0.4.0. Drop translate arg.

  • 0.1.5 (Aug 20, 2018)

    • Update webext-pref to 0.3.5. Fixed navbar error.

  • 0.1.4 (Aug 19, 2018)

    • Add: style help text.

  • 0.1.3 (Aug 19, 2018)

    • Fix: import/export buttons.
    • Enhance: larger title.

  • 0.1.2 (Aug 19, 2018)

    • Add: style checkbox children.

  • 0.1.1 (Aug 19, 2018)

    • Fix: missing metadata.

  • 0.1.0 (Aug 19, 2018)

    • First release.