/**
* @license Copyright (c) 2003-2019, CKSource - Frederico Knabben. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
*/
/* global document */
import ClassicTestEditor from '@ckeditor/ckeditor5-core/tests/_utils/classictesteditor';
import Title from '../src/title';
import Enter from '@ckeditor/ckeditor5-enter/src/enter';
import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph';
import BlockQuote from '@ckeditor/ckeditor5-block-quote/src/blockquote';
import Heading from '@ckeditor/ckeditor5-heading/src/heading';
import Clipboard from '@ckeditor/ckeditor5-clipboard/src/clipboard';
import Image from '@ckeditor/ckeditor5-image/src/image';
import ImageUpload from '@ckeditor/ckeditor5-image/src/imageupload';
import Undo from '@ckeditor/ckeditor5-undo/src/undo';
import DataTransfer from '@ckeditor/ckeditor5-clipboard/src/datatransfer';
import { UploadAdapterMock, createNativeFileMock } from '@ckeditor/ckeditor5-upload/tests/_utils/mocks';
import { setData, getData } from '@ckeditor/ckeditor5-engine/src/dev-utils/model';
import { keyCodes } from '@ckeditor/ckeditor5-utils/src/keyboard';
describe( 'Title', () => {
let element, editor, model;
beforeEach( () => {
element = document.createElement( 'div' );
document.body.appendChild( element );
return ClassicTestEditor.create( element, {
plugins: [ Title, Heading, BlockQuote, Clipboard, Image, ImageUpload, Enter, Undo ]
} ).then( _editor => {
editor = _editor;
model = editor.model;
} );
} );
afterEach( () => {
return editor.destroy().then( () => element.remove() );
} );
it( 'should requires certain plugins', () => {
expect( Title.requires ).to.have.members( [ Paragraph, Enter ] );
} );
it( 'should have plugin name property', () => {
expect( Title.pluginName ).to.equal( 'Title' );
} );
it( 'should set proper schema rules', () => {
expect( model.schema.isRegistered( 'title', '$text' ) ).to.equal( true );
expect( model.schema.checkChild( [ 'title' ], '$text' ) ).to.equal( true );
expect( model.schema.checkChild( [ '$root' ], 'title' ) ).to.equal( true );
expect( model.schema.checkChild( [ '$root', 'blockQuote' ], 'title' ) ).to.equal( false );
expect( model.schema.checkChild( [ '$root', 'paragraph' ], 'title' ) ).to.equal( false );
} );
it( 'should convert title to h1', () => {
setData( model, '
FooBar' );
expect( editor.getData() ).to.equal( 'Foo
Bar
' );
} );
describe( 'model post-fixing', () => {
it( 'should set title and content elements', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should create a content element when only title has been set', () => {
setData( model, 'Foo' );
expect( getData( model ) ).to.equal( '[]Foo' );
} );
it( 'should create a title and content elements when are missing', () => {
setData( model, '' );
expect( getData( model ) ).to.equal( '[]' );
} );
it( 'should change heading1 element to title when is set as a first root child', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should change heading2 element to title when is set as a first root child', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should change heading3 element to title when is set as a first root child', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should change paragraph element to title when is set as a first root child', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should change title element to a paragraph when is not a first root child #1', () => {
setData( model, 'FooBar' );
expect( getData( model ) ).to.equal( '[]FooBar' );
} );
it( 'should change title element to a paragraph when is not a first root child #2', () => {
setData( model, 'FooBarBiz' );
expect( getData( model ) ).to.equal( '[]FooBarBiz' );
} );
it( 'should move element after a title element when is not allowed to be a title', () => {
setData( model, 'Foo
Bar' );
expect( getData( model ) ).to.equal( '[]BarFoo
' );
} );
it( 'should create a missing title element before an element that cannot to be a title element', () => {
setData( model, 'Foo
' );
expect( getData( model ) ).to.equal( '[]Foo
' );
} );
it( 'should clear element from disallowed attributes when changing to title element', () => {
model.schema.extend( '$text', { allowAttributes: 'bold' } );
model.schema.addAttributeCheck( ( context, attributeName ) => {
if ( context.endsWith( 'title $text' ) && attributeName === 'bold' ) {
return false;
}
} );
setData( model,
'F<$text bold="true">o$text>oB<$text bold="true">a$text>r'
);
expect( getData( model ) ).to.equal( '[]FooB<$text bold="true">a$text>r' );
} );
} );
describe( 'setTitle()', () => {
it( 'should set new content of a title element', () => {
setData( model, 'FooBar' );
editor.plugins.get( 'Title' ).setTitle( 'Biz' );
expect( getData( model ) ).to.equal( '[]BizBar' );
} );
it( 'should clear content of a title element', () => {
setData( model, 'FooBar' );
editor.plugins.get( 'Title' ).setTitle( '' );
expect( getData( model ) ).to.equal( '[]Bar' );
} );
} );
describe( 'getTitle()', () => {
it( 'should return content of a title element', () => {
setData( model, 'FooBar' );
expect( editor.plugins.get( 'Title' ).getTitle() ).to.equal( 'Foo' );
} );
it( 'should return content of an empty title element', () => {
setData( model, 'Bar' );
expect( editor.plugins.get( 'Title' ).getTitle() ).to.equal( '' );
} );
} );
describe( 'setBody()', () => {
it( 'should set new content to body', () => {
setData( model, 'FooBar' );
editor.plugins.get( 'Title' ).setBody( 'Biz' );
expect( getData( model ) ).to.equal( '[]FooBiz' );
} );
it( 'should set empty content to body', () => {
setData( model, 'FooBar' );
editor.plugins.get( 'Title' ).setBody( '' );
expect( getData( model ) ).to.equal( '[]Foo' );
} );
it( 'should set html content to body', () => {
setData( model, 'FooBar' );
editor.plugins.get( 'Title' ).setBody( 'Bar
Biz
' );
expect( getData( model ) ).to.equal(
'[]FooBar
Biz'
);
} );
} );
describe( 'getBody()', () => {
it( 'should return all data except the title element', () => {
setData( model, 'FooBarBiz' );
expect( editor.plugins.get( 'Title' ).getBody() ).to.equal( 'Bar
Biz
' );
} );
it( 'should return empty paragraph when body is empty', () => {
setData( model, 'Foo' );
expect( editor.plugins.get( 'Title' ).getBody() ).to.equal( '
' );
} );
} );
describe( 'placeholders', () => {
let viewRoot;
beforeEach( () => {
viewRoot = editor.editing.view.document.getRoot();
} );
it( 'should attach placeholder placeholder to title and body', () => {
setData( model, 'FooBar' );
const title = viewRoot.getChild( 0 );
const body = viewRoot.getChild( 1 );
expect( title.getAttribute( 'data-placeholder' ) ).to.equal( 'Title' );
expect( body.getAttribute( 'data-placeholder' ) ).to.equal( 'Body' );
expect( title.hasClass( 'ck-placeholder' ) ).to.equal( false );
expect( body.hasClass( 'ck-placeholder' ) ).to.equal( false );
} );
it( 'should show placeholder in empty title and body', () => {
setData( model, '' );
const title = viewRoot.getChild( 0 );
const body = viewRoot.getChild( 1 );
expect( title.getAttribute( 'data-placeholder' ) ).to.equal( 'Title' );
expect( body.getAttribute( 'data-placeholder' ) ).to.equal( 'Body' );
expect( title.hasClass( 'ck-placeholder' ) ).to.equal( true );
expect( body.hasClass( 'ck-placeholder' ) ).to.equal( true );
} );
it( 'should hide placeholder from body with more than one child elements', () => {
setData( editor.model, 'Foo' );
const body = viewRoot.getChild( 1 );
expect( body.getAttribute( 'data-placeholder' ) ).to.equal( 'Body' );
expect( body.hasClass( 'ck-placeholder' ) ).to.equal( false );
} );
it( 'should hide placeholder from body with element other than paragraph', () => {
setData( editor.model, 'Foo' );
const body = viewRoot.getChild( 1 );
expect( body.hasAttribute( 'data-placeholder' ) ).to.equal( true );
expect( body.hasClass( 'ck-placeholder' ) ).to.equal( false );
} );
it( 'should hide placeholder when title element become not empty', () => {
setData( model, '[]' );
expect( viewRoot.getChild( 0 ).hasClass( 'ck-placeholder' ) ).to.equal( true );
model.change( writer => {
writer.appendText( 'Bar', null, model.document.getRoot().getChild( 0 ) );
} );
expect( viewRoot.getChild( 0 ).hasClass( 'ck-placeholder' ) ).to.equal( false );
} );
it( 'should hide placeholder when body element become not empty', () => {
setData( model, 'Foo' );
expect( viewRoot.getChild( 1 ).hasClass( 'ck-placeholder' ) ).to.equal( true );
model.change( writer => {
writer.appendText( 'Bar', null, model.document.getRoot().getChild( 1 ) );
} );
expect( viewRoot.getChild( 1 ).hasClass( 'ck-placeholder' ) ).to.equal( false );
} );
it( 'should properly map the body placeholder in DOM when undoing', () => {
const viewRoot = editor.editing.view.document.getRoot();
const domConverter = editor.editing.view.domConverter;
let bodyDomElement;
setData( editor.model, '[FooBarBaz]' );
editor.model.deleteContent( editor.model.document.selection );
bodyDomElement = domConverter.mapViewToDom( viewRoot.getChild( 1 ) );
expect( bodyDomElement.dataset.placeholder ).to.equal( 'Body' );
expect( bodyDomElement.classList.contains( 'ck-placeholder' ) ).to.be.true;
editor.execute( 'undo' );
bodyDomElement = domConverter.mapViewToDom( viewRoot.getChild( 1 ) );
expect( bodyDomElement.dataset.placeholder ).to.equal( 'Body' );
expect( bodyDomElement.classList.contains( 'ck-placeholder' ) ).to.be.false;
} );
} );
describe( 'Tab press handling', () => {
it( 'should handle tab key when the selection is at the beginning of the title', () => {
setData( model, '[]foobar' );
const eventData = getEventData( keyCodes.tab );
editor.keystrokes.press( eventData );
sinon.assert.calledOnce( eventData.preventDefault );
sinon.assert.calledOnce( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'foo[]bar' );
} );
it( 'should handle tab key when the selection is at the end of the title', () => {
setData( model, 'foo[]bar' );
const eventData = getEventData( keyCodes.tab );
editor.keystrokes.press( eventData );
sinon.assert.calledOnce( eventData.preventDefault );
sinon.assert.calledOnce( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'foo[]bar' );
} );
it( 'should not handle tab key when the selection is in the title and body', () => {
setData( model, 'fo[ob]ar' );
const eventData = getEventData( keyCodes.tab );
editor.keystrokes.press( eventData );
sinon.assert.notCalled( eventData.preventDefault );
sinon.assert.notCalled( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'fo[ob]ar' );
} );
it( 'should not handle tab key when the selection is in the body', () => {
setData( model, 'foo[]bar' );
const eventData = getEventData( keyCodes.tab );
editor.keystrokes.press( eventData );
sinon.assert.notCalled( eventData.preventDefault );
sinon.assert.notCalled( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'foo[]bar' );
} );
} );
describe( 'Shift + Tab press handling', () => {
it( 'should handle shift + tab keys when the selection is at the beginning of the body', () => {
setData( model, 'foo[]bar' );
const eventData = getEventData( keyCodes.tab, { shiftKey: true } );
editor.keystrokes.press( eventData );
sinon.assert.calledOnce( eventData.preventDefault );
sinon.assert.calledOnce( eventData.stopPropagation );
expect( getData( model ) ).to.equal( '[]foobar' );
} );
it( 'should not handle shift + tab keys when the selection is not at the beginning of the body', () => {
setData( model, 'foob[]ar' );
const eventData = getEventData( keyCodes.tab, { shiftKey: true } );
editor.keystrokes.press( eventData );
sinon.assert.notCalled( eventData.preventDefault );
sinon.assert.notCalled( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'foob[]ar' );
} );
it( 'should not handle shift + tab keys when the selection is not collapsed', () => {
setData( model, 'foo[b]ar' );
const eventData = getEventData( keyCodes.tab, { shiftKey: true } );
editor.keystrokes.press( eventData );
sinon.assert.notCalled( eventData.preventDefault );
sinon.assert.notCalled( eventData.stopPropagation );
expect( getData( model ) ).to.equal( 'foo[b]ar' );
} );
it( 'should not handle shift + tab keys when the selection is in the title', () => {
setData( model, '[]foobar' );
const eventData = getEventData( keyCodes.tab, { shiftKey: true } );
editor.keystrokes.press( eventData );
sinon.assert.notCalled( eventData.preventDefault );
sinon.assert.notCalled( eventData.stopPropagation );
expect( getData( model ) ).to.equal( '[]foobar' );
} );
} );
describe( 'prevent extra paragraphing', () => {
it( 'should remove the extra paragraph when pasting to the editor with body placeholder', () => {
setData( model, '[]' );
const dataTransferMock = {
getData: type => {
if ( type === 'text/html' ) {
return 'Title
Body
';
}
},
types: [],
files: []
};
editor.editing.view.document.fire( 'paste', {
dataTransfer: dataTransferMock,
preventDefault() {}
} );
expect( getData( model ) ).to.equal( 'TitleBody[]' );
} );
it( 'should not remove the extra paragraph when pasting to the editor with directly created body element', () => {
setData( model, '[]' );
const dataTransferMock = {
getData: type => {
if ( type === 'text/html' ) {
return 'Title
Body
';
}
},
types: [],
files: []
};
editor.editing.view.document.fire( 'paste', {
dataTransfer: dataTransferMock,
preventDefault() {}
} );
expect( getData( model ) ).to.equal( 'TitleBody[]' );
} );
it( 'should remove the extra paragraph when pressing enter in the title', () => {
setData( model, 'fo[]o' );
editor.execute( 'enter' );
expect( getData( model ) ).to.equal( 'fo[]o' );
} );
it( 'should not remove the extra paragraph when pressing enter in the title when body is created directly', () => {
setData( model, 'fo[]o' );
editor.execute( 'enter' );
expect( getData( model ) ).to.equal( 'fo[]o' );
} );
} );
describe( 'upload to title - integration', () => {
let file, fileRepository;
beforeEach( () => {
fileRepository = editor.plugins.get( 'FileRepository' );
fileRepository.createUploadAdapter = newLoader => new UploadAdapterMock( newLoader );
file = createNativeFileMock();
} );
it( 'should move image after the title when was dropped before it', () => {
setData( model, 'FooBar' );
const dataTransfer = new DataTransfer( { files: [ file ], types: [ 'Files' ] } );
const targetRange = model.createRange( model.createPositionAt( model.document.getRoot(), 0 ) );
const targetViewRange = editor.editing.mapper.toViewRange( targetRange );
editor.editing.view.document.fire( 'clipboardInput', { dataTransfer, targetRanges: [ targetViewRange ] } );
const { id } = fileRepository.getLoader( file );
expect( getData( model ) ).to.equal(
'Foo' +
`[]` +
'Bar'
);
} );
it( 'should move image after the title when was dropped to it', () => {
setData( model, 'FooBar' );
const dataTransfer = new DataTransfer( { files: [ file ], types: [ 'Files' ] } );
const title = model.document.getRoot().getChild( 0 );
const targetRange = model.createRange( model.createPositionAt( title, 1 ) );
const targetViewRange = editor.editing.mapper.toViewRange( targetRange );
editor.editing.view.document.fire( 'clipboardInput', { dataTransfer, targetRanges: [ targetViewRange ] } );
const { id } = fileRepository.getLoader( file );
expect( getData( model ) ).to.equal(
'Foo' +
`[]` +
'Bar'
);
} );
} );
} );
function getEventData( keyCode, { shiftKey = false } = {} ) {
return {
keyCode,
shiftKey,
preventDefault: sinon.spy(),
stopPropagation: sinon.spy()
};
}