src/core/window/clipboard.js - main - githubmirror/amphtml

src/core/window/clipboard.js
92 строки3 KB
mangesh
✨ Register API action for copy-to-clipboard function (#35799)
17 фев 2022, 00:41
17 фев 2022, 00:41aab7a10
import {removeElement} from '#core/dom';
import {setStyles} from '#core/dom/style';

/**
 * Copies provided text to clipboard using deprecated API: document.execCommand('copy')
 * @param {Window} win Window context
 * @param {string} text Text to copy
 * @return {boolean} Return true on copy-success
 */
export function deprecatedCopyTextToClipboard(win, text) {
  let copySuccessful = false;
  const doc = win.document;

  const textarea =
    /** @type {HTMLTextAreaElement} */
    (doc.createElement('textarea'));

  setStyles(textarea, {
    'position': 'fixed',
    'top': 0,
    'left': 0,
    'width': '50px',
    'height': '50px',
    'padding': 0,
    'border': 'none',
    'outline': 'none',
    'background': 'transparent',
  });

  textarea.value = text;
  textarea.readOnly = true;
  textarea.contentEditable = 'true';

  doc.body.appendChild(textarea);
  win.getSelection()?.removeAllRanges();

  textarea./*OK*/ focus();
  textarea.setSelectionRange(0, text.length);

  try {
    copySuccessful = doc.execCommand('copy');
  } catch (e) {
    // 🤷
  }

  removeElement(textarea);

  return copySuccessful;
}

/**
 * @param {Document} doc Document context
 * @return {boolean} Returns true if copying support is available with deprecated API
 */
export function isDeprecatedCopyingToClipboardSupported(doc) {
  return doc.queryCommandSupported('copy');
}

/**
 * Copies provided text to clipboard using 'navigator.clipboard' API.
 * It will try to use deprecated API if 'navigator.clipboard' is not supported.
 * @param {Window} win Window context
 * @param {string} text Text to copy
 * @param {function():void} successCallback Executes when copying is successful
 * @param {function():void} failCallback Executes when copying is failed
 */
export function copyTextToClipboard(win, text, successCallback, failCallback) {
  // Check which method is supported for the browser
  if (win.navigator?.clipboard) {
    // Try copying with `navigator.clipboard` API
    win.navigator.clipboard.writeText(text).then(successCallback, failCallback);
  } else if (
    // Try copying with deprecated API as a fallback support
    isDeprecatedCopyingToClipboardSupported(win.document) &&
    deprecatedCopyTextToClipboard(win, text)
  ) {
    successCallback();
  } else {
    failCallback();
  }
}

/**
 * @param {Document} doc Document context
 * @return {boolean} Returns true if copying support is available with new (or with deprecated) API
 */
export function isCopyingToClipboardSupported(doc) {
  return (
    !!doc.defaultView?.navigator?.clipboard ||
    isDeprecatedCopyingToClipboardSupported(doc)
  );
}