mirror of
https://github.com/ether/etherpad-lite.git
synced 2025-11-04 10:11:33 +01:00
477 lines
11 KiB
JavaScript
477 lines
11 KiB
JavaScript
/**
|
|
* This code is mostly from the old Etherpad. Please help us to comment this code.
|
|
* This helps other people to understand this code better and helps them to improve it.
|
|
* TL;DR COMMENTS ON THIS FILE ARE HIGHLY APPRECIATED
|
|
*/
|
|
|
|
/**
|
|
* Copyright 2009 Google Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS-IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
var padutils = {
|
|
escapeHtml: function(x)
|
|
{
|
|
return String(x).replace(/[&"<>]/g, function (c) {
|
|
return {
|
|
'&': '&',
|
|
'"': '"',
|
|
'<': '<',
|
|
'>': '>'
|
|
}[c] || c;
|
|
});
|
|
},
|
|
uniqueId: function()
|
|
{
|
|
var pad = require('/pad').pad; // Sidestep circular dependency
|
|
function encodeNum(n, width)
|
|
{
|
|
// returns string that is exactly 'width' chars, padding with zeros
|
|
// and taking rightmost digits
|
|
return (Array(width + 1).join('0') + Number(n).toString(35)).slice(-width);
|
|
}
|
|
return [pad.getClientIp(), encodeNum(+new Date, 7), encodeNum(Math.floor(Math.random() * 1e9), 4)].join('.');
|
|
},
|
|
uaDisplay: function(ua)
|
|
{
|
|
var m;
|
|
|
|
function clean(a)
|
|
{
|
|
var maxlen = 16;
|
|
a = a.replace(/[^a-zA-Z0-9\.]/g, '');
|
|
if (a.length > maxlen)
|
|
{
|
|
a = a.substr(0, maxlen);
|
|
}
|
|
return a;
|
|
}
|
|
|
|
function checkver(name)
|
|
{
|
|
var m = ua.match(RegExp(name + '\\/([\\d\\.]+)'));
|
|
if (m && m.length > 1)
|
|
{
|
|
return clean(name + m[1]);
|
|
}
|
|
return null;
|
|
}
|
|
|
|
// firefox
|
|
if (checkver('Firefox'))
|
|
{
|
|
return checkver('Firefox');
|
|
}
|
|
|
|
// misc browsers, including IE
|
|
m = ua.match(/compatible; ([^;]+);/);
|
|
if (m && m.length > 1)
|
|
{
|
|
return clean(m[1]);
|
|
}
|
|
|
|
// iphone
|
|
if (ua.match(/\(iPhone;/))
|
|
{
|
|
return 'iPhone';
|
|
}
|
|
|
|
// chrome
|
|
if (checkver('Chrome'))
|
|
{
|
|
return checkver('Chrome');
|
|
}
|
|
|
|
// safari
|
|
m = ua.match(/Safari\/[\d\.]+/);
|
|
if (m)
|
|
{
|
|
var v = '?';
|
|
m = ua.match(/Version\/([\d\.]+)/);
|
|
if (m && m.length > 1)
|
|
{
|
|
v = m[1];
|
|
}
|
|
return clean('Safari' + v);
|
|
}
|
|
|
|
// everything else
|
|
var x = ua.split(' ')[0];
|
|
return clean(x);
|
|
},
|
|
// e.g. "Thu Jun 18 2009 13:09"
|
|
simpleDateTime: function(date)
|
|
{
|
|
var d = new Date(+date); // accept either number or date
|
|
var dayOfWeek = (['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'])[d.getDay()];
|
|
var month = (['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'])[d.getMonth()];
|
|
var dayOfMonth = d.getDate();
|
|
var year = d.getFullYear();
|
|
var hourmin = d.getHours() + ":" + ("0" + d.getMinutes()).slice(-2);
|
|
return dayOfWeek + ' ' + month + ' ' + dayOfMonth + ' ' + year + ' ' + hourmin;
|
|
},
|
|
findURLs: function(text)
|
|
{
|
|
// copied from ACE
|
|
var _REGEX_WORDCHAR = /[\u0030-\u0039\u0041-\u005A\u0061-\u007A\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF\u0100-\u1FFF\u3040-\u9FFF\uF900-\uFDFF\uFE70-\uFEFE\uFF10-\uFF19\uFF21-\uFF3A\uFF41-\uFF5A\uFF66-\uFFDC]/;
|
|
var _REGEX_URLCHAR = new RegExp('(' + /[-:@a-zA-Z0-9_.,~%+\/?=&#;()$]/.source + '|' + _REGEX_WORDCHAR.source + ')');
|
|
var _REGEX_URL = new RegExp(/(?:(?:https?|s?ftp|ftps|file|smb|afp|nfs|(x-)?man|gopher|txmt):\/\/|mailto:)/.source + _REGEX_URLCHAR.source + '*(?![:.,;])' + _REGEX_URLCHAR.source, 'g');
|
|
|
|
// returns null if no URLs, or [[startIndex1, url1], [startIndex2, url2], ...]
|
|
|
|
|
|
function _findURLs(text)
|
|
{
|
|
_REGEX_URL.lastIndex = 0;
|
|
var urls = null;
|
|
var execResult;
|
|
while ((execResult = _REGEX_URL.exec(text)))
|
|
{
|
|
urls = (urls || []);
|
|
var startIndex = execResult.index;
|
|
var url = execResult[0];
|
|
urls.push([startIndex, url]);
|
|
}
|
|
|
|
return urls;
|
|
}
|
|
|
|
return _findURLs(text);
|
|
},
|
|
escapeHtmlWithClickableLinks: function(text, target)
|
|
{
|
|
var idx = 0;
|
|
var pieces = [];
|
|
var urls = padutils.findURLs(text);
|
|
|
|
function advanceTo(i)
|
|
{
|
|
if (i > idx)
|
|
{
|
|
pieces.push(padutils.escapeHtml(text.substring(idx, i)));
|
|
idx = i;
|
|
}
|
|
}
|
|
if (urls)
|
|
{
|
|
for (var j = 0; j < urls.length; j++)
|
|
{
|
|
var startIndex = urls[j][0];
|
|
var href = urls[j][1];
|
|
advanceTo(startIndex);
|
|
pieces.push('<a ', (target ? 'target="' + target + '" ' : ''), 'href="', padutils.escapeHtml(href), '">');
|
|
advanceTo(startIndex + href.length);
|
|
pieces.push('</a>');
|
|
}
|
|
}
|
|
advanceTo(text.length);
|
|
return pieces.join('');
|
|
},
|
|
bindEnterAndEscape: function(node, onEnter, onEscape)
|
|
{
|
|
|
|
// Use keypress instead of keyup in bindEnterAndEscape
|
|
// Keyup event is fired on enter in IME (Input Method Editor), But
|
|
// keypress is not. So, I changed to use keypress instead of keyup.
|
|
// It is work on Windows (IE8, Chrome 6.0.472), CentOs (Firefox 3.0) and Mac OSX (Firefox 3.6.10, Chrome 6.0.472, Safari 5.0).
|
|
if (onEnter)
|
|
{
|
|
node.keypress(function(evt)
|
|
{
|
|
if (evt.which == 13)
|
|
{
|
|
onEnter(evt);
|
|
}
|
|
});
|
|
}
|
|
|
|
if (onEscape)
|
|
{
|
|
node.keydown(function(evt)
|
|
{
|
|
if (evt.which == 27)
|
|
{
|
|
onEscape(evt);
|
|
}
|
|
});
|
|
}
|
|
},
|
|
timediff: function(d)
|
|
{
|
|
var pad = require('/pad').pad; // Sidestep circular dependency
|
|
function format(n, word)
|
|
{
|
|
n = Math.round(n);
|
|
return ('' + n + ' ' + word + (n != 1 ? 's' : '') + ' ago');
|
|
}
|
|
d = Math.max(0, (+(new Date) - (+d) - pad.clientTimeOffset) / 1000);
|
|
if (d < 60)
|
|
{
|
|
return format(d, 'second');
|
|
}
|
|
d /= 60;
|
|
if (d < 60)
|
|
{
|
|
return format(d, 'minute');
|
|
}
|
|
d /= 60;
|
|
if (d < 24)
|
|
{
|
|
return format(d, 'hour');
|
|
}
|
|
d /= 24;
|
|
return format(d, 'day');
|
|
},
|
|
makeAnimationScheduler: function(funcToAnimateOneStep, stepTime, stepsAtOnce)
|
|
{
|
|
if (stepsAtOnce === undefined)
|
|
{
|
|
stepsAtOnce = 1;
|
|
}
|
|
|
|
var animationTimer = null;
|
|
|
|
function scheduleAnimation()
|
|
{
|
|
if (!animationTimer)
|
|
{
|
|
animationTimer = window.setTimeout(function()
|
|
{
|
|
animationTimer = null;
|
|
var n = stepsAtOnce;
|
|
var moreToDo = true;
|
|
while (moreToDo && n > 0)
|
|
{
|
|
moreToDo = funcToAnimateOneStep();
|
|
n--;
|
|
}
|
|
if (moreToDo)
|
|
{
|
|
// more to do
|
|
scheduleAnimation();
|
|
}
|
|
}, stepTime * stepsAtOnce);
|
|
}
|
|
}
|
|
return {
|
|
scheduleAnimation: scheduleAnimation
|
|
};
|
|
},
|
|
makeShowHideAnimator: function(funcToArriveAtState, initiallyShown, fps, totalMs)
|
|
{
|
|
var animationState = (initiallyShown ? 0 : -2); // -2 hidden, -1 to 0 fade in, 0 to 1 fade out
|
|
var animationFrameDelay = 1000 / fps;
|
|
var animationStep = animationFrameDelay / totalMs;
|
|
|
|
var scheduleAnimation = padutils.makeAnimationScheduler(animateOneStep, animationFrameDelay).scheduleAnimation;
|
|
|
|
function doShow()
|
|
{
|
|
animationState = -1;
|
|
funcToArriveAtState(animationState);
|
|
scheduleAnimation();
|
|
}
|
|
|
|
function doQuickShow()
|
|
{ // start showing without losing any fade-in progress
|
|
if (animationState < -1)
|
|
{
|
|
animationState = -1;
|
|
}
|
|
else if (animationState <= 0)
|
|
{
|
|
animationState = animationState;
|
|
}
|
|
else
|
|
{
|
|
animationState = Math.max(-1, Math.min(0, -animationState));
|
|
}
|
|
funcToArriveAtState(animationState);
|
|
scheduleAnimation();
|
|
}
|
|
|
|
function doHide()
|
|
{
|
|
if (animationState >= -1 && animationState <= 0)
|
|
{
|
|
animationState = 1e-6;
|
|
scheduleAnimation();
|
|
}
|
|
}
|
|
|
|
function animateOneStep()
|
|
{
|
|
if (animationState < -1 || animationState == 0)
|
|
{
|
|
return false;
|
|
}
|
|
else if (animationState < 0)
|
|
{
|
|
// animate show
|
|
animationState += animationStep;
|
|
if (animationState >= 0)
|
|
{
|
|
animationState = 0;
|
|
funcToArriveAtState(animationState);
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
funcToArriveAtState(animationState);
|
|
return true;
|
|
}
|
|
}
|
|
else if (animationState > 0)
|
|
{
|
|
// animate hide
|
|
animationState += animationStep;
|
|
if (animationState >= 1)
|
|
{
|
|
animationState = 1;
|
|
funcToArriveAtState(animationState);
|
|
animationState = -2;
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
funcToArriveAtState(animationState);
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
|
|
return {
|
|
show: doShow,
|
|
hide: doHide,
|
|
quickShow: doQuickShow
|
|
};
|
|
},
|
|
_nextActionId: 1,
|
|
uncanceledActions: {},
|
|
getCancellableAction: function(actionType, actionFunc)
|
|
{
|
|
var o = padutils.uncanceledActions[actionType];
|
|
if (!o)
|
|
{
|
|
o = {};
|
|
padutils.uncanceledActions[actionType] = o;
|
|
}
|
|
var actionId = (padutils._nextActionId++);
|
|
o[actionId] = true;
|
|
return function()
|
|
{
|
|
var p = padutils.uncanceledActions[actionType];
|
|
if (p && p[actionId])
|
|
{
|
|
actionFunc();
|
|
}
|
|
};
|
|
},
|
|
cancelActions: function(actionType)
|
|
{
|
|
var o = padutils.uncanceledActions[actionType];
|
|
if (o)
|
|
{
|
|
// clear it
|
|
delete padutils.uncanceledActions[actionType];
|
|
}
|
|
},
|
|
makeFieldLabeledWhenEmpty: function(field, labelText)
|
|
{
|
|
field = $(field);
|
|
|
|
function clear()
|
|
{
|
|
field.addClass('editempty');
|
|
field.val(labelText);
|
|
}
|
|
field.focus(function()
|
|
{
|
|
if (field.hasClass('editempty'))
|
|
{
|
|
field.val('');
|
|
}
|
|
field.removeClass('editempty');
|
|
});
|
|
field.blur(function()
|
|
{
|
|
if (!field.val())
|
|
{
|
|
clear();
|
|
}
|
|
});
|
|
return {
|
|
clear: clear
|
|
};
|
|
},
|
|
getCheckbox: function(node)
|
|
{
|
|
return $(node).is(':checked');
|
|
},
|
|
setCheckbox: function(node, value)
|
|
{
|
|
if (value)
|
|
{
|
|
$(node).attr('checked', 'checked');
|
|
}
|
|
else
|
|
{
|
|
$(node).removeAttr('checked');
|
|
}
|
|
},
|
|
bindCheckboxChange: function(node, func)
|
|
{
|
|
$(node).bind("click change", func);
|
|
},
|
|
encodeUserId: function(userId)
|
|
{
|
|
return userId.replace(/[^a-y0-9]/g, function(c)
|
|
{
|
|
if (c == ".") return "-";
|
|
return 'z' + c.charCodeAt(0) + 'z';
|
|
});
|
|
},
|
|
decodeUserId: function(encodedUserId)
|
|
{
|
|
return encodedUserId.replace(/[a-y0-9]+|-|z.+?z/g, function(cc)
|
|
{
|
|
if (cc == '-') return '.';
|
|
else if (cc.charAt(0) == 'z')
|
|
{
|
|
return String.fromCharCode(Number(cc.slice(1, -1)));
|
|
}
|
|
else
|
|
{
|
|
return cc;
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
//send javascript errors to the server
|
|
window.onerror = function test (msg, url, linenumber)
|
|
{
|
|
var errObj = {errorInfo: JSON.stringify({msg: msg, url: url, linenumber: linenumber, userAgent: navigator.userAgent})};
|
|
var loc = document.location;
|
|
var url = loc.protocol + "//" + loc.hostname + ":" + loc.port + "/" + loc.pathname.substr(1, loc.pathname.indexOf("/p/")) + "jserror";
|
|
|
|
$.post(url, errObj);
|
|
|
|
return false;
|
|
};
|
|
|
|
padutils.binarySearch = require('/ace2_common').binarySearch;
|
|
|
|
exports.padutils = padutils;
|