$Config

Allows users to configure scripts

目前為 2024-11-25 提交的版本，檢視最新版本。

此腳本不應該直接安裝，它是一個供其他腳本使用的函式庫。欲使用本函式庫，請在腳本 metadata 寫上： // @require https://update.cn-greasyfork.org/scripts/446506/1491127/%24Config.js

發表問題、評論、或檢舉該腳本。

作者: ctl2
版本: 0.0.1.20241125231604
建立日期: 2022-06-15
更新日期: 2024-11-25
尺寸: 282.9 KB
授權條款: 未知

Example instance hosted here. Source code available here.

Usage

// Request a config

const $config = new $Config(
    'Example Title',
    'STORAGE_KEY',
    {
        'children': [
            {'label': 'node0'},
            {'label': 'node1'},
            {'label': 'node2'}
        ]
    },
    ([node0, node1, node2]) => ({
        value0: node0.value,
        value1: node1.value,
        value2: node2.value,
    }),
);

// Await config load & handle problems

try {
    await $config.ready();
} catch (error) {
    if (!$config.reset) {
        // There's a problem with the arguments passed to the $Config constructor
        throw error;
    }

    // There's a problem with the user's data (could be from manual editing or a script update)
    if (!window.confirm(`${error.message}\n\nWould you like to erase your data?`)) {
        return;
    }

    $config.reset();
}

// Apply the user's config

function useConfig() {
    const {value0, value1, value2} = $config.get();

    // Use the config...
}

useConfig();

// Set up config editing

const button = document.createElement('button');

button.addEventListener('click', async () => {
    await $config.edit();

    useConfig();
});

Constructor arguments (* = optional):

[string] An identifier used to store data
[Root] A schema for user config data
[ParentCallback] The function used to convert tree data into a convenient format for your script
[string] The config modal's title
[DefaultStyle*] Instructions for customizing the UI's appearance
[object*] CSS to apply to the UI's root element

See the following scripts for practical examples: