import { Component, ComponentInterface, Element, Event, EventEmitter, Prop, State } from '@stencil/core'; import { Color, CssClassMap, Mode, RouterDirection } from '../../interface'; import { hasShadowDom } from '../../utils/helpers'; import { createColorClasses, openURL } from '../../utils/theme'; @Component({ tag: 'ion-button', styleUrls: { ios: 'button.ios.scss', md: 'button.md.scss' }, shadow: true, }) export class Button implements ComponentInterface { @Element() el!: HTMLElement; @Prop({ context: 'window' }) win!: Window; @State() keyFocus = false; /** * The color to use from your application's color palette. * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`. * For more information on colors, see [theming](/docs/theming/basics). */ @Prop() color?: Color; /** * The mode determines which platform styles to use. * Possible values are: `"ios"` or `"md"`. */ @Prop() mode!: Mode; /** * The type of button. * Possible values are: `"button"`, `"bar-button"`. */ @Prop({ mutable: true }) buttonType = 'button'; /** * If true, the user cannot interact with the button. Defaults to `false`. */ @Prop({ reflectToAttr: true }) disabled = false; /** * Set to `"block"` for a full-width button or to `"full"` for a full-width button * without left and right borders. */ @Prop({ reflectToAttr: true }) expand?: 'full' | 'block'; /** * Set to `"clear"` for a transparent button, to `"outline"` for a transparent * button with a border, or to `"solid"`. The default style is `"solid"` except inside of * a toolbar, where the default is `"clear"`. */ @Prop({ reflectToAttr: true, mutable: true }) fill?: 'clear' | 'outline' | 'solid' | 'default'; /** * When using a router, it specifies the transition direction when navigating to * another page using `href`. */ @Prop() routerDirection?: RouterDirection; /** * Contains a URL or a URL fragment that the hyperlink points to. * If this property is set, an anchor tag will be rendered. */ @Prop() href?: string; /** * The button shape. * Possible values are: `"round"`. */ @Prop({ reflectToAttr: true }) shape?: 'round'; /** * The button size. * Possible values are: `"small"`, `"default"`, `"large"`. */ @Prop({ reflectToAttr: true }) size?: 'small' | 'default' | 'large'; /** * If true, activates a button with a heavier font weight. */ @Prop() strong = false; /** * The type of the button. * Possible values are: `"submit"`, `"reset"` and `"button"`. * Default value is: `"button"` */ @Prop() type: 'submit' | 'reset' | 'button' = 'button'; /** * Emitted when the button has focus. */ @Event() ionFocus!: EventEmitter; /** * Emitted when the button loses focus. */ @Event() ionBlur!: EventEmitter; componentWillLoad() { if (this.fill === undefined) { this.fill = this.el.closest('ion-buttons') ? 'clear' : 'solid'; } } private onFocus() { this.ionFocus.emit(); } private onKeyUp() { this.keyFocus = true; } private onBlur() { this.keyFocus = false; this.ionBlur.emit(); } private onClick(ev: Event) { if (this.type === 'button') { return openURL(this.win, this.href, ev, this.routerDirection); } else if (hasShadowDom(this.el)) { // this button wants to specifically submit a form // climb up the dom to see if we're in a
// and if so, then use JS to submit it const form = this.el.closest('form'); if (form) { ev.preventDefault(); ev.stopPropagation(); const fakeButton = document.createElement('button'); fakeButton.type = this.type; fakeButton.style.display = 'none'; form.appendChild(fakeButton); fakeButton.click(); fakeButton.remove(); } } return Promise.resolve(false); } hostData() { const { buttonType, color, expand, fill, mode, shape, size, strong } = this; return { 'ion-activatable': true, class: { ...createColorClasses(color), ...getButtonClassMap(buttonType, mode), ...getButtonTypeClassMap(buttonType, expand, mode), ...getButtonTypeClassMap(buttonType, size, mode), ...getButtonTypeClassMap(buttonType, shape, mode), ...getButtonTypeClassMap(buttonType, strong ? 'strong' : undefined, mode), ...getButtonTypeClassMap(buttonType, fill, mode), 'focused': this.keyFocus, } }; } render() { const TagType = this.href === undefined ? 'button' : 'a'; const attrs = (TagType === 'button') ? { type: this.type } : { href: this.href }; return ( {this.mode === 'md' && } ); } } /** * Get the classes based on the button type * e.g. alert-button, action-sheet-button */ function getButtonClassMap(buttonType: string | undefined, mode: Mode): CssClassMap { if (buttonType === undefined) { return {}; } return { [buttonType]: true, [`${buttonType}-${mode}`]: true }; } /** * Get the classes based on the type * e.g. block, full, round, large */ function getButtonTypeClassMap(buttonType: string, type: string | undefined, mode: Mode): CssClassMap { if (type === undefined) { return {}; } return { [`${buttonType}-${type}`]: true, [`${buttonType}-${type}-${mode}`]: true }; }