| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405 |
- /**
- * @license Copyright (c) 2003-2020, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
- /* globals Event */
- import testUtils from '@ckeditor/ckeditor5-core/tests/_utils/utils';
- import ButtonView from '../../src/button/buttonview';
- import IconView from '../../src/icon/iconview';
- import TooltipView from '../../src/tooltip/tooltipview';
- import View from '../../src/view';
- import ViewCollection from '../../src/viewcollection';
- import env from '@ckeditor/ckeditor5-utils/src/env';
- describe( 'ButtonView', () => {
- let locale, view;
- testUtils.createSinonSandbox();
- beforeEach( () => {
- locale = { t() {} };
- view = new ButtonView( locale );
- view.render();
- } );
- afterEach( () => {
- view.destroy();
- } );
- describe( 'constructor()', () => {
- it( 'creates view#children collection', () => {
- expect( view.children ).to.be.instanceOf( ViewCollection );
- } );
- it( 'creates #tooltipView', () => {
- expect( view.tooltipView ).to.be.instanceOf( TooltipView );
- } );
- it( 'creates #labelView', () => {
- expect( view.labelView ).to.be.instanceOf( View );
- expect( view.labelView.element.classList.contains( 'ck' ) ).to.be.true;
- expect( view.labelView.element.classList.contains( 'ck-button__label' ) ).to.be.true;
- } );
- it( 'creates #keystrokeView', () => {
- expect( view.keystrokeView ).to.be.instanceOf( View );
- } );
- it( 'creates #iconView', () => {
- expect( view.iconView ).to.be.instanceOf( IconView );
- } );
- } );
- describe( '<button> bindings', () => {
- describe( 'class', () => {
- it( 'is set initially', () => {
- expect( view.element.classList ).to.have.length( 3 );
- expect( view.element.classList.contains( 'ck' ) ).to.true;
- expect( view.element.classList.contains( 'ck-button' ) ).to.true;
- expect( view.element.classList.contains( 'ck-disabled' ) ).to.false;
- expect( view.element.classList.contains( 'ck-off' ) ).to.true;
- } );
- it( 'reacts on view#isEnabled', () => {
- view.isEnabled = true;
- expect( view.element.classList.contains( 'ck-disabled' ) ).to.false;
- view.isEnabled = false;
- expect( view.element.classList.contains( 'ck-disabled' ) ).to.true;
- } );
- it( 'reacts on view#isOn', () => {
- view.isOn = true;
- expect( view.element.classList.contains( 'ck-on' ) ).to.true;
- view.isOn = false;
- expect( view.element.classList.contains( 'ck-on' ) ).to.false;
- } );
- it( 'reacts on view#isVisible', () => {
- view.isVisible = true;
- expect( view.element.classList.contains( 'ck-hidden' ) ).to.be.false;
- view.isVisible = false;
- expect( view.element.classList.contains( 'ck-hidden' ) ).to.be.true;
- } );
- it( 'reacts on view#withText', () => {
- view.withText = true;
- expect( view.element.classList.contains( 'ck-button_with-text' ) ).to.true;
- view.withText = false;
- expect( view.element.classList.contains( 'ck-button_with-text' ) ).to.false;
- } );
- it( 'reacts on view#withKeystroke', () => {
- view.withKeystroke = true;
- expect( view.element.classList.contains( 'ck-button_with-keystroke' ) ).to.true;
- view.withKeystroke = false;
- expect( view.element.classList.contains( 'ck-button_with-keystroke' ) ).to.false;
- } );
- it( 'reacts on view#type', () => {
- // Default value.
- expect( view.element.getAttribute( 'type' ) ).to.equal( 'button' );
- view.type = 'submit';
- expect( view.element.getAttribute( 'type' ) ).to.equal( 'submit' );
- // Default value.
- view.type = null;
- expect( view.element.getAttribute( 'type' ) ).to.equal( 'button' );
- } );
- it( 'reacts on view#class', () => {
- view.set( 'class', 'foo' );
- expect( view.element.classList.contains( 'foo' ) ).to.be.true;
- } );
- } );
- describe( 'labelView', () => {
- it( 'reacts on view#labelStyle', () => {
- expect( view.labelView.element.attributes.getNamedItem( 'style' ) ).to.be.null;
- view.labelStyle = 'color: red';
- expect( view.labelView.element.attributes.getNamedItem( 'style' ).value ).to.equal( 'color: red' );
- } );
- } );
- describe( 'tooltip', () => {
- it( 'is initially set', () => {
- expect( view.children.getIndex( view.tooltipView ) ).to.equal( 0 );
- } );
- it( 'it reacts to #tooltipPosition attribute', () => {
- view.tooltip = 'foo';
- view.icon = '<svg></svg>';
- expect( view.tooltipPosition ).to.equal( 's' );
- expect( view.tooltipView.position ).to.equal( 's' );
- view.tooltipPosition = 'n';
- expect( view.tooltipView.position ).to.equal( 'n' );
- } );
- describe( 'defined as a Boolean', () => {
- it( 'renders tooltip text out of #label and #keystroke', () => {
- view.tooltip = true;
- view.label = 'bar';
- view.keystroke = 'A';
- expect( view.tooltipView.text ).to.equal( 'bar (A)' );
- } );
- it( 'not render tooltip text when #tooltip value is false', () => {
- view.tooltip = false;
- view.label = 'bar';
- view.keystroke = 'A';
- expect( view.tooltipView.text ).to.equal( '' );
- } );
- it( 'reacts to changes in #label and #keystroke', () => {
- view.tooltip = true;
- view.label = 'foo';
- view.keystroke = 'B';
- expect( view.tooltipView.text ).to.equal( 'foo (B)' );
- view.label = 'baz';
- view.keystroke = false;
- expect( view.tooltipView.text ).to.equal( 'baz' );
- } );
- } );
- describe( 'defined as a String', () => {
- it( 'renders as a plain text', () => {
- view.tooltip = 'bar';
- view.label = 'foo';
- view.keystroke = 'A';
- expect( view.tooltipView.text ).to.equal( 'bar' );
- } );
- it( 'reacts to changes of #tooltip', () => {
- view.tooltip = 'bar';
- expect( view.tooltipView.text ).to.equal( 'bar' );
- view.tooltip = 'foo';
- expect( view.tooltipView.text ).to.equal( 'foo' );
- } );
- } );
- describe( 'defined as a Function', () => {
- it( 'generates a tooltip text when passed #label and #keystroke', () => {
- view.tooltip = ( l, k ) => `${ l } - ${ k }`;
- view.label = 'foo';
- view.keystroke = 'A';
- expect( view.tooltipView.text ).to.equal( 'foo - A' );
- } );
- it( 'reacts to changes of #label and #keystroke', () => {
- view.tooltip = ( l, k ) => `${ l } - ${ k }`;
- view.label = 'foo';
- view.keystroke = 'A';
- expect( view.tooltipView.text ).to.equal( 'foo - A' );
- view.label = 'bar';
- view.keystroke = 'B';
- expect( view.tooltipView.text ).to.equal( 'bar - B' );
- } );
- } );
- } );
- describe( 'text', () => {
- it( 'is not initially set ', () => {
- expect( view.element.textContent ).to.equal( '' );
- } );
- it( 'reacts on view#label', () => {
- view.label = 'bar';
- expect( view.element.textContent ).to.equal( 'bar' );
- } );
- } );
- describe( 'tabindex', () => {
- it( 'is initially set ', () => {
- expect( view.element.attributes.tabindex.value ).to.equal( '-1' );
- } );
- it( 'reacts on view#tabindex', () => {
- view.tabindex = 3;
- expect( view.element.attributes.tabindex.value ).to.equal( '3' );
- } );
- } );
- describe( 'aria', () => {
- it( '-labelledby is set', () => {
- expect( view.element.attributes[ 'aria-labelledby' ].value )
- .to.equal( view.element.lastChild.id )
- .to.match( /^ck-editor__aria-label_\w+$/ );
- } );
- it( '-disabled reacts to #isEnabled', () => {
- view.isEnabled = true;
- expect( view.element.attributes[ 'aria-disabled' ] ).to.be.undefined;
- view.isEnabled = false;
- expect( view.element.attributes[ 'aria-disabled' ].value ).to.equal( 'true' );
- } );
- it( '-pressed reacts to #isOn', () => {
- view.isToggleable = true;
- view.isOn = true;
- expect( view.element.attributes[ 'aria-pressed' ].value ).to.equal( 'true' );
- view.isOn = false;
- expect( view.element.attributes[ 'aria-pressed' ].value ).to.equal( 'false' );
- } );
- it( '-pressed is not present for non–toggleable button', () => {
- view.isOn = true;
- expect( view.element.hasAttribute( 'aria-pressed' ) ).to.be.false;
- view.isOn = false;
- expect( view.element.hasAttribute( 'aria-pressed' ) ).to.be.false;
- } );
- } );
- describe( 'mousedown event', () => {
- it( 'should be prevented', () => {
- const ret = view.element.dispatchEvent( new Event( 'mousedown', { cancelable: true } ) );
- expect( ret ).to.false;
- } );
- } );
- describe( 'execute event', () => {
- it( 'triggers view#execute event if button is not disabled', () => {
- const spy = sinon.spy();
- view.on( 'execute', spy );
- view.set( 'isEnabled', true );
- view.element.dispatchEvent( new Event( 'click' ) );
- sinon.assert.callCount( spy, 1 );
- view.isEnabled = false;
- view.element.dispatchEvent( new Event( 'click' ) );
- sinon.assert.callCount( spy, 1 );
- } );
- } );
- } );
- describe( '#iconView', () => {
- it( 'is omited in #children when view#icon is not defined', () => {
- view = new ButtonView( locale );
- view.render();
- expect( view.element.childNodes ).to.have.length( 2 );
- expect( view.iconView.element ).to.be.null;
- } );
- it( 'is added to the #children when view#icon is defined', () => {
- view = new ButtonView( locale );
- view.icon = '<svg></svg>';
- view.render();
- expect( view.element.childNodes ).to.have.length( 3 );
- expect( view.element.childNodes[ 0 ] ).to.equal( view.iconView.element );
- expect( view.iconView ).to.instanceOf( IconView );
- expect( view.iconView.content ).to.equal( '<svg></svg>' );
- expect( view.iconView.element.classList.contains( 'ck-button__icon' ) ).to.be.true;
- view.icon = '<svg>bar</svg>';
- expect( view.iconView.content ).to.equal( '<svg>bar</svg>' );
- } );
- it( 'is destroyed with the view', () => {
- view = new ButtonView( locale );
- view.icon = '<svg></svg>';
- view.render();
- const spy = sinon.spy( view.iconView, 'destroy' );
- view.destroy();
- sinon.assert.calledOnce( spy );
- } );
- } );
- describe( '#keystrokeView', () => {
- it( 'is omited in #children when view#icon is not defined', () => {
- view = new ButtonView( locale );
- view.render();
- expect( view.element.childNodes ).to.have.length( 2 );
- expect( view.keystrokeView.element ).to.be.null;
- } );
- it( 'is added to the #children when view#withKeystroke is true', () => {
- testUtils.sinon.stub( env, 'isMac' ).value( false );
- view = new ButtonView( locale );
- view.keystroke = 'Ctrl+A';
- view.withKeystroke = true;
- view.render();
- expect( view.element.childNodes ).to.have.length( 3 );
- expect( view.element.childNodes[ 2 ] ).to.equal( view.keystrokeView.element );
- expect( view.keystrokeView.element.classList.contains( 'ck' ) ).to.be.true;
- expect( view.keystrokeView.element.classList.contains( 'ck-button__keystroke' ) ).to.be.true;
- expect( view.keystrokeView ).to.instanceOf( View );
- expect( view.keystrokeView.element.textContent ).to.equal( 'Ctrl+A' );
- } );
- it( 'usese fancy kesytroke preview on Mac', () => {
- testUtils.sinon.stub( env, 'isMac' ).value( true );
- view = new ButtonView( locale );
- view.keystroke = 'Ctrl+A';
- view.withKeystroke = true;
- view.render();
- expect( view.keystrokeView.element.textContent ).to.equal( '⌘A' );
- } );
- it( 'is destroyed with the view', () => {
- view = new ButtonView( locale );
- view.keystroke = 'Ctrl+A';
- view.withKeystroke = true;
- view.render();
- const spy = sinon.spy( view.keystrokeView, 'destroy' );
- view.destroy();
- sinon.assert.calledOnce( spy );
- } );
- } );
- describe( 'focus()', () => {
- it( 'focuses the button in DOM', () => {
- const spy = sinon.spy( view.element, 'focus' );
- view.focus();
- sinon.assert.calledOnce( spy );
- } );
- } );
- } );
|