realms-wiki/realms/static/js/dillinger.js

570 lines
15 KiB
JavaScript

$(function () {
var url_prefix = "/wiki";
var $theme = $('#theme-list')
, $preview = $('#preview')
, $autosave = $('#autosave')
, $wordcount = $('#wordcount')
, $wordcounter = $('#wordcounter')
, $pagename = $("#page-name");
var editor
, autoInterval
, profile =
{
theme: 'ace/theme/idle_fingers', currentMd: '', autosave: {
enabled: true, interval: 3000 // might be too aggressive; don't want to block UI for large saves.
}, current_filename: $pagename.val()
};
// Feature detect ish
var dillinger = 'dillinger'
, dillingerElem = document.createElement(dillinger)
, dillingerStyle = dillingerElem.style
, domPrefixes = 'Webkit Moz O ms Khtml'.split(' ');
/// UTILS =================
/**
* Utility method to async load a JavaScript file.
*
* @param {String} The name of the file to load
* @param {Function} Optional callback to be executed after the script loads.
* @return {void}
*/
function asyncLoad(filename, cb) {
(function (d, t) {
var leScript = d.createElement(t)
, scripts = d.getElementsByTagName(t)[0];
leScript.async = 1;
leScript.src = filename;
scripts.parentNode.insertBefore(leScript, scripts);
leScript.onload = function () {
cb && cb();
}
}(document, 'script'));
}
/**
* Utility method to determin if localStorage is supported or not.
*
* @return {Boolean}
*/
function hasLocalStorage() {
// http://mathiasbynens.be/notes/localstorage-pattern
var storage;
try {
if (localStorage.getItem) {
storage = localStorage
}
} catch (e) {
}
return storage;
}
/**
* Grab the user's profile from localStorage and stash in "profile" variable.
*
* @return {Void}
*/
function getUserProfile() {
var p;
try {
p = JSON.parse(localStorage.profile);
// Need to merge in any undefined/new properties from last release
// Meaning, if we add new features they may not have them in profile
p = $.extend(true, profile, p);
} catch (e) {
p = profile
}
if (p.filename != $pagename.val()) {
updateUserProfile({ filename: $pagename.val(), currentMd: "" });
}
profile = p;
}
/**
* Update user's profile in localStorage by merging in current profile with passed in param.
*
* @param {Object} An object containg proper keys and values to be JSON.stringify'd
* @return {Void}
*/
function updateUserProfile(obj) {
localStorage.clear();
localStorage.profile = JSON.stringify($.extend(true, profile, obj));
}
/**
* Utility method to test if particular property is supported by the browser or not.
* Completely ripped from Modernizr with some mods.
* Thx, Modernizr team!
*
* @param {String} The property to test
* @return {Boolean}
*/
function prefixed(prop) {
return testPropsAll(prop, 'pfx')
}
/**
* A generic CSS / DOM property test; if a browser supports
* a certain property, it won't return undefined for it.
* A supported CSS property returns empty string when its not yet set.
*
* @param {Object} A hash of properties to test
* @param {String} A prefix
* @return {Boolean}
*/
function testProps(props, prefixed) {
for (var i in props) {
if (dillingerStyle[ props[i] ] !== undefined) {
return prefixed === 'pfx' ? props[i] : true;
}
}
return false
}
/**
* Tests a list of DOM properties we want to check against.
* We specify literally ALL possible (known and/or likely) properties on
* the element including the non-vendor prefixed one, for forward-
* compatibility.
*
* @param {String} The name of the property
* @param {String} The prefix string
* @return {Boolean}
*/
function testPropsAll(prop, prefixed) {
var ucProp = prop.charAt(0).toUpperCase() + prop.substr(1)
, props = (prop + ' ' + domPrefixes.join(ucProp + ' ') + ucProp).split(' ');
return testProps(props, prefixed);
}
/**
* Normalize the transitionEnd event across browsers.
*
* @return {String}
*/
function normalizeTransitionEnd() {
var transEndEventNames =
{
'WebkitTransition': 'webkitTransitionEnd', 'MozTransition': 'transitionend', 'OTransition': 'oTransitionEnd', 'msTransition': 'msTransitionEnd' // maybe?
, 'transition': 'transitionend'
};
return transEndEventNames[ prefixed('transition') ];
}
/**
* Get current filename from contenteditable field.
*
* @return {String}
*/
function getCurrentFilenameFromField() {
return $('#filename > span[contenteditable="true"]').text()
}
/**
* Set current filename from profile.
*
* @param {String} Optional string to force set the value.
* @return {String}
*/
function setCurrentFilenameField(str) {
$('#filename > span[contenteditable="true"]').text(str || profile.current_filename || "Untitled Document")
}
/**
* Returns the full text of an element and all its children.
* The script recursively traverses all text nodes, and returns a
* concatenated string of all texts.
*
* Taken from
* http://stackoverflow.com/questions/2653670/innertext-textcontent-vs-retrieving-each-text-node
*
* @param node
* @return {int}
*/
function getTextInElement(node) {
if (node.nodeType === 3) {
return node.data;
}
var txt = '';
if (node = node.firstChild) do {
txt += getTextInElement(node);
} while (node = node.nextSibling);
return txt;
}
/**
* Counts the words in a string
*
* @param string
* @return int
*/
function countWords(string) {
var words = string.replace(/W+/g, ' ').match(/\S+/g);
return words && words.length || 0;
}
/**
* Initialize application.
*
* @return {Void}
*/
function init() {
if (!hasLocalStorage()) {
sadPanda()
}
else {
// Attach to jQuery support object for later use.
$.support.transitionEnd = normalizeTransitionEnd();
getUserProfile();
initAce();
initUi();
bindPreview();
bindNav();
bindKeyboard();
autoSave();
}
}
function initAce() {
editor = ace.edit("editor");
editor.focus();
}
function initUi() {
// Set proper theme value in theme dropdown
fetchTheme(profile.theme, function () {
$theme.find('li > a[data-value="' + profile.theme + '"]').addClass('selected');
editor.getSession().setUseWrapMode(true);
editor.setShowPrintMargin(false);
editor.getSession().setMode('ace/mode/markdown');
editor.getSession().setValue(profile.currentMd || editor.getSession().getValue());
previewMd();
});
// Set text for dis/enable autosave / word counter
$autosave.html(profile.autosave.enabled ? '<i class="icon-remove"></i>&nbsp;Disable Autosave' : '<i class="icon-ok"></i>&nbsp;Enable Autosave');
$wordcount.html(!profile.wordcount ? '<i class="icon-remove"></i>&nbsp;Disabled Word Count' : '<i class="icon-ok"></i>&nbsp;Enabled Word Count');
setCurrentFilenameField();
/* BEGIN RE-ARCH STUFF */
$('.dropdown-toggle').dropdown();
/* END RE-ARCH STUFF */
}
function clearSelection() {
editor.getSession().setValue("");
previewMd();
}
function saveFile(isManual) {
updateUserProfile({currentMd: editor.getSession().getValue()});
if (isManual) {
updateUserProfile({ currentMd: "" });
var data = {
name: $pagename.val(),
message: $("#page-message").val(),
content: editor.getSession().getValue()
};
$.post(window.location, data, function () {
location.href = url_prefix + '/' + data['name'];
});
}
}
function autoSave() {
if (profile.autosave.enabled) {
autoInterval = setInterval(function () {
// firefox barfs if I don't pass in anon func to setTimeout.
saveFile();
}, profile.autosave.interval);
} else {
clearInterval(autoInterval)
}
}
$("#save-native").on('click', function () {
saveFile(true);
});
function resetProfile() {
// For some reason, clear() is not working in Chrome.
localStorage.clear();
// Let's turn off autosave
profile.autosave.enabled = false
// Delete the property altogether --> need ; for JSHint bug.
;
delete localStorage.profile;
// Now reload the page to start fresh
window.location.reload();
}
function changeTheme(e) {
// check for same theme
var $target = $(e.target);
if ($target.attr('data-value') === profile.theme) {
return;
}
else {
// add/remove class
$theme.find('li > a.selected').removeClass('selected');
$target.addClass('selected');
// grabnew theme
var newTheme = $target.attr('data-value');
$(e.target).blur();
fetchTheme(newTheme, function () {
});
}
}
function fetchTheme(th, cb) {
var name = th.split('/').pop();
asyncLoad("/static/js/ace/theme-" + name + ".js", function () {
editor.setTheme(th);
cb && cb();
updateBg(name);
updateUserProfile({theme: th});
});
}
function updateBg(name) {
// document.body.style.backgroundColor = bgColors[name]
}
function previewMd() {
var unmd = editor.getSession().getValue()
, md = MDR.convert(unmd, true);
$preview
.html('') // unnecessary?
.html(md);
//refreshWordCount();
}
function updateFilename(str) {
// Check for string because it may be keyup event object
var f;
if (typeof str === 'string') {
f = str;
} else {
f = getCurrentFilenameFromField();
}
updateUserProfile({ current_filename: f });
}
function showHtml() {
// TODO: UPDATE TO SUPPORT FILENAME NOT JUST A RANDOM FILENAME
var unmd = editor.getSession().getValue();
function _doneHandler(jqXHR, data, response) {
// console.dir(resp)
var resp = JSON.parse(response.responseText);
$('#myModalBody').text(resp.data);
$('#myModal').modal();
}
function _failHandler() {
alert("Roh-roh. Something went wrong. :(");
}
var config = {
type: 'POST',
data: "unmd=" + encodeURIComponent(unmd),
dataType: 'json',
url: '/factory/fetch_html_direct',
error: _failHandler,
success: _doneHandler
};
$.ajax(config)
}
function sadPanda() {
// TODO: ACTUALLY SHOW A SAD PANDA.
alert('Sad Panda - No localStorage for you!')
}
function toggleAutoSave() {
$autosave.html(profile.autosave.enabled ? '<i class="icon-remove"></i>&nbsp;Disable Autosave' : '<i class="icon-ok"></i>&nbsp;Enable Autosave');
updateUserProfile({autosave: {enabled: !profile.autosave.enabled }});
autoSave();
}
function bindPreview() {
editor.getSession().on('change', function (e) {
previewMd();
});
}
function bindNav() {
$theme
.find('li > a')
.bind('click', function (e) {
changeTheme(e);
return false;
});
$('#clear')
.on('click', function () {
clearSelection();
return false;
});
$("#autosave")
.on('click', function () {
toggleAutoSave();
return false;
});
$('#reset')
.on('click', function () {
resetProfile();
return false;
});
$('#cheat').
on('click', function () {
window.open("https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet", "_blank");
return false;
});
} // end bindNav()
function bindKeyboard() {
// CMD+s TO SAVE DOC
key('command+s, ctrl+s', function (e) {
saveFile(true);
e.preventDefault(); // so we don't save the web page - native browser functionality
});
var saveCommand = {
name: "save",
bindKey: {
mac: "Command-S",
win: "Ctrl-S"
},
exec: function () {
saveFile(true);
}
};
editor.commands.addCommand(saveCommand);
}
init();
});
function getScrollHeight($prevFrame) {
// Different browsers attach the scrollHeight of a document to different
// elements, so handle that here.
if ($prevFrame[0].scrollHeight !== undefined) {
return $prevFrame[0].scrollHeight;
} else if ($prevFrame.find('html')[0].scrollHeight !== undefined &&
$prevFrame.find('html')[0].scrollHeight !== 0) {
return $prevFrame.find('html')[0].scrollHeight;
} else {
return $prevFrame.find('body')[0].scrollHeight;
}
}
function syncPreview() {
var $ed = window.ace.edit('editor');
var $prev = $('#preview');
var editorScrollRange = ($ed.getSession().getLength());
var previewScrollRange = (getScrollHeight($prev));
// Find how far along the editor is (0 means it is scrolled to the top, 1
// means it is at the bottom).
var scrollFactor = $ed.getFirstVisibleRow() / editorScrollRange;
// Set the scroll position of the preview pane to match. jQuery will
// gracefully handle out-of-bounds values.
$prev.scrollTop(scrollFactor * previewScrollRange);
}
window.onload = function () {
var $loading = $('#loading');
if ($.support.transition) {
$loading
.bind($.support.transitionEnd, function () {
$('#main').removeClass('bye');
$loading.remove();
})
.addClass('fade_slow');
} else {
$('#main').removeClass('bye');
$loading.remove();
}
/**
* Bind synchronization of preview div to editor scroll and change
* of editor cursor position.
*/
window.ace.edit('editor').session.on('changeScrollTop', syncPreview);
window.ace.edit('editor').session.selection.on('changeCursor', syncPreview);
};