import { Build, Component, ComponentInterface, Element, Event, EventEmitter, Host, Prop, State, Watch, h } from '@stencil/core'; import { getIonMode } from '../../global/ionic-global'; const SPLIT_PANE_MAIN = 'split-pane-main'; const SPLIT_PANE_SIDE = 'split-pane-side'; const QUERY: { [key: string]: string } = { 'xs': '(min-width: 0px)', 'sm': '(min-width: 576px)', 'md': '(min-width: 768px)', 'lg': '(min-width: 992px)', 'xl': '(min-width: 1200px)', 'never': '' }; @Component({ tag: 'ion-split-pane', styleUrls: { ios: 'split-pane.ios.scss', md: 'split-pane.md.scss' } }) export class SplitPane implements ComponentInterface { private rmL: any; @Element() el!: HTMLElement; @State() visible = false; /** * The content `id` of the split-pane's main content. */ @Prop() contentId?: string; /** * If `true`, the split pane will be hidden. */ @Prop() disabled = false; /** * When the split-pane should be shown. * Can be a CSS media query expression, or a shortcut expression. * Can also be a boolean expression. */ @Prop() when: string | boolean = QUERY['lg']; /** * Expression to be called when the split-pane visibility has changed */ @Event() ionSplitPaneVisible!: EventEmitter<{visible: boolean}>; @Watch('visible') visibleChanged(visible: boolean) { const detail = { visible, isPane: this.isPane.bind(this) }; this.ionSplitPaneVisible.emit(detail); } connectedCallback() { this.styleChildren(); this.updateState(); } disconnectedCallback() { if (this.rmL) { this.rmL(); this.rmL = undefined; } } componentWillLoad() { if (this.contentId === undefined) { console.warn(`[DEPRECATED][ion-split-pane] Using the [main] attribute is deprecated, please use the "contentId" property instead: BEFORE: ...
...
AFTER: ...
...
`); } } @Watch('disabled') @Watch('when') protected updateState() { if (!Build.isBrowser) { return; } if (this.rmL) { this.rmL(); this.rmL = undefined; } // Check if the split-pane is disabled if (this.disabled) { this.visible = false; return; } // When query is a boolean const query = this.when; if (typeof query === 'boolean') { this.visible = query; return; } // When query is a string, let's find first if it is a shortcut const mediaQuery = QUERY[query] || query; // Media query is empty or null, we hide it if (mediaQuery.length === 0) { this.visible = false; return; } if ((window as any).matchMedia) { // Listen on media query const callback = (q: MediaQueryList) => { this.visible = q.matches; }; const mediaList = window.matchMedia(mediaQuery); (mediaList as any).addListener(callback as any); this.rmL = () => (mediaList as any).removeListener(callback as any); this.visible = mediaList.matches; } } private isPane(element: HTMLElement): boolean { if (!this.visible) { return false; } return element.parentElement === this.el && element.classList.contains(SPLIT_PANE_SIDE); } private styleChildren() { if (!Build.isBrowser) { return; } const contentId = this.contentId; const children = this.el.children; const nu = this.el.childElementCount; let foundMain = false; for (let i = 0; i < nu; i++) { const child = children[i] as HTMLElement; const isMain = contentId !== undefined && child.id === contentId; if (isMain) { if (foundMain) { console.warn('split pane cannot have more than one main node'); return; } foundMain = true; } setPaneClass(child, isMain); } if (!foundMain) { console.warn('split pane does not have a specified main node'); } } render() { const mode = getIonMode(this); return ( ); } } const setPaneClass = (el: HTMLElement, isMain: boolean) => { let toAdd; let toRemove; if (isMain) { toAdd = SPLIT_PANE_MAIN; toRemove = SPLIT_PANE_SIDE; } else { toAdd = SPLIT_PANE_SIDE; toRemove = SPLIT_PANE_MAIN; } const classList = el.classList; classList.add(toAdd); classList.remove(toRemove); };