import { browserDetection } from '@lion/core'; import { aTimeout, expect, fixture, html, oneEvent } from '@open-wc/testing'; import sinon from 'sinon'; import '../lion-button.js'; /** * @typedef {import('@lion/button/src/LionButton').LionButton} LionButton */ /** * @param {HTMLElement} el */ function getClickArea(el) { if (el.shadowRoot) { return el.shadowRoot.querySelector('.click-area'); } return undefined; } describe('lion-button', () => { it('behaves like native `button` in terms of a11y', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.getAttribute('role')).to.equal('button'); expect(el.getAttribute('tabindex')).to.equal('0'); }); it('has .type="submit" and type="submit" by default', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.type).to.equal('submit'); expect(el.getAttribute('type')).to.be.equal('submit'); expect(el._nativeButtonNode.type).to.equal('submit'); expect(el._nativeButtonNode.getAttribute('type')).to.be.equal('submit'); }); it('sync type down to the native button', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); expect(el.type).to.equal('button'); expect(el.getAttribute('type')).to.be.equal('button'); expect(el._nativeButtonNode.type).to.equal('button'); expect(el._nativeButtonNode.getAttribute('type')).to.be.equal('button'); }); it('hides the native button in the UI', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el._nativeButtonNode.getAttribute('tabindex')).to.equal('-1'); expect(window.getComputedStyle(el._nativeButtonNode).clip).to.equal('rect(0px, 0px, 0px, 0px)'); }); it('is hidden when attribute hidden is true', async () => { const el = /** @type {LionButton} */ (await fixture(``)); expect(el).not.to.be.displayed; }); it('can be disabled imperatively', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.getAttribute('tabindex')).to.equal('-1'); expect(el.getAttribute('aria-disabled')).to.equal('true'); el.disabled = false; await el.updateComplete; expect(el.getAttribute('tabindex')).to.equal('0'); expect(el.getAttribute('aria-disabled')).to.equal('false'); expect(el.hasAttribute('disabled')).to.equal(false); el.disabled = true; await el.updateComplete; expect(el.getAttribute('tabindex')).to.equal('-1'); expect(el.getAttribute('aria-disabled')).to.equal('true'); expect(el.hasAttribute('disabled')).to.equal(true); }); describe('active', () => { it('updates "active" attribute on host when mousedown/mouseup on button', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new Event('mousedown')); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; el.dispatchEvent(new Event('mouseup')); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); it('updates "active" attribute on host when mousedown on button and mouseup anywhere else', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new Event('mousedown')); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; document.dispatchEvent(new Event('mouseup')); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); it('updates "active" attribute on host when space keydown/keyup on button', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new KeyboardEvent('keydown', { keyCode: 32 })); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; el.dispatchEvent(new KeyboardEvent('keyup', { keyCode: 32 })); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); it('updates "active" attribute on host when space keydown on button and space keyup anywhere else', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new KeyboardEvent('keydown', { keyCode: 32 })); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; el.dispatchEvent(new KeyboardEvent('keyup', { keyCode: 32 })); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); it('updates "active" attribute on host when enter keydown/keyup on button', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new KeyboardEvent('keydown', { keyCode: 13 })); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; el.dispatchEvent(new KeyboardEvent('keyup', { keyCode: 13 })); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); it('updates "active" attribute on host when enter keydown on button and space keyup anywhere else', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); el.dispatchEvent(new KeyboardEvent('keydown', { keyCode: 13 })); expect(el.active).to.be.true; await el.updateComplete; expect(el.hasAttribute('active')).to.be.true; document.body.dispatchEvent(new KeyboardEvent('keyup', { keyCode: 13 })); expect(el.active).to.be.false; await el.updateComplete; expect(el.hasAttribute('active')).to.be.false; }); }); describe('a11y', () => { it('has a role="button" by default', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.getAttribute('role')).to.equal('button'); el.role = 'foo'; await el.updateComplete; expect(el.getAttribute('role')).to.equal('foo'); }); it('does not override user provided role', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); expect(el.getAttribute('role')).to.equal('foo'); }); it('has a tabindex="0" by default', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.getAttribute('tabindex')).to.equal('0'); }); it('has a tabindex="-1" when disabled', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); expect(el.getAttribute('tabindex')).to.equal('-1'); el.disabled = false; await el.updateComplete; expect(el.getAttribute('tabindex')).to.equal('0'); el.disabled = true; await el.updateComplete; expect(el.getAttribute('tabindex')).to.equal('-1'); }); it('does not override user provided tabindex', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); expect(el.getAttribute('tabindex')).to.equal('5'); }); it('disabled does not override user provided tabindex', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); expect(el.getAttribute('tabindex')).to.equal('-1'); el.disabled = false; await el.updateComplete; expect(el.getAttribute('tabindex')).to.equal('5'); }); it('has an aria-labelledby and wrapper element in IE11', async () => { const browserDetectionStub = sinon.stub(browserDetection, 'isIE11').value(true); const el = /** @type {LionButton} */ (await fixture(`foo`)); expect(el.hasAttribute('aria-labelledby')).to.be.true; const wrapperId = el.getAttribute('aria-labelledby'); expect(el.shadowRoot.querySelector(`#${wrapperId}`)).to.exist; expect(el.shadowRoot.querySelector(`#${wrapperId}`)).dom.to.equal( `
`, ); browserDetectionStub.restore(); }); it('has a native button node with aria-hidden set to true', async () => { const el = /** @type {LionButton} */ (await fixture('')); expect(el._nativeButtonNode.getAttribute('aria-hidden')).to.equal('true'); }); it('is accessible', async () => { const el = /** @type {LionButton} */ (await fixture(`foo`)); await expect(el).to.be.accessible(); }); it('is accessible when disabled', async () => { const el = /** @type {LionButton} */ (await fixture( `foo`, )); await expect(el).to.be.accessible({ ignoredRules: ['color-contrast'] }); }); }); describe('form integration', () => { describe('with submit event', () => { it('behaves like native `button` when clicked', async () => { const formSubmitSpy = /** @type {EventListener} */ (sinon.spy(e => e.preventDefault())); const form = await fixture(html`
foo
`); const button = form.querySelector('lion-button'); getClickArea(button).click(); expect(formSubmitSpy.callCount).to.equal(1); }); it('behaves like native `button` when interacted with keyboard space', async () => { const formSubmitSpy = /** @type {EventListener} */ (sinon.spy(e => e.preventDefault())); const form = await fixture(html`
foo
`); form .querySelector('lion-button') .dispatchEvent(new KeyboardEvent('keyup', { keyCode: 32 })); await aTimeout(); await aTimeout(); expect(formSubmitSpy.callCount).to.equal(1); }); it('behaves like native `button` when interacted with keyboard enter', async () => { const formSubmitSpy = /** @type {EventListener} */ (sinon.spy(e => e.preventDefault())); const form = await fixture(html`
foo
`); form .querySelector('lion-button') .dispatchEvent(new KeyboardEvent('keyup', { keyCode: 13 })); await aTimeout(); await aTimeout(); expect(formSubmitSpy.callCount).to.equal(1); }); it('supports resetting form inputs in a native form', async () => { const form = await fixture(html`
reset
`); const btn = form.querySelector('lion-button'); const firstName = form.querySelector('input[name=firstName]'); const lastName = form.querySelector('input[name=lastName]'); firstName.value = 'Foo'; lastName.value = 'Bar'; expect(firstName.value).to.equal('Foo'); expect(lastName.value).to.equal('Bar'); btn.click(); expect(firstName.value).to.be.empty; expect(lastName.value).to.be.empty; }); // input "enter" keypress mock doesn't seem to work right now, but should be tested in the future (maybe with Selenium) it.skip('works with implicit form submission on-enter inside an input', async () => { const formSubmitSpy = /** @type {EventListener} */ (sinon.spy(e => e.preventDefault())); const form = await fixture(html`
foo
`); form .querySelector('input[name="foo2"]') .dispatchEvent(new KeyboardEvent('keyup', { key: 13 })); await aTimeout(); await aTimeout(); expect(formSubmitSpy.callCount).to.equal(1); }); }); describe('with click event', () => { it('behaves like native `button` when clicked', async () => { const formButtonClickedSpy = /** @type {EventListener} */ (sinon.spy()); const form = await fixture(html`
ev.preventDefault()}> foo
`); const button = form.querySelector('lion-button'); getClickArea(button).click(); expect(formButtonClickedSpy.callCount).to.equal(1); }); it('behaves like native `button` when interacted with keyboard space', async () => { const formButtonClickedSpy = /** @type {EventListener} */ (sinon.spy()); const form = await fixture(html`
ev.preventDefault()}> foo
`); form .querySelector('lion-button') .dispatchEvent(new KeyboardEvent('keyup', { keyCode: 32 })); await aTimeout(); await aTimeout(); expect(formButtonClickedSpy.callCount).to.equal(1); }); it('behaves like native `button` when interacted with keyboard enter', async () => { const formButtonClickedSpy = /** @type {EventListener} */ (sinon.spy()); const form = await fixture(html`
ev.preventDefault()}> foo
`); form .querySelector('lion-button') .dispatchEvent(new KeyboardEvent('keyup', { keyCode: 13 })); await aTimeout(); await aTimeout(); expect(formButtonClickedSpy.callCount).to.equal(1); }); // input "enter" keypress mock doesn't seem to work right now, but should be tested in the future (maybe with Selenium) it.skip('works with implicit form submission on-enter inside an input', async () => { const formButtonClickedSpy = /** @type {EventListener} */ (sinon.spy()); const form = await fixture(html`
ev.preventDefault()}> foo
`); form .querySelector('input[name="foo2"]') .dispatchEvent(new KeyboardEvent('keyup', { key: 13 })); await aTimeout(); await aTimeout(); expect(formButtonClickedSpy.callCount).to.equal(1); }); }); }); describe('click event', () => { it('is fired once', async () => { const clickSpy = /** @type {EventListener} */ (sinon.spy()); const el = /** @type {LionButton} */ (await fixture( html`foo`, )); getClickArea(el).click(); // trying to wait for other possible redispatched events await aTimeout(); await aTimeout(); expect(clickSpy.callCount).to.equal(1); }); describe('native button behavior', async () => { async function prepareClickEvent(el) { setTimeout(() => { if (getClickArea(el)) { getClickArea(el).click(); } else { el.click(); } }); return oneEvent(el, 'click'); } let nativeButtonEvent; let lionButtonEvent; before(async () => { const nativeButtonEl = /** @type {LionButton} */ (await fixture('')); const lionButtonEl = /** @type {LionButton} */ (await fixture( 'foo', )); nativeButtonEvent = await prepareClickEvent(nativeButtonEl); lionButtonEvent = await prepareClickEvent(lionButtonEl); }); const sameProperties = [ 'constructor', 'composed', 'bubbles', 'cancelable', 'clientX', 'clientY', ]; sameProperties.forEach(property => { it(`has same value of the property "${property}" as in native button event`, () => { expect(lionButtonEvent[property]).to.equal(nativeButtonEvent[property]); }); }); it('has host in the target property', async () => { const el = /** @type {LionButton} */ (await fixture('foo')); const event = await prepareClickEvent(el); expect(event.target).to.equal(el); }); }); }); });