/* eslint-disable lit-a11y/click-events-have-key-events */
import { expect, fixture, fixtureSync } from '@open-wc/testing';
import { html } from 'lit/static-html.js';
import { OverlayController } from '../src/OverlayController.js';
import { normalizeTransformStyle } from './utils-tests/local-positioning-helpers.js';
/**
* @typedef {import('../types/OverlayConfig').OverlayConfig} OverlayConfig
* @typedef {import('../types/OverlayConfig').ViewportPlacement} ViewportPlacement
*/
const withLocalTestConfig = () =>
/** @type {OverlayConfig} */ ({
placementMode: 'local',
contentNode: /** @type {HTMLElement} */ (fixtureSync(html`
my content
`)),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html` Invoker
`)
),
});
describe('Local Positioning', () => {
// Please use absolute positions in the tests below to prevent the HTML generated by
// the test runner from interfering.
describe('Positioning', () => {
it('creates a Popper instance on the controller when shown, keeps it when hidden', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
});
await ctrl.show();
expect(ctrl._popper.state.modifiersData).to.exist;
await ctrl.hide();
expect(ctrl._popper.state.modifiersData).to.exist;
});
it('positions correctly', async () => {
// smoke test for integration of popper
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
`)
),
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate(-30px, -18px)',
'translate should be -30px [to center = (80 - 20)/2*-1], -18px [to place above = 10 invoker height + 8 default padding]',
);
});
it('uses top as the default placement', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}
>
`)
),
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(ctrl.content.getAttribute('data-popper-placement')).to.equal('top');
});
it('positions to preferred place if placement is set and space is available', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}
>
`)
),
popperConfig: {
placement: 'left-start',
},
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(ctrl.content.getAttribute('data-popper-placement')).to.equal('left-start');
});
it('positions to different place if placement is set and no space is available', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` invoker
`)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}>
content
`)
),
popperConfig: {
placement: 'left',
},
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(ctrl.content.getAttribute('data-popper-placement')).to.equal('right');
});
it('allows the user to override default Popper modifiers', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}
>
`)
),
popperConfig: {
modifiers: [
{
name: 'keepTogether',
enabled: false,
},
{ name: 'offset', enabled: true, options: { offset: [0, 16] } },
],
},
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(ctrl._popper.state.modifiersData.offset.auto).to.eql({ x: 0, y: 16 });
});
it('positions the Popper element correctly on show', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}
>
`)
),
popperConfig: {
placement: 'top',
},
});
await fixture(html`
${ctrl.invokerNode}${ctrl.content}
`);
await ctrl.show();
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate(10px, -28px)',
'Popper positioning values',
);
await ctrl.hide();
await ctrl.show();
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate(10px, -28px)',
'Popper positioning values should be identical after hiding and showing',
);
});
// TODO: Reenable test and make sure it passes
it.skip('updates placement properly even during hidden state', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}
>
`)
),
popperConfig: {
placement: 'top',
modifiers: [
{
name: 'offset',
enabled: true,
options: {
offset: [0, 10],
},
},
],
},
});
await fixture(html`
${ctrl.invokerNode} ${ctrl.content}
`);
await ctrl.show();
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate3d(10px, -30px, 0px)',
'Popper positioning values',
);
await ctrl.hide();
await ctrl.updateConfig({
popperConfig: {
modifiers: [
{
name: 'offset',
enabled: true,
options: {
offset: [0, 20],
},
},
],
},
});
await ctrl.show();
expect(ctrl._popper.options.modifiers.offset.offset).to.equal('0, 20px');
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate3d(10px, -40px, 0px)',
'Popper positioning Y value should be 10 less than previous, due to the added extra 10px offset',
);
});
// TODO: Not yet implemented
it.skip('updates positioning correctly during shown state when config gets updated', async () => {
const ctrl = new OverlayController({
...withLocalTestConfig(),
contentNode: /** @type {HTMLElement} */ (
fixtureSync(html` `)
),
invokerNode: /** @type {HTMLElement} */ (
fixtureSync(html`
ctrl.show()}>
Invoker
`)
),
popperConfig: {
placement: 'top',
modifiers: [
{
name: 'offset',
enabled: true,
options: {
offset: [0, 10],
},
},
],
},
});
await fixture(html`
${ctrl.invokerNode} ${ctrl.content}
`);
await ctrl.show();
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate3d(10px, -30px, 0px)',
'Popper positioning values',
);
await ctrl.updateConfig({
popperConfig: {
modifiers: [{ name: 'offset', enabled: true, options: { offset: [0, 20] } }],
},
});
expect(normalizeTransformStyle(ctrl.content.style.transform)).to.equal(
'translate3d(10px, -40px, 0px)',
'Popper positioning Y value should be 10 less than previous, due to the added extra 10px offset',
);
});
it('can set the contentNode minWidth as the invokerNode width', async () => {
const invokerNode = /** @type {HTMLElement} */ (
await fixture(html` invoker
`)
);
const ctrl = new OverlayController({
...withLocalTestConfig(),
inheritsReferenceWidth: 'min',
invokerNode,
});
await ctrl.show();
expect(ctrl.content.style.minWidth).to.equal('60px');
});
it('can set the contentNode maxWidth as the invokerNode width', async () => {
const invokerNode = /** @type {HTMLElement} */ (
await fixture(html` invoker
`)
);
const ctrl = new OverlayController({
...withLocalTestConfig(),
inheritsReferenceWidth: 'max',
invokerNode,
});
await ctrl.show();
expect(ctrl.content.style.maxWidth).to.equal('60px');
});
it('can set the contentNode width as the invokerNode width', async () => {
const invokerNode = /** @type {HTMLElement} */ (
await fixture(html` invoker
`)
);
const ctrl = new OverlayController({
...withLocalTestConfig(),
inheritsReferenceWidth: 'full',
invokerNode,
});
await ctrl.show();
expect(ctrl.content.style.width).to.equal('60px');
});
});
});