The configuration paste property defines options related to editor paste behavior.

Example Configuration

In this example, a simple configuration object is created that overrides the default paste behavior. The simple configuration object is then passed to replace to create an editor.

var configPaste = {
	paste : {
		style : 'clean',  // Overrides default: 'prompt' for MS Office content
		enableFlashImport: true // Note, true is the default
	}
};
 
var editor = textboxio.replace('#targetId', configPaste);

Properties

PropertyTypeDefaultValues
styleString'prompt'

'clean', 'retain', 'plain' or 'prompt'

enableFlashImport
Booleantruefalse or true

Style Values

ValueDescription
prompt

(Default for importing MS Office content)

A prompt is displayed to the user on paste. The prompt asks the user to either remove or retain inline CSS styling.

clean

Inline CSS styling is stripped from pasted content.

plainOnly the plain text clipboard content is pasted, if any is available
retain

(Default for all other content)

Inline CSS styling is retained in pasted content.

 

Enable Flash Import

This option was introduced in Textbox.io release 1.3.1

On some browsers, a flash plugin is used to extract images when pasting from MS Office documents. On these browsers the use of flash can be disabled.

This option has no impact on browsers that do not require flash; on those browsers images will still be included. To disable local image pasting completely use the allowLocal configuration option.

ValueDescription
true

Allow flash to be used to extract images when pasting from MS Office documents

false

On browsers that require flash, no images will be pasted when copying and pasting from MS Office documents.

If there are images in the document, the user will see a warning that images were blocked.

Other content will still be pasted as normal.

 

 

Inline CSS styling is CSS that is applied directly to HTML elements via the HTML style attribute (W3C).

Protected View

Note: When using the Windows operating system, copying and pasting content from Word 2013 or later in Protected View will result in plain, unformatted text. This is due to how Protected View interacts with the clipboard.