<!DOCTYPE html>
<html>
<head>
<link rel="shortcut icon" href="https://palhube666.wodemo.net/entry/539442/3bb276234ca6ec04b770595e3865c56e/favicon.jpg" type="image/x-icon" />
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Vie浏览器脚本使用文档</title>
<style>
*{outline-color:rgb(0,232,204);-webkit-tap-highlight-color:rgba(0,232,204,0.1);}
.accordion{background-color:#eee;color:#000;cursor: pointer;padding: 18px;width: 100%;text-align: left;border: none;outline: none;transition: 0.4s;}
.active,.accordion:hover {background-color: #ccc;}
.panel{padding: 0 18px;background-color:#fff;max-height: 0;overflow: hidden;transition: max-height 0.2s ease-out;}
.accordion:after{content:'详情';color: #777;font-weight: bold;float: right;margin-left: 5px;}
.active:after{content:'收起';}
.text{color:#666;font-size:65%;}
.an {border: none;color: white;padding: 4px 8px;text-align: center;text-decoration: none;display: inline-block;font-size: 16px;margin: 4px 2px;-webkit-transition-duration: 0.4s;transition-duration: 0.4s;cursor: pointer;}
.ann {background-color: white;color: black;border: 2px solid #777;}
.ann:hover {background-color: #777;color: white;}
</style>
</head>
<body>
<h2>Vie浏览器脚本使用文档V1.6</h2>
<button id="az" style="display:none" class="accordion">注意：<span class="text">您的浏览器不支持直接安装，请下载Vie</span></button>
<div class="panel">
<button class="an ann" onclick="">安装Vie</button>
</p>
</div>
<p>点击查看详情：</p>
<button class="accordion">元数据</button>
<div class="panel">
<p>
<br>Vie内的脚本运行需要元数据来规范
<br>元数据放置在整个脚本的开头
<br>主要起到对脚本 描述，参数设定，声明等
<br>包括 脚本名称、简介、作者、版本号、运行方式、所需油猴函数 等。
<br>
<br>下面是Vie新建脚本的默认样式：
<br>
<br>// ==UserScript==
<br>// @name New Userscript
<br>// @namespace https://palhube666.wodemo.com
<br>// @version 0.1
<br>// @description Give it a try!
<br>// @author You
<br>// @run-at document-start
<br>// @match https://*/*
<br>// @grant none
<br>// ==/UserScript==
<br>
<br>(function() {
<br> //hello world!
<br>})();
</p>
</div>
<button class="accordion">支持的元数据标签</button>
<div class="panel">
<p>
<br>@name
<br>//脚本的名称
<br>
<br>@namespace
<br>//脚本的的名称空间，用于区别同名脚本
<br>
<br>@description
<br>//脚本的介绍，描述脚用法和功能
<br>
<br>@icon，@iconURL，@icon64，@icon64URL
<br>//脚本的图标，可以是链接 或者 是data开头的base64编码
<br>//其中@iconURL，@icon64，@icon64URL均会被Vie自动转为@icon
<br>
<br>@author
<br>//脚本的作者昵称
<br>
<br>@version
<br>//脚本的版本号
<br>
<br>@homepage，@homepageURL，@website，@source
<br>//作者主页或者脚本主页（官网）
<br>
<br>@antifeature
<br>//声明获利方式，ads、tracking、miner
<br>
<br>@match
<br>//脚本的作用域，脚本执行的网址，不支持正则表达式，任意位置包含即可，与@include区别具体见下
<br>
<br>@include
<br>//脚本的作用域，脚本执行的网址，支持正则表达式，从头开始匹配，与@match区别具体见下
<br>
<br>@exclude
<br>//脚本的不作用域，在@incluide里排除，优先级高于@incluide
<br>
<br>@exclude-match
<br>//脚本的不作用域，在@match里排除，优先级高于@match
<br>
<br>@require
<br>//脚本的第三方库，脚本本身开始运行之前加载和执行的 第三方JavaScript
<br>
<br>@resource
<br>//脚本的所需文件，执行需要依赖的一些资源文件，如css，文本，图片
<br>
<br>@updateURL
<br>//脚本的更新网址，需配合@version使用
<br>
<br>@noframes
<br>//脚本不在frame内运行（默认使用该属性，暂时不支持取消）
<br>
<br>@run-at
<br>//脚本的执行时机，取值见下
<br>
<br>@resource
<br>//使用方法见下
<br>
<br>@grant
<br>//脚本申请的函数，在元数据中声明使用哪些油猴函数，取值见下
</p>
</div>
<button class="accordion">> @match与@include区别</button>
<div class="panel">
<p>
<br>区别①
<br>使用@match包含即可
<br>使用@include从头开始匹配
<br>如：
<br>// @match bilibili.*
<br>此时 可以 在 https://m.bilibili.com/ 运行
<br>
<br>// @include bilibili.*
<br>此时 无法 在 https://m.bilibili.com/ 运行
<br>
<br>@include需改为：
<br>// @include *://*.bilibili.*/
<br>或者
<br>// @include https://*.bilibili.*/
<br>或者
<br>// @include /\.bilibili\.com[\.\/]/
<br>方可 在 https://m.bilibili.com/ 运行
<br>
<br>区别②
<br>@include 等价于 正则+@match
<br>//@include可以使用正则而@match不行
<br>//@include使用正则时，需在开头结尾加上/
<br>如:
<br>@include /\.bilibili\.com[\.\/]/
</p>
</div>
<button class="accordion">> @run-at在Vie里支持的取值</button>
<div class="panel">
<p>
<br>document-start与document-end无法同时使用！
<br>如同时使用默认为document-end
<br>
<br>document-start
<br>//指定脚本在DOM树开始的时候执行，需要脚本尽早执行的时候添加此声明
<br>
<br>document-end
<br>//指定脚本在DOM数据加载完毕的时候执行
<br>//当元数据没有@run-at声明时，脚本默认在此时机执行
<br>/*注意：document-end和document-idle在Vie里不做区分
<br>*部分脚本作者（比如之前的我）混淆了执行时机的区别，如果区分会导致执行失败
<br>*如果需要区分：
<br>*Vie的document-end就是tampermonkey的document-idle
<br>*而要实现tampermonkey的document-end，可以将@run-at设为document-start并且使用document.addEventListener('DOMContentLoaded',function)即可
<br>*/
<br>
<br>document-menu
<br>context-menu
<br>//表示此脚本不自动执行，从主动脚本里手动执行
<br>//使用这个会无视@match与@include和@exclude
<br>/*注意：Vie的document-menu和tampermonkey的context-menu效果在Vie相同
<br>*document-menu为Vie的扩展声明
<br>*方便作者本人测试使用
<br>*/
</p>
</div>
<button class="accordion">> 如何使用@resource</button>
<div class="panel">
<p>
<br>在元数据中的格式为 // @resource name fileUrl
<br>可使用GM_getResourceText和GM_getResourceURL进行获取
<br>
<br>
<br> 其中@grant在Vie里支持的函数有：
<br>
<br>//支持GM_*与GM.*(下只写出GM_*)
<br>GM_addStyle
<br>GM_setValue
<br>GM_getValue
<br>GM_deleteValue
<br>GM_listValues
<br>GM_setClipboard
<br>GM_addElement
<br>GM_download
<br>GM_openInTab
<br>GM_log
<br>GM_notification
<br>GM_registerMenuCommand
<br>GM_unregisterMenuCommand
<br>GM_info
<br>GM_getResourceText
<br>GM_getResourceURL
<br>GM_xmlhttpRequest
<br>使用方法见下
<br>
<br>暂时未支持的有：
<br>GM_addValueChangeListener
<br>GM_removeValueChangeListener
<br>GM_getTabs
<br>GM_saveTab
<br>GM_getTab
</p>
</div>
<button class="accordion">油猴函数使用方法</button>
<div class="panel">
<p>
<br>//支持GM_*与GM.*(下面只示范GM_*)
<br>
<br>GM_addStyle(css样式)
<br>//返回创建的style标签
<br>//示例：
<br>GM_addStyle("#ad{display:none;");
<br>
<br>
<br>GM_addScript(javascript代码)
<br>//返回创建的script标签
<br>//示例：
<br>GM_addScript("alert('hhh')");
<br>GM_addScript("alert(\"hhh\")");
<br>//内容包含 " 或者 \ 或者 + 时需要转义，如： \" 或者 \\ 或者 \+ 下面不再重复
<br>
<br>
<br>①GM_addElement(标签名称, 标签属性)
<br>②GM_addElement(父控件,标签名称,标签属性)
<br>//返回创建的标签
<br>//示例：
<br>①无父控件
<br>GM_addElement('script', {textContent:'alert("hhh')"});
<br>②创建在指定父控件中
<br>GM_addElement(document.getElementsByTagName('div')[0],'img',{src:'https://www.bilibili.com/favicon.ico'});
<br>
<br>
<br>GM_setValue(键值,内容)
<br>//无返回值
<br>//示例：
<br>GM_setValue('魔法ソジュ','アイ');
<br>
<br>
<br>①GM_getValue(键值)
<br>②GM_getValue(键值,默认值)
<br>//能获取key的值时返回key的值，获取失败时返回default
<br>//示例：
<br>①获取失败返回null
<br>GM_getValue('魔法ソジュ');