上一主题 下一主题
ScriptCat,新一代的脚本管理器脚本站,与全世界分享你的用户脚本油猴脚本开发指南教程目录
返回列表 发新帖

[脚本猫开发指南]用户配置

[复制链接]
  • TA的每日心情
    慵懒
    昨天 00:09
  • 签到天数: 67 天

    [LV.6]常住居民II

    150

    主题

    2001

    帖子

    2133

    积分

    管理员

    Rank: 10Rank: 10Rank: 10

    积分
    2133

    猫咪币纪念章热心会员活跃会员突出贡献三好学生中秋纪念章国庆纪念章管理员家财万贯

    发表于 2021-9-14 16:46:58 | 显示全部楼层 | 阅读模式

    官方文档:用户配置

    配置声明

    为了方便用户配置,脚本猫提供了一个==UserConfig==的注释,使用YAML来进行声明 YAML 语言教程

    在脚本代码中,使用==UserConfig==来包裹住yaml配置内容

    /* ==UserConfig==
    配置内容
     ==/UserConfig== */

    暂时支持如下几种配置:文本、密码、选择框、列表框、数字,主要根据default的声明来进行识别,并且支持配置组,以顶层key为组名称,支持中文,在编写的时候需要注意空格间距,多个配置组之间使用 --- 进行分隔,如果不进行分隔,在未来的更新中可能会出现问题(如果有i18n的计划,可能会使用顶层key来声明i18n)

    /* ==UserConfig==
    group1:
      configA:                                # 键值为group.config,例如本键为:group1.configA
        title: 配置A                          # 配置的标题
        description: 这是一个文本类型的配置     # 配置的描述内容
        default: 默认值                       # 配置的默认值
        min: 2                                # 文本最短2个字符
        max: 18                               # 文本最长18个字符
        password: true                        # 设置为密码
      configB:
        title: 配置B
        description: 这是一个选择框的配置
        default: true
      configC:
        title: 配置C
        description: 这是一个列表选择的配置
        default: 1
        values: [1,2,3,4,5]
      configD:
        title: 配置D
        description: 这是一个数字的配置
        default: 1
        min: 10  # 最小值
        max: 16  # 最大值
        unit: 分 # 表示单位
    ---
    group2:
      configX:
        title: 配置A
        description: 这是一个文本类型的配置
        default: 默认值
     ==/UserConfig== */

    读取配置

    定义完成后,会在控制面板中显示配置按钮,供用户配置,开发者使用GM_getValue获取配置的值,key使用group.config来表示。

    因为使用的是Value的原因,可以使用@storageName来共享多个脚本之间的配置,并且配置的修改是实时更新的。

    上不慕古,下不肖俗。为疏为懒,不敢为狂。为拙为愚,不敢为恶。/ 微信公众号:一之哥哥
  • TA的每日心情
    开心
    2022-7-5 00:02
  • 签到天数: 124 天

    [LV.7]常住居民III

    10

    主题

    180

    帖子

    930

    积分

    版主

    Rank: 8Rank: 8

    积分
    930

    活跃会员猫咪币纪念章推广达人宣传达人突出贡献三好学生热心会员中秋纪念章国庆纪念章荣誉开发者家财万贯

    发表于 2021-9-14 18:00:11 | 显示全部楼层
    好,学着搞
    是晚柒载哟
    回复

    使用道具 举报

    发表回复

    本版积分规则

    快速回复 返回顶部 返回列表