import type { ComponentInterface, EventEmitter } from '@stencil/core'; import { Component, Element, Event, Listen, Method, Host, h } from '@stencil/core'; import { getElementRoot } from '@utils/helpers'; import type { PickerInternalChangeEventDetail } from './picker-internal-interfaces'; /** * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use. * @internal */ @Component({ tag: 'ion-picker-internal', styleUrls: { ios: 'picker-internal.ios.scss', md: 'picker-internal.md.scss', }, shadow: true, }) export class PickerInternal implements ComponentInterface { private inputEl?: HTMLInputElement; private useInputMode = false; private inputModeColumn?: HTMLIonPickerColumnInternalElement; private highlightEl?: HTMLElement; private actionOnClick?: () => void; private destroyKeypressListener?: () => void; private singleColumnSearchTimeout?: ReturnType; @Element() el!: HTMLIonPickerInternalElement; @Event() ionInputModeChange!: EventEmitter; /** * When the picker is interacted with * we need to prevent touchstart so other * gestures do not fire. For example, * scrolling on the wheel picker * in ion-datetime should not cause * a card modal to swipe to close. */ @Listen('touchstart') preventTouchStartPropagation(ev: TouchEvent) { ev.stopPropagation(); } componentWillLoad() { getElementRoot(this.el).addEventListener('focusin', this.onFocusIn); getElementRoot(this.el).addEventListener('focusout', this.onFocusOut); } private isInHighlightBounds = (ev: PointerEvent) => { const { highlightEl } = this; if (!highlightEl) { return false; } const bbox = highlightEl.getBoundingClientRect(); /** * Check to see if the user clicked * outside the bounds of the highlight. */ const outsideX = ev.clientX < bbox.left || ev.clientX > bbox.right; const outsideY = ev.clientY < bbox.top || ev.clientY > bbox.bottom; if (outsideX || outsideY) { return false; } return true; }; /** * If we are no longer focused * on a picker column, then we should * exit input mode. An exception is made * for the input in the picker since having * that focused means we are still in input mode. */ private onFocusOut = (ev: any) => { // TODO(FW-2832): type const { relatedTarget } = ev; if (!relatedTarget || (relatedTarget.tagName !== 'ION-PICKER-COLUMN-INTERNAL' && relatedTarget !== this.inputEl)) { this.exitInputMode(); } }; /** * When picker columns receive focus * the parent picker needs to determine * whether to enter/exit input mode. */ private onFocusIn = (ev: any) => { // TODO(FW-2832): type const { target } = ev; /** * Due to browser differences in how/when focus * is dispatched on certain elements, we need to * make sure that this function only ever runs when * focusing a picker column. */ if (target.tagName !== 'ION-PICKER-COLUMN-INTERNAL') { return; } /** * If we have actionOnClick * then this means the user focused * a picker column via mouse or * touch (i.e. a PointerEvent). As a result, * we should not enter/exit input mode * until the click event has fired, which happens * after the `focusin` event. * * Otherwise, the user likely focused * the column using their keyboard and * we should enter/exit input mode automatically. */ if (!this.actionOnClick) { const columnEl = target as HTMLIonPickerColumnInternalElement; const allowInput = columnEl.numericInput; if (allowInput) { this.enterInputMode(columnEl, false); } else { this.exitInputMode(); } } }; /** * On click we need to run an actionOnClick * function that has been set in onPointerDown * so that we enter/exit input mode correctly. */ private onClick = () => { const { actionOnClick } = this; if (actionOnClick) { actionOnClick(); this.actionOnClick = undefined; } }; /** * Clicking a column also focuses the column on * certain browsers, so we use onPointerDown * to tell the onFocusIn function that users * are trying to click the column rather than * focus the column using the keyboard. When the * user completes the click, the onClick function * runs and runs the actionOnClick callback. */ private onPointerDown = (ev: PointerEvent) => { const { useInputMode, inputModeColumn, el } = this; if (this.isInHighlightBounds(ev)) { /** * If we were already in * input mode, then we should determine * if we tapped a particular column and * should switch to input mode for * that specific column. */ if (useInputMode) { /** * If we tapped a picker column * then we should either switch to input * mode for that column or all columns. * Otherwise we should exit input mode * since we just tapped the highlight and * not a column. */ if ((ev.target as HTMLElement).tagName === 'ION-PICKER-COLUMN-INTERNAL') { /** * If user taps 2 different columns * then we should just switch to input mode * for the new column rather than switching to * input mode for all columns. */ if (inputModeColumn && inputModeColumn === ev.target) { this.actionOnClick = () => { this.enterInputMode(); }; } else { this.actionOnClick = () => { this.enterInputMode(ev.target as HTMLIonPickerColumnInternalElement); }; } } else { this.actionOnClick = () => { this.exitInputMode(); }; } /** * If we were not already in * input mode, then we should * enter input mode for all columns. */ } else { /** * If there is only 1 numeric input column * then we should skip multi column input. */ const columns = el.querySelectorAll('ion-picker-column-internal.picker-column-numeric-input'); const columnEl = columns.length === 1 ? (ev.target as HTMLIonPickerColumnInternalElement) : undefined; this.actionOnClick = () => { this.enterInputMode(columnEl); }; } return; } this.actionOnClick = () => { this.exitInputMode(); }; }; /** * Enters input mode to allow * for text entry of numeric values. * If on mobile, we focus a hidden input * field so that the on screen keyboard * is brought up. When tabbing using a * keyboard, picker columns receive an outline * to indicate they are focused. As a result, * we should not focus the hidden input as it * would cause the outline to go away, preventing * users from having any visual indication of which * column is focused. */ private enterInputMode = (columnEl?: HTMLIonPickerColumnInternalElement, focusInput = true) => { const { inputEl, el } = this; if (!inputEl) { return; } /** * Only active input mode if there is at * least one column that accepts numeric input. */ const hasInputColumn = el.querySelector('ion-picker-column-internal.picker-column-numeric-input'); if (!hasInputColumn) { return; } /** * If columnEl is undefined then * it is assumed that all numeric pickers * are eligible for text entry. * (i.e. hour and minute columns) */ this.useInputMode = true; this.inputModeColumn = columnEl; /** * Users with a keyboard and mouse can * activate input mode where the input is * focused as well as when it is not focused, * so we need to make sure we clean up any * old listeners. */ if (focusInput) { if (this.destroyKeypressListener) { this.destroyKeypressListener(); this.destroyKeypressListener = undefined; } inputEl.focus(); } else { el.addEventListener('keypress', this.onKeyPress); this.destroyKeypressListener = () => { el.removeEventListener('keypress', this.onKeyPress); }; } this.emitInputModeChange(); }; /** * @internal * Exits text entry mode for the picker * This method blurs the hidden input * and cause the keyboard to dismiss. */ @Method() async exitInputMode() { const { inputEl, useInputMode } = this; if (!useInputMode || !inputEl) { return; } this.useInputMode = false; this.inputModeColumn = undefined; inputEl.blur(); inputEl.value = ''; if (this.destroyKeypressListener) { this.destroyKeypressListener(); this.destroyKeypressListener = undefined; } this.emitInputModeChange(); } private onKeyPress = (ev: KeyboardEvent) => { const { inputEl } = this; if (!inputEl) { return; } const parsedValue = parseInt(ev.key, 10); /** * Only numbers should be allowed */ if (!Number.isNaN(parsedValue)) { inputEl.value += ev.key; this.onInputChange(); } }; private selectSingleColumn = () => { const { inputEl, inputModeColumn, singleColumnSearchTimeout } = this; if (!inputEl || !inputModeColumn) { return; } const values = inputModeColumn.items.filter((item) => item.disabled !== true); /** * If users pause for a bit, the search * value should be reset similar to how a * (this.inputEl = el)} onInput={() => this.onInputChange()} onBlur={() => this.exitInputMode()} />
(this.highlightEl = el)}>
); } }