ClipboardData: Difference between revisions
Created page with "event.clipboardData.getData(''type'') event.clipboardData.setData(''type'', ''value'') file:Clipboarddata.png == Description == ClipboardData lets you access the data o..." |
|||
Line 21: | Line 21: | ||
| setData(''type'', value) || Put ''value'' on the clipboard with type of ''type''. | | setData(''type'', value) || Put ''value'' on the clipboard with type of ''type''. | ||
|- | |- | ||
| oncopy(event) || Called when the user copies from an input field. | | oncopy(''event'') || Called when the user copies from an input field. | ||
|- | |- | ||
| getData('' | | getData(''event'') || Called when the user cuts from an input field. | ||
|- | |- | ||
| getData('' | | getData(''event'') || Called when the user pastes to an input field. | ||
|} | |} | ||
Revision as of 19:55, 15 January 2017
event.clipboardData.getData(type) event.clipboardData.setData(type, value)
Description
ClipboardData lets you access the data on the clipboard. You can modify the data cut or copied to the clipboard, as well as data pasted from the clipboard. It can be used in Input, Textarea and Textbox controls in all frameworks. It is available in the event object passed to the oncopy, oncut and onpaste events.
Implementation of clipboard data is uneven across browsers. The examples here should work on all browser. There are additional features which only work on some browsers. To see the current status of Clipboard API support on all browsers, see http://caniuse.com/#search=clipboard%20API
The full specification of the Clipboard API is at https://www.w3.org/TR/clipboard-apis/
Properties and Methods
The following properties and events are supported, plus:
getData(type) | Gets the clipboard data for type. type is usually "text/plain". The complete list of type is here. |
setData(type, value) | Put value on the clipboard with type of type. |
oncopy(event) | Called when the user copies from an input field. |
getData(event) | Called when the user cuts from an input field. |
getData(event) | Called when the user pastes to an input field. |
Example (Basic)
Function Input1_oncopy(event) length = Input1.selectionEnd - Input1.selectionStart selectedText = Mid(Input1.value, Input1.selectionStart+1, length) modifiedText = UCase(selectedText) clipboardData = event.clipboardData; clipboardData.setData("text/plain", modifiedText) 'Stop the default copy from the field. event.preventDefault() MsgBox "Selected text:" & selectedText & vbCRLF & "Changed to:" & modifiedText End Function Function Input2_onpaste(event) clipboardData = event.clipboardData; tobePasted = clipboardData.getData("text/plain") Input2.value = tobePasted & " was pasted" 'Stop the default paste to the field. event.preventDefault() MsgBox "Pasted text:" & tobePasted & vbCRLF & "Change to:" & Input2.value End Function
Example (JavaScript)
Input1.oncopy = function(event) { length = Input1.selectionEnd - Input1.selectionStart; selectedText = Mid(Input1.value, Input1.selectionStart + 1, length); modifiedText = UCase(selectedText); clipboardData = event.clipboardData; clipboardData.setData("text/plain", modifiedText); //Stop the default copy from the field. event.preventDefault(); NSB.MsgBox("Selected text:" + selectedText + '\n' + "Changed to:" + modifiedText); }; Input2.onpaste = function(event) { clipboardData = event.clipboardData; tobePasted = clipboardData.getData("text/plain"); Input2.value = tobePasted + " was pasted"; //Stop the default paste to the field. event.preventDefault(); NSB.MsgBox("Pasted text:" + tobePasted + '\n' + "Change to:" + Input2.value); };