ExportWordConfig (export-word)
@ckeditor/ckeditor5-export-word/src/exportword
The configuration of the export to Word feature. It is used by the Word export features from
the @ckeditor/ckeditor5-export-word
package.
ClassicEditor
.create( editorElement, {
exportWord: ... // Export to Word feature options.
} )
.then( ... )
.catch( ... );
See all editor options.
Filtering
Properties
-
converterOptions : ExportWordConverterOptions | undefined
module:export-word/exportword~ExportWordConfig#converterOptions
The CKEditor Cloud Services HTML to DOCX Converter configuration options.
NOTE: Configuring the plugin is not mandatory.
const exportWordConfig = { converterOptions: { ... } }
Defaults to
`{ format: 'A4', margin_top: '1in', margin_bottom: '1in', margin_right: '1in', margin_left: '1in', header: undefined, footer: undefined, comments: undefined, suggestions: undefined, orientation: 'portrait', auto_pagination: true, base_url: undefined, timezone: 'UTC' }`
-
converterUrl : string | undefined
module:export-word/exportword~ExportWordConfig#converterUrl
A URL to the Docx converter.
const exportWordConfig = { converterUrl: 'https://myconverter.com/v1/' }
NOTE: The plugin uses the default HTML to Word converter delivered by CKEditor Cloud Services. You can provide a URL to an on-premises converter instead.
Defaults to
'https://docx-converter.cke-cs.com/v1/convert'
-
dataCallback : ( Editor ) => string | undefined
module:export-word/exportword~ExportWordConfig#dataCallback
A function to gather the HTML to be converted to Word.
NOTE: This option may be useful when the editor does not have a
getData()
method, or if the HTML to be converted should be different than the edited one.const exportWordConfig = { dataCallback: ( editor ) => { return ` <header id="header">${ editor.data.get( { rootName: 'header' } ) }</header> <div id="content">${ editor.data.get( { rootName: 'content' } ) }</div> `; } }
-
fileName : string | () => string | undefined
module:export-word/exportword~ExportWordConfig#fileName
The name of the generated Word file.
// Static file name. const exportWordConfig = { fileName: 'my-document.docx' } // Dynamic file name. const exportWordConfig = { fileName: () => { const articleTitle = document.querySelector( '#title' ); return `${ articleTitle.value }.docx`; } }
NOTE: The file name must contain the
.docx
extension. Otherwise your operating system or device may have trouble identifying the file type.Defaults to
'document.docx'
-
stylesheets : Array<string> | undefined
module:export-word/exportword~ExportWordConfig#stylesheets
Paths to the
.css
files containing additional styling for the editor's content (the order of provided items matters).const exportWordConfig = { stylesheets: [ './path/to/custom-style.css' ] }
NOTE: If
stylesheets
are not provided, the plugin will sent only the default editor content styles to the converter.Default editor's content styles: The default editor content styles are applied to the generated Word file thanks to the 'EDITOR_STYLES' token, which is provided to the
stylesheets
by default. If you don't want them to be applied, you have to omit the token:const exportWordConfig = { stylesheets: [ './path/to/custom-editor-styles.css' ] }
Custom styling: For more advanced styling, your configuration should look like this:
const exportWordConfig = { stylesheets: [ 'EDITOR_STYLES', './path/to/custom-styles.css' ] }
Defaults to
`[ 'EDITOR_STYLES' ]`
-
token : InitializedToken | undefined
module:export-word/exportword~ExportWordConfig#token
The authentication token.
See:
token
-
A token URL or a token request function. This field is optional and should be used only when a different
tokenUrl
is required for the export to Word feature.Note: The token can be disabled with the
false
value provided.See:
tokenUrl
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.