TSLibrary - Generic

A resource JS library file providing common useful functions to be used by other scripts
当前为 2016-10-22 提交的版本，查看最新版本。
此脚本不应直接安装，它是供其他脚本使用的外部库。如果您需要使用该库，请在脚本元属性加入：// @require https://update.cn-greasyfork.org/scripts/19968/153743/TSLibrary%20-%20Generic.js
提供反馈或发布讨论，或举报此脚本。
换行
// ==UserScript==
// @name                    TSLibrary - Generic
// @namespace               TimidScript
// @version                 1.0.18.2
// @description             A resource JS library file providing common useful functions to be used by other scripts
// @author                  TimidScript
// @homepageURL             https://github.com/TimidScript
// @copyright               © 2014+ TimidScript, Some Rights Reserved.
// @license                 https://github.com/TimidScript/UserScripts/blob/master/license.txt
// @exclude                 *
// ==/UserScript==
 
 
/* License + Copyright Notice
********************************************************************************************
License can be found at: https://github.com/TimidScript/UserScripts/blob/master/license.txt
Below is a copy of the license the may not be up-to-date.
 
Copyright © TimidScript, Some Rights Reserved.
 
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 that does not conflict with the rest of the license (http://www.gnu.org/licenses/gpl-3.0.en.html)
2) This notice must be included
3) Due credits and link to original author's homepage (included in this notice).
4) Notify the original author of redistribution
5) Clear clarification of the License and Notice to the end user
6) Do not upload on OpenUserJS.org or any other site that infringes on this license
 
TimidScript's Homepages:  GitHub:      https://github.com/TimidScript
                          GreasyFork:  https://greasyfork.org/users/1455
*/
/* Information
********************************************************************************************
    Version History
----------------------------------------------
1.0.18 (2016-05-27)
 - License altered
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