A resource JS library file providing common useful functions to be used by other scripts
目前为
此脚本不应直接安装，它是一个供其他脚本使用的外部库。如果您需要使用该库，请在脚本元属性加入：// @require https://update.greasyfork.icu/scripts/19968/127656/TSLibrary%20-%20Generic.js
// ==UserScript==
// @name TSLibrary - Generic
// @namespace TimidScript
// @version 1.0.17
// @description A resource JS library file providing common useful functions to be used by other scripts
// @author TimidScript
// @homepageURL https://github.com/TimidScript
// @copyright © 2016 TimidScript, Some Rights Reserved.
// @license Creative Commons BY-NC-SA + Read the License inside the script
// @exclude *
// ==/UserScript==
/* License + Copyright Notice
********************************************************************************************
Copyright © TimidScript, Some Rights Reserved.
GNU General Public License v3 (GPL-3) - http://www.gnu.org/licenses/gpl-3.0.en.html
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
1) GPL-3 License is met
2) This copyright must be included
3) Due credits and link to original author's homepage (included in copyright).
4) Notify the original author of redistribution
5) Clear clarification to end user of the GPL-3 license
TimidScript's Homepages: [GitHub](https://github.com/TimidScript)
[OpenUserJS](https://openuserjs.org/users/TimidScript)
[GreasyFork](https://greasyfork.org/users/1455-timidscript
*/
/* Information
********************************************************************************************
Version History
----------------------------------------------
1.0.17 (2016-04-03)
- Changed license to GPL-3
1.0.16 (2015-07-20)
- addScript and addStyle return created nodes
- Change location of addScript to head instead of body incase of dynamic pages that alter the body
1.0.15 (2015-06-18)
- updateDocumentURL renamed to updateURL
1.0.14 (2015-06-18)
- Using \b for regex in class functions
- Better handling of spaces in the class functions
1.0.13 (2015-01-16)
- updateDocumentURL added
1.0.12 (2014-12-12)
- @exclude added
1.0.11 (2014-10-12)
- innerHTML instead of textContent for scripts and CSS.
1.0.10 (2014-09-17)
- Optimised - When adding or removing a class it now first checks
it exists thus avoiding to make any extra changes.
- Ability to add or remove more than one class. Separator is space.
- hasClass also handles more than one class. Returns true only
if all classes are present.
- addClass, removeClass return true if class is added or removed
1.0.9 (2014-09-07)
- Fixed bug in addScript and moved the script to the head instead of body.
- CSS appended to textContent instead of innerHTML
1.0.8 (2014-09-05)
- Improved removeClass
- Added absolutePosition(element)
1.0.7 (2014-09-02)
- Functions added: addClass removeClass hasClass
- Removed makeStruct as it is useless
1.0.6 (2014-08-29)
- Changed the NTFS chars http://unicode-search.net
1.0.5 (2014-08-24)
- TSL part no longer commented out
1.0.4
- Added new functions createElement, createElementHTML function
- Partial support for non-main document
1.0.3
- Added NTFS illegal character replacer
- escape regular expression function
1.0.2
- Added scroll bar thickness
1.0.1
- Initial Release
**********************************************************************************************/
var TimidScriptLibrary =
{
//http://unicode-search.net
ALTNTFSChars: [[">", "＞"],
["<", "＜"],
[":", "："],
['"', "＂"],
["/", "／"],
["\\", "＼"],
["?", "？"],
["*", "＊"]],
removeNode: function (node, doc)
{
if (!doc) doc = document;
if (typeof node == "string") node = doc.getElementById(node);
if (node && node.parentElement) node.parentElement.removeChild(node);
},
addStyle: function (id, CSS, doc)
{
if (!doc) doc = document;
var style = doc.createElement("style");
style.type = "text/css";
if (id)
{
style.id = id;
TimidScriptLibrary.removeNode(id, doc);
}
style.innerHTML = CSS;
doc.head.appendChild(style);
return style;
},
addScript: function (id, text, doc)
{
if (!doc) doc = document;
var script = doc.createElement("script");
if (id)
{
script.id = id;
TimidScriptLibrary.removeNode(id, doc);
}
script.innerHTML = text;
doc.head.appendChild(script);
return script;
},
createElement: function (tag, attributes, doc)
{
if (!doc) doc = document;
var el = doc.createElement(tag);
for (var x in attributes) el.setAttribute(x, attributes[x]);
return el;
},
createElementHTML: function (html, doc)
{
if (!doc) doc = document;
var el = doc.createElement("e");
el.innerHTML = html;
return el.firstElementChild;
},
paddingLeft: function (str, chr, length)
{
while (str.length < length)
str = chr + str;
return str;
},
paddingRight: function (str, chr, length)
{
while (str.length < length)
str = str + chr;
return str;
},
isMouseEventInClientArea: function (event, element)
{
var rect = element.getBoundingClientRect();
var minX = rect.left + element.clientLeft;
var x = event.clientX;
if (x < minX || x >= minX + element.clientWidth) return false;
var minY = rect.top + element.clientTop;
var y = event.clientY;
if (y < minY || y >= minY + element.clientHeight) return false;
return true;
},
getScrollBarThickness: function ()
{
var outer = document.createElement("div");
outer.style.visibility = "hidden";
outer.style.width = "100px";
document.body.appendChild(outer);
var widthNoScroll = outer.offsetWidth;
// force scrollbars
outer.style.overflow = "scroll";
// add innerdiv
var inner = document.createElement("div");
inner.style.width = "100%";
outer.appendChild(inner);
var widthWithScroll = inner.offsetWidth;
// remove divs
outer.parentNode.removeChild(outer);
return widthNoScroll - widthWithScroll;
},
escapeRegExp: function (str)
{
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
return str.replace(/([.*+?^=!:${}()|\[\]\/\\])/g, "\\$1");
},
replaceNTFSIllegals: function (str)
{
for (var i = 0; i < TimidScriptLibrary.ALTNTFSChars.length; i++)
{
var rx = new RegExp(TimidScriptLibrary.escapeRegExp(TimidScriptLibrary.ALTNTFSChars[i][0]), "gi");
str = str.replace(rx, TimidScriptLibrary.ALTNTFSChars[i][1]);
}
return str;
},
addClass: function (node, names)
{
var altered = false;
var newclass = node.className;
var classes = names.replace(/\s+/g, " ").trim().split(" ");
for (var i = 0; i < classes.length; i++)
{
//var re = new RegExp("(^|\\s+)" + classes[i] + "(\\s+|$)");
var re = new RegExp("\\b" + classes[i] + "\\b");
if (!newclass.match(re))
{
newclass += " " + classes[i];
altered = true;
}
}
if (altered) node.className = newclass.replace(/\s+/g, " ").trim();
return altered;
},
removeClass: function (node, names)
{
var altered = false;
var newclass = node.className;
var classes = names.replace(/(\s)\s+/g, " ").trim().split(" ");
for (var i = 0; i < classes.length; i++)
{
//var re = new RegExp("(^|\\s+)" + classes[i] + "(\\s+|$)");
var re = new RegExp("\\b" + classes[i] + "\\b");
if (newclass.match(re))
{
newclass = newclass.replace(re, " ");
altered = true;
}
}
if (altered) node.className = newclass.replace(/\s+/g, " ").trim();
return altered;
},
hasClass: function (node, names)
{
var classes = names.replace(/(\s)\s+/g, " ").trim().split(" ");
for (var i = 0; i < classes.length; i++)
{
//var re = new RegExp("(^|\\s+)" + classes[i] + "(\\s+|$)");
var re = new RegExp("\\b" + classes[i] + "\\b");
if (!node.className.match(re)) return false;
}
return true;
},
getAbsolutePosition: function (element)
{
var x = 0;
var y = 0;
while (element && !isNaN(element.offsetLeft) && !isNaN(element.offsetTop))
{
x += element.offsetLeft;
y += element.offsetTop;
element = element.offsetParent;
}
return { top: y, left: x };
},
updateURL: function (url)
{
window.history.pushState(null, "", url);
}
}
//#region TimidScript Library Functions
/*
Copy and paste the code underneath into your script for quick reference
and auto-complete feature if available.
*********************************************************************************/
var TSL = new Object();
//Remove node from document. Accepts id or node object
TSL.removeNode = function (node, doc) { TimidScriptLibrary.removeNode(node, doc); };
// Creates document element. Default doc value is the document.
TSL.createElement = function (tag, attributes, doc) { return TimidScriptLibrary.createElement(tag, attributes, doc) };
// Creates document element using html code. Default doc value is the document.
TSL.createElementHTML = function (html, doc) { return TimidScriptLibrary.createElementHTML(html, doc) };
//Add CSS styles to document header. Document can be left empty.
TSL.addStyle = function (id, CSS, doc) { return TimidScriptLibrary.addStyle(id, CSS, doc); };
//Add JS script to document header. Document can be left empty.
TSL.addScript = function (id, script, doc) { return TimidScriptLibrary.addScript(id, script, doc); };
// Checks if mouse event is within an elements client area
TSL.isMouseEventInClientArea = function (event, element) { return TimidScriptLibrary.isMouseEventInClientArea(event, element); };
// Gets the position of the element within the document
TSL.getAbsolutePosition = function (element) { return TimidScriptLibrary.getAbsolutePosition(element); };
//Returns the thickness of the scrollbar
TSL.getScrollBarThickness = function () { return TimidScriptLibrary.getScrollBarThickness(); };
//Array containing NTFS illegal characters alternatives
TSL.ALTNTFSChars = TimidScriptLibrary.ALTNTFSChars;
TSL.replaceNTFSIllegals = function (str) { return TimidScriptLibrary.replaceNTFSIllegals(str); };
TSL.escapeRegExp = function (str) { return TimidScriptLibrary.escapeRegExp(str); };
//String Padding
String.prototype.lPad = function (chr, length) { return TimidScriptLibrary.paddingLeft(this, chr[0], length); };
String.prototype.rPad = function (chr, length) { return TimidScriptLibrary.paddingRight(this, chr[0], length); };
//Node className functions. All three functions can handle multiple classes separated by spaces
TSL.addClass = function (node, names) { return TimidScriptLibrary.addClass(node, names); };
TSL.removeClass = function (node, names) { return TimidScriptLibrary.removeClass(node, names); };
TSL.hasClass = function (node, names) { return TimidScriptLibrary.hasClass(node, names); };
//Allows you to change the document URL, which is reflected in the URL bar.
TSL.updateURL = function (url) { TimidScriptLibrary.updateURL(url); };
/*
*********************************************************************************/
//#endregion