element's font-size style.
// Note: You should use a low-priority observer in order to ensure that
// it is executed after the element-to-element converter.
editor.data.upcastDispatcher.on( 'element:p', ( evt, data, conversionApi ) => {
const { consumable, schema, writer } = conversionApi;
if ( !consumable.consume( data.viewItem, { style: 'font-size' } ) ) {
return;
}
const fontSize = data.viewItem.getStyle( 'font-size' );
// Do not go for the model element after data.modelCursor because it might happen
// that a single view element was converted to multiple model elements. Get all of them.
for ( const item of data.modelRange.getItems( { shallow: true } ) ) {
if ( schema.checkAttribute( item, 'fontSize' ) ) {
writer.setAttribute( 'fontSize', fontSize, item );
}
}
}, { priority: 'low' } );
// Convert all elements which have no custom converter into a paragraph (autoparagraphing).
editor.data.upcastDispatcher.on( 'element', ( evt, data, conversionApi ) => {
// Check if an element can be converted.
if ( !conversionApi.consumable.test( data.viewItem, { name: data.viewItem.name } ) ) {
// When an element is already consumed by higher priority converters, do nothing.
return;
}
const paragraph = conversionApi.writer.createElement( 'paragraph' );
// Try to safely insert a paragraph at the model cursor - it will find an allowed parent for the current element.
if ( !conversionApi.safeInsert( paragraph, data.modelCursor ) ) {
// When an element was not inserted, it means that you cannot insert a paragraph at this position.
return;
}
// Consume the inserted element.
conversionApi.consumable.consume( data.viewItem, { name: data.viewItem.name } ) );
// Convert the children to a paragraph.
const { modelRange } = conversionApi.convertChildren( data.viewItem, paragraph ) );
// Update `modelRange` and `modelCursor` in the `data` as a conversion result.
conversionApi.updateConversionResult( paragraph, data );
}, { priority: 'low' } );
```
[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-engine/src/conversion/upcastdispatcher.ts#L126)
## Properties
### `conversionApi: UpcastConversionApi`
An interface passed by the dispatcher to the event callbacks.
[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-engine/src/conversion/upcastdispatcher.ts#L130)
### `_cursorParents: Map