GUACAMOLE-55: Update clipboardService to support non-text contents.

This commit is contained in:
Michael Jumper
2016-06-28 13:43:31 -07:00
parent 6e4e6454f7
commit ea5ee1825b
3 changed files with 293 additions and 205 deletions

View File

@@ -113,160 +113,6 @@ angular.module('clipboard').directive('guacClipboard', ['$injector',
*/
var element = $element[0];
/**
* Modifies the contents of the given element such that it contains
* only plain text. All non-text child elements will be stripped and
* replaced with their text equivalents. As this function performs the
* conversion through incremental changes only, cursor position within
* the given element is preserved.
*
* @param {Element} element
* The elements whose contents should be converted to plain text.
*/
var convertToText = function convertToText(element) {
// For each child of the given element
var current = element.firstChild;
while (current) {
// Preserve the next child in the list, in case the current
// node is replaced
var next = current.nextSibling;
// If the child is not already a text node, replace it with its
// own text contents
if (current.nodeType !== Node.TEXT_NODE) {
var textNode = document.createTextNode(current.textContent);
current.parentElement.replaceChild(textNode, current);
}
// Advance to next child
current = next;
}
};
/**
* Parses the given data URL, returning its decoded contents as a new
* Blob. If the URL is not a valid data URL, null will be returned
* instead.
*
* @param {String} url
* The data URL to parse.
*
* @returns {Blob}
* A new Blob containing the decoded contents of the data URL, or
* null if the URL is not a valid data URL.
*/
var parseDataURL = function parseDataURL(url) {
// Parse given string as a data URL
var result = /^data:([^;]*);base64,([a-zA-Z0-9+/]*[=]*)$/.exec(url);
if (!result)
return null;
// Pull the mimetype and base64 contents of the data URL
var type = result[1];
var data = $window.atob(result[2]);
// Convert the decoded binary string into a typed array
var buffer = new Uint8Array(data.length);
for (var i = 0; i < data.length; i++)
buffer[i] = data.charCodeAt(i);
// Produce a proper blob containing the data and type provided in
// the data URL
return new Blob([buffer], { type : type });
};
/**
* Replaces the current text content of the given element with the
* given text. To avoid affecting the position of the cursor within an
* editable element, or firing unnecessary DOM modification events, the
* underlying <code>textContent</code> property of the element is only
* touched if doing so would actually change the text.
*
* @param {Element} element
* The element whose text content should be changed.
*
* @param {String} text
* The text content to assign to the given element.
*/
var setTextContent = function setTextContent(element, text) {
// Strip out any non-text content while preserving cursor position
convertToText(element);
// Reset text content only if doing so will actually change the content
if (element.textContent !== text)
element.textContent = text;
};
/**
* Returns the URL of the single image within the given element, if the
* element truly contains only one child and that child is an image. If
* the content of the element is mixed or not an image, null is
* returned.
*
* @param {Element} element
* The element whose image content should be retrieved.
*
* @returns {String}
* The URL of the image contained within the given element, if that
* element contains only a single child element which happens to be
* an image, or null if the content of the element is not purely an
* image.
*/
var getImageContent = function getImageContent(element) {
// Return the source of the single child element, if it is an image
var firstChild = element.firstChild;
if (firstChild && firstChild.nodeName === 'IMG' && !firstChild.nextSibling)
return firstChild.getAttribute('src');
// Otherwise, the content of this element is not simply an image
return null;
};
/**
* Replaces the current contents of the given element with a single
* image having the given URL. To avoid affecting the position of the
* cursor within an editable element, or firing unnecessary DOM
* modification events, the content of the element is only touched if
* doing so would actually change content.
*
* @param {Element} element
* The element whose image content should be changed.
*
* @param {String} url
* The URL of the image which should be assigned as the contents of
* the given element.
*/
var setImageContent = function setImageContent(element, url) {
// Retrieve the URL of the current image contents, if any
var currentImage = getImageContent(element);
// If the current contents are not the given image (or not an image
// at all), reassign the contents
if (currentImage !== url) {
// Clear current contents
element.innerHTML = '';
// Add a new image as the sole contents of the element
var img = document.createElement('img');
img.src = url;
element.appendChild(img);
}
};
// Intercept paste events, handling image data specifically
element.addEventListener('paste', function dataPasted(e) {
@@ -320,11 +166,11 @@ angular.module('clipboard').directive('guacClipboard', ['$injector',
// If the clipboard contains a single image, parse and assign the
// image data to the internal clipboard
var currentImage = getImageContent(element);
var currentImage = clipboardService.getImageContent(element);
if (currentImage) {
// Convert the image's data URL into a blob
var blob = parseDataURL(currentImage);
var blob = clipboardService.parseDataURL(currentImage);
if (blob) {
// Complete the assignment if conversion was successful
@@ -372,7 +218,7 @@ angular.module('clipboard').directive('guacClipboard', ['$injector',
// If the clipboard data is a string, render it as text
if (typeof data.data === 'string')
setTextContent(element, data.data);
clipboardService.setTextContent(element, data.data);
// Render Blob/File contents based on mimetype
else if (data.data instanceof Blob) {
@@ -380,7 +226,7 @@ angular.module('clipboard').directive('guacClipboard', ['$injector',
// If the copied data was an image, display it as such
if (/^image\//.exec(data.type)) {
reader.onload = function updateImageURL() {
setImageContent(element, reader.result);
clipboardService.setImageContent(element, reader.result);
};
reader.readAsDataURL(data.data);
}