| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390 |
- /**
- * @license Copyright (c) 2003-2020, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
- import DropdownView from '../../src/dropdown/dropdownview';
- import KeystrokeHandler from '@ckeditor/ckeditor5-utils/src/keystrokehandler';
- import { keyCodes } from '@ckeditor/ckeditor5-utils/src/keyboard';
- import ButtonView from '../../src/button/buttonview';
- import DropdownPanelView from '../../src/dropdown/dropdownpanelview';
- import global from '@ckeditor/ckeditor5-utils/src/dom/global';
- import testUtils from '@ckeditor/ckeditor5-core/tests/_utils/utils';
- describe( 'DropdownView', () => {
- let view, buttonView, panelView, locale;
- testUtils.createSinonSandbox();
- beforeEach( () => {
- locale = {
- uiLanguageDirection: 'ltr',
- t() {}
- };
- buttonView = new ButtonView( locale );
- panelView = new DropdownPanelView( locale );
- view = new DropdownView( locale, buttonView, panelView );
- view.render();
- // The #panelView positioning depends on the utility that uses DOM Rects.
- // To avoid an avalanche of warnings (DOM Rects do not work until
- // the element is in DOM), let's allow the dropdown to render in DOM.
- global.document.body.appendChild( view.element );
- } );
- afterEach( () => {
- view.element.remove();
- } );
- describe( 'constructor()', () => {
- it( 'sets view#locale', () => {
- expect( view.locale ).to.equal( locale );
- } );
- it( 'sets view#buttonView', () => {
- expect( view.buttonView ).to.equal( buttonView );
- } );
- it( 'sets view#panelView', () => {
- expect( view.panelView ).to.equal( panelView );
- } );
- it( 'sets view#isOpen false', () => {
- expect( view.isOpen ).to.be.false;
- } );
- it( 'sets view#isEnabled true', () => {
- expect( view.isEnabled ).to.be.true;
- } );
- it( 'sets view#class', () => {
- expect( view.class ).to.be.undefined;
- } );
- it( 'sets view#id', () => {
- expect( view.id ).to.be.undefined;
- } );
- it( 'sets view#panelPosition "auto"', () => {
- expect( view.panelPosition ).to.equal( 'auto' );
- } );
- it( 'creates #keystrokeHandler instance', () => {
- expect( view.keystrokes ).to.be.instanceOf( KeystrokeHandler );
- } );
- it( 'creates #element from template', () => {
- expect( view.element.classList.contains( 'ck' ) ).to.be.true;
- expect( view.element.classList.contains( 'ck-dropdown' ) ).to.be.true;
- expect( view.element.children ).to.have.length( 2 );
- expect( view.element.children[ 0 ] ).to.equal( buttonView.element );
- expect( view.element.children[ 1 ] ).to.equal( panelView.element );
- } );
- it( 'sets view#buttonView class', () => {
- expect( view.buttonView.element.classList.contains( 'ck-dropdown__button' ) ).to.be.true;
- } );
- describe( 'bindings', () => {
- describe( 'view#isOpen to view.buttonView#select', () => {
- it( 'is activated', () => {
- const values = [];
- view.on( 'change:isOpen', () => {
- values.push( view.isOpen );
- } );
- view.buttonView.fire( 'open' );
- view.buttonView.fire( 'open' );
- view.buttonView.fire( 'open' );
- expect( values ).to.have.members( [ true, false, true ] );
- } );
- } );
- describe( 'view.panelView#isVisible to view#isOpen', () => {
- it( 'is activated', () => {
- const values = [];
- view.listenTo( view.panelView, 'change:isVisible', () => {
- values.push( view.isOpen );
- } );
- view.isOpen = true;
- view.isOpen = false;
- view.isOpen = true;
- expect( values ).to.have.members( [ true, false, true ] );
- } );
- } );
- describe( 'view.panelView#position to view#panelPosition', () => {
- it( 'does not update until the dropdown is open', () => {
- view.isOpen = false;
- view.panelPosition = 'nw';
- expect( panelView.position ).to.equal( 'se' );
- view.isOpen = true;
- expect( panelView.position ).to.equal( 'nw' );
- } );
- describe( 'in "auto" mode', () => {
- it( 'uses _getOptimalPosition() and a dedicated set of positions (LTR)', () => {
- const spy = testUtils.sinon.spy( DropdownView, '_getOptimalPosition' );
- const { southEast, southWest, northEast, northWest } = DropdownView.defaultPanelPositions;
- view.isOpen = true;
- sinon.assert.calledWithExactly( spy, sinon.match( {
- element: panelView.element,
- target: buttonView.element,
- positions: [
- southEast, southWest, northEast, northWest
- ],
- fitInViewport: true
- } ) );
- } );
- it( 'uses _getOptimalPosition() and a dedicated set of positions (RTL)', () => {
- const spy = testUtils.sinon.spy( DropdownView, '_getOptimalPosition' );
- const { southEast, southWest, northEast, northWest } = DropdownView.defaultPanelPositions;
- view.locale.uiLanguageDirection = 'rtl';
- view.isOpen = true;
- sinon.assert.calledWithExactly( spy, sinon.match( {
- element: panelView.element,
- target: buttonView.element,
- positions: [
- southWest, southEast, northWest, northEast
- ],
- fitInViewport: true
- } ) );
- } );
- } );
- } );
- describe( 'DOM element bindings', () => {
- describe( 'class', () => {
- it( 'reacts on view#isEnabled', () => {
- view.isEnabled = true;
- expect( view.element.classList.contains( 'ck-disabled' ) ).to.be.false;
- view.isEnabled = false;
- expect( view.element.classList.contains( 'ck-disabled' ) ).to.be.true;
- } );
- it( 'reacts on view#class', () => {
- view.class = 'custom-css-class';
- expect( view.element.classList.contains( 'custom-css-class' ) ).to.be.true;
- } );
- } );
- describe( 'id', () => {
- it( 'reacts on view#id', () => {
- view.id = 'foo';
- expect( view.element.id ).to.equal( 'foo' );
- } );
- } );
- } );
- } );
- } );
- describe( 'render()', () => {
- it( 'starts listening for #keystrokes coming from #element', () => {
- const view = new DropdownView( locale,
- new ButtonView( locale ),
- new DropdownPanelView( locale ) );
- const spy = sinon.spy( view.keystrokes, 'listenTo' );
- view.render();
- sinon.assert.calledOnce( spy );
- sinon.assert.calledWithExactly( spy, view.element );
- view.element.remove();
- } );
- describe( 'activates keyboard navigation for the dropdown', () => {
- it( 'so "arrowdown" opens the #panelView', () => {
- const keyEvtData = {
- keyCode: keyCodes.arrowdown,
- preventDefault: sinon.spy(),
- stopPropagation: sinon.spy()
- };
- view.buttonView.isEnabled = true;
- view.isOpen = true;
- view.keystrokes.press( keyEvtData );
- sinon.assert.notCalled( keyEvtData.preventDefault );
- sinon.assert.notCalled( keyEvtData.stopPropagation );
- expect( view.isOpen ).to.be.true;
- view.isOpen = false;
- view.keystrokes.press( keyEvtData );
- sinon.assert.calledOnce( keyEvtData.preventDefault );
- sinon.assert.calledOnce( keyEvtData.stopPropagation );
- expect( view.isOpen ).to.be.true;
- } );
- it( 'so "arrowdown" won\'t open the #panelView when #isEnabled is false', () => {
- const keyEvtData = {
- keyCode: keyCodes.arrowdown,
- preventDefault: sinon.spy(),
- stopPropagation: sinon.spy()
- };
- view.buttonView.isEnabled = false;
- view.isOpen = false;
- view.keystrokes.press( keyEvtData );
- sinon.assert.notCalled( keyEvtData.preventDefault );
- sinon.assert.notCalled( keyEvtData.stopPropagation );
- expect( view.isOpen ).to.be.false;
- } );
- it( 'so "arrowright" is blocked', () => {
- const keyEvtData = {
- keyCode: keyCodes.arrowright,
- preventDefault: sinon.spy(),
- stopPropagation: sinon.spy()
- };
- view.false = true;
- view.keystrokes.press( keyEvtData );
- sinon.assert.notCalled( keyEvtData.preventDefault );
- sinon.assert.notCalled( keyEvtData.stopPropagation );
- expect( view.isOpen ).to.be.false;
- view.isOpen = true;
- view.keystrokes.press( keyEvtData );
- sinon.assert.calledOnce( keyEvtData.preventDefault );
- sinon.assert.calledOnce( keyEvtData.stopPropagation );
- expect( view.isOpen ).to.be.true;
- } );
- it( 'so "arrowleft" closes the #panelView', () => {
- const keyEvtData = {
- keyCode: keyCodes.arrowleft,
- preventDefault: sinon.spy(),
- stopPropagation: sinon.spy()
- };
- const spy = sinon.spy( view.buttonView, 'focus' );
- view.isOpen = false;
- view.keystrokes.press( keyEvtData );
- sinon.assert.notCalled( keyEvtData.preventDefault );
- sinon.assert.notCalled( keyEvtData.stopPropagation );
- sinon.assert.notCalled( spy );
- expect( view.isOpen ).to.be.false;
- view.isOpen = true;
- view.keystrokes.press( keyEvtData );
- sinon.assert.calledOnce( keyEvtData.preventDefault );
- sinon.assert.calledOnce( keyEvtData.stopPropagation );
- sinon.assert.calledOnce( spy );
- expect( view.isOpen ).to.be.false;
- } );
- it( 'so "esc" closes the #panelView', () => {
- const keyEvtData = {
- keyCode: keyCodes.esc,
- preventDefault: sinon.spy(),
- stopPropagation: sinon.spy()
- };
- const spy = sinon.spy( view.buttonView, 'focus' );
- view.isOpen = false;
- view.keystrokes.press( keyEvtData );
- sinon.assert.notCalled( keyEvtData.preventDefault );
- sinon.assert.notCalled( keyEvtData.stopPropagation );
- sinon.assert.notCalled( spy );
- expect( view.isOpen ).to.be.false;
- view.isOpen = true;
- view.keystrokes.press( keyEvtData );
- sinon.assert.calledOnce( keyEvtData.preventDefault );
- sinon.assert.calledOnce( keyEvtData.stopPropagation );
- sinon.assert.calledOnce( spy );
- expect( view.isOpen ).to.be.false;
- } );
- } );
- } );
- describe( 'focus()', () => {
- it( 'focuses the #buttonView in DOM', () => {
- const spy = sinon.spy( view.buttonView, 'focus' );
- view.focus();
- sinon.assert.calledOnce( spy );
- } );
- } );
- describe( 'DropdownView.defaultPanelPositions', () => {
- let positions, buttonRect, panelRect;
- beforeEach( () => {
- positions = DropdownView.defaultPanelPositions;
- buttonRect = {
- top: 100,
- bottom: 200,
- left: 100,
- right: 200,
- width: 100,
- height: 100
- };
- panelRect = {
- top: 0,
- bottom: 0,
- left: 0,
- right: 0,
- width: 50,
- height: 50
- };
- } );
- it( 'should have a proper length', () => {
- expect( Object.keys( positions ) ).to.have.length( 4 );
- } );
- it( 'should define the "southEast" position', () => {
- expect( positions.southEast( buttonRect, panelRect ) ).to.deep.equal( {
- top: 200,
- left: 100,
- name: 'se'
- } );
- } );
- it( 'should define the "southWest" position', () => {
- expect( positions.southWest( buttonRect, panelRect ) ).to.deep.equal( {
- top: 200,
- left: 150,
- name: 'sw'
- } );
- } );
- it( 'should define the "northEast" position', () => {
- expect( positions.northEast( buttonRect, panelRect ) ).to.deep.equal( {
- top: 50,
- left: 100,
- name: 'ne'
- } );
- } );
- it( 'should define the "northWest" position', () => {
- expect( positions.northWest( buttonRect, panelRect ) ).to.deep.equal( {
- top: 150,
- left: 150,
- name: 'nw'
- } );
- } );
- } );
- } );
|