@ionic/core
Version:
Base components for Ionic
145 lines (142 loc) • 4.84 kB
JavaScript
/*!
* (C) Ionic http://ionicframework.com - MIT License
*/
import { K as Keyboard } from './keyboard.js';
const KEYBOARD_DID_OPEN = 'ionKeyboardDidShow';
const KEYBOARD_DID_CLOSE = 'ionKeyboardDidHide';
const KEYBOARD_THRESHOLD = 150;
// TODO(FW-2832): types
let previousVisualViewport = {};
let currentVisualViewport = {};
let keyboardOpen = false;
/**
* This is only used for tests
*/
const resetKeyboardAssist = () => {
previousVisualViewport = {};
currentVisualViewport = {};
keyboardOpen = false;
};
const startKeyboardAssist = (win) => {
const nativeEngine = Keyboard.getEngine();
/**
* If the native keyboard plugin is available
* then we are running in a native environment. As a result
* we should only listen on the native events instead of
* using the Visual Viewport as the Ionic webview manipulates
* how it resizes such that the Visual Viewport API is not
* reliable here.
*/
if (nativeEngine) {
startNativeListeners(win);
}
else {
if (!win.visualViewport) {
return;
}
currentVisualViewport = copyVisualViewport(win.visualViewport);
win.visualViewport.onresize = () => {
trackViewportChanges(win);
if (keyboardDidOpen() || keyboardDidResize(win)) {
setKeyboardOpen(win);
}
else if (keyboardDidClose(win)) {
setKeyboardClose(win);
}
};
}
};
/**
* Listen for events fired by native keyboard plugin
* in Capacitor/Cordova so devs only need to listen
* in one place.
*/
const startNativeListeners = (win) => {
win.addEventListener('keyboardDidShow', (ev) => setKeyboardOpen(win, ev));
win.addEventListener('keyboardDidHide', () => setKeyboardClose(win));
};
const setKeyboardOpen = (win, ev) => {
fireKeyboardOpenEvent(win, ev);
keyboardOpen = true;
};
const setKeyboardClose = (win) => {
fireKeyboardCloseEvent(win);
keyboardOpen = false;
};
/**
* Returns `true` if the `keyboardOpen` flag is not
* set, the previous visual viewport width equal the current
* visual viewport width, and if the scaled difference
* of the previous visual viewport height minus the current
* visual viewport height is greater than KEYBOARD_THRESHOLD
*
* We need to be able to accommodate users who have zooming
* enabled in their browser (or have zoomed in manually) which
* is why we take into account the current visual viewport's
* scale value.
*/
const keyboardDidOpen = () => {
const scaledHeightDifference = (previousVisualViewport.height - currentVisualViewport.height) * currentVisualViewport.scale;
return (!keyboardOpen &&
previousVisualViewport.width === currentVisualViewport.width &&
scaledHeightDifference > KEYBOARD_THRESHOLD);
};
/**
* Returns `true` if the keyboard is open,
* but the keyboard did not close
*/
const keyboardDidResize = (win) => {
return keyboardOpen && !keyboardDidClose(win);
};
/**
* Determine if the keyboard was closed
* Returns `true` if the `keyboardOpen` flag is set and
* the current visual viewport height equals the
* layout viewport height.
*/
const keyboardDidClose = (win) => {
return keyboardOpen && currentVisualViewport.height === win.innerHeight;
};
/**
* Dispatch a keyboard open event
*/
const fireKeyboardOpenEvent = (win, nativeEv) => {
const keyboardHeight = nativeEv ? nativeEv.keyboardHeight : win.innerHeight - currentVisualViewport.height;
const ev = new CustomEvent(KEYBOARD_DID_OPEN, {
detail: { keyboardHeight },
});
win.dispatchEvent(ev);
};
/**
* Dispatch a keyboard close event
*/
const fireKeyboardCloseEvent = (win) => {
const ev = new CustomEvent(KEYBOARD_DID_CLOSE);
win.dispatchEvent(ev);
};
/**
* Given a window object, create a copy of
* the current visual and layout viewport states
* while also preserving the previous visual and
* layout viewport states
*/
const trackViewportChanges = (win) => {
previousVisualViewport = Object.assign({}, currentVisualViewport);
currentVisualViewport = copyVisualViewport(win.visualViewport);
};
/**
* Creates a deep copy of the visual viewport
* at a given state
*/
const copyVisualViewport = (visualViewport) => {
return {
width: Math.round(visualViewport.width),
height: Math.round(visualViewport.height),
offsetTop: visualViewport.offsetTop,
offsetLeft: visualViewport.offsetLeft,
pageTop: visualViewport.pageTop,
pageLeft: visualViewport.pageLeft,
scale: visualViewport.scale,
};
};
export { KEYBOARD_DID_CLOSE, KEYBOARD_DID_OPEN, copyVisualViewport, keyboardDidClose, keyboardDidOpen, keyboardDidResize, resetKeyboardAssist, setKeyboardClose, setKeyboardOpen, startKeyboardAssist, trackViewportChanges };