UNPKG

@angular/material

Version:
534 lines (523 loc) 26.4 kB
/** * @license * Copyright Google LLC All Rights Reserved. * * Use of this source code is governed by an MIT-style license that can be * found in the LICENSE file at https://angular.io/license */ import { A11yModule, FocusMonitor } from '@angular/cdk/a11y'; import { coerceBooleanProperty } from '@angular/cdk/coercion'; import { Attribute, ChangeDetectionStrategy, ChangeDetectorRef, Component, Directive, ElementRef, EventEmitter, Inject, InjectionToken, Input, NgModule, Optional, Output, ViewChild, ViewEncapsulation, forwardRef } from '@angular/core'; import { CheckboxRequiredValidator, NG_VALIDATORS, NG_VALUE_ACCESSOR } from '@angular/forms'; import { MatCommonModule, MatRipple, MatRippleModule, mixinColor, mixinDisableRipple, mixinDisabled, mixinTabIndex } from '@angular/material/core'; import { CommonModule } from '@angular/common'; import { ObserversModule } from '@angular/cdk/observers'; /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ /** * Injection token that can be used to specify the checkbox click behavior. */ const MAT_CHECKBOX_CLICK_ACTION = new InjectionToken('mat-checkbox-click-action'); /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ // Increasing integer for generating unique ids for checkbox components. let nextUniqueId = 0; /** * Provider Expression that allows mat-checkbox to register as a ControlValueAccessor. * This allows it to support [(ngModel)]. * \@docs-private */ const MAT_CHECKBOX_CONTROL_VALUE_ACCESSOR = { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => MatCheckbox), multi: true }; /** @enum {number} */ const TransitionCheckState = { /** The initial state of the component before any user interaction. */ Init: 0, /** The state representing the component when it's becoming checked. */ Checked: 1, /** The state representing the component when it's becoming unchecked. */ Unchecked: 2, /** The state representing the component when it's becoming indeterminate. */ Indeterminate: 3, }; TransitionCheckState[TransitionCheckState.Init] = "Init"; TransitionCheckState[TransitionCheckState.Checked] = "Checked"; TransitionCheckState[TransitionCheckState.Unchecked] = "Unchecked"; TransitionCheckState[TransitionCheckState.Indeterminate] = "Indeterminate"; /** * Change event object emitted by MatCheckbox. */ class MatCheckboxChange { } /** * \@docs-private */ class MatCheckboxBase { /** * @param {?} _elementRef */ constructor(_elementRef) { this._elementRef = _elementRef; } } const _MatCheckboxMixinBase = mixinTabIndex(mixinColor(mixinDisableRipple(mixinDisabled(MatCheckboxBase)), 'accent')); /** * A material design checkbox component. Supports all of the functionality of an HTML5 checkbox, * and exposes a similar API. A MatCheckbox can be either checked, unchecked, indeterminate, or * disabled. Note that all additional accessibility attributes are taken care of by the component, * so there is no need to provide them yourself. However, if you want to omit a label and still * have the checkbox be accessible, you may supply an [aria-label] input. * See: https://www.google.com/design/spec/components/selection-controls.html */ class MatCheckbox extends _MatCheckboxMixinBase { /** * @param {?} elementRef * @param {?} _changeDetectorRef * @param {?} _focusMonitor * @param {?} tabIndex * @param {?} _clickAction */ constructor(elementRef, _changeDetectorRef, _focusMonitor, tabIndex, _clickAction) { super(elementRef); this._changeDetectorRef = _changeDetectorRef; this._focusMonitor = _focusMonitor; this._clickAction = _clickAction; /** * Attached to the aria-label attribute of the host element. In most cases, arial-labelledby will * take precedence so this may be omitted. */ this.ariaLabel = ''; /** * Users can specify the `aria-labelledby` attribute which will be forwarded to the input element */ this.ariaLabelledby = null; this._uniqueId = `mat-checkbox-${++nextUniqueId}`; /** * A unique id for the checkbox input. If none is supplied, it will be auto-generated. */ this.id = this._uniqueId; /** * Whether the label should appear after or before the checkbox. Defaults to 'after' */ this.labelPosition = 'after'; /** * Name value will be applied to the input element if present */ this.name = null; /** * Event emitted when the checkbox's `checked` value changes. */ this.change = new EventEmitter(); /** * Event emitted when the checkbox's `indeterminate` value changes. */ this.indeterminateChange = new EventEmitter(); /** * Called when the checkbox is blurred. Needed to properly implement ControlValueAccessor. * \@docs-private */ this._onTouched = () => { }; this._currentAnimationClass = ''; this._currentCheckState = TransitionCheckState.Init; this._controlValueAccessorChangeFn = () => { }; this._checked = false; this._indeterminate = false; this.tabIndex = parseInt(tabIndex) || 0; } /** * Returns the unique id for the visual hidden input. * @return {?} */ get inputId() { return `${this.id || this._uniqueId}-input`; } /** * Whether the checkbox is required. * @return {?} */ get required() { return this._required; } /** * @param {?} value * @return {?} */ set required(value) { this._required = coerceBooleanProperty(value); } /** * Whether or not the checkbox should appear before or after the label. * @deprecated * \@deletion-target 6.0.0 * @return {?} */ get align() { // align refers to the checkbox relative to the label, while labelPosition refers to the // label relative to the checkbox. As such, they are inverted. return this.labelPosition == 'after' ? 'start' : 'end'; } /** * @param {?} value * @return {?} */ set align(value) { this.labelPosition = (value == 'start') ? 'after' : 'before'; } /** * @return {?} */ ngAfterViewInit() { this._focusMonitor .monitor(this._inputElement.nativeElement) .subscribe(focusOrigin => this._onInputFocusChange(focusOrigin)); } /** * @return {?} */ ngOnDestroy() { this._focusMonitor.stopMonitoring(this._inputElement.nativeElement); } /** * Whether the checkbox is checked. * @return {?} */ get checked() { return this._checked; } /** * @param {?} value * @return {?} */ set checked(value) { if (value != this.checked) { this._checked = value; this._changeDetectorRef.markForCheck(); } } /** * Whether the checkbox is indeterminate. This is also known as "mixed" mode and can be used to * represent a checkbox with three states, e.g. a checkbox that represents a nested list of * checkable items. Note that whenever checkbox is manually clicked, indeterminate is immediately * set to false. * @return {?} */ get indeterminate() { return this._indeterminate; } /** * @param {?} value * @return {?} */ set indeterminate(value) { const /** @type {?} */ changed = value != this._indeterminate; this._indeterminate = value; if (changed) { if (this._indeterminate) { this._transitionCheckState(TransitionCheckState.Indeterminate); } else { this._transitionCheckState(this.checked ? TransitionCheckState.Checked : TransitionCheckState.Unchecked); } this.indeterminateChange.emit(this._indeterminate); } } /** * @return {?} */ _isRippleDisabled() { return this.disableRipple || this.disabled; } /** * Method being called whenever the label text changes. * @return {?} */ _onLabelTextChange() { // This method is getting called whenever the label of the checkbox changes. // Since the checkbox uses the OnPush strategy we need to notify it about the change // that has been recognized by the cdkObserveContent directive. this._changeDetectorRef.markForCheck(); } /** * @param {?} value * @return {?} */ writeValue(value) { this.checked = !!value; } /** * @param {?} fn * @return {?} */ registerOnChange(fn) { this._controlValueAccessorChangeFn = fn; } /** * @param {?} fn * @return {?} */ registerOnTouched(fn) { this._onTouched = fn; } /** * @param {?} isDisabled * @return {?} */ setDisabledState(isDisabled) { this.disabled = isDisabled; this._changeDetectorRef.markForCheck(); } /** * @return {?} */ _getAriaChecked() { return this.checked ? 'true' : (this.indeterminate ? 'mixed' : 'false'); } /** * @param {?} newState * @return {?} */ _transitionCheckState(newState) { let /** @type {?} */ oldState = this._currentCheckState; let /** @type {?} */ element = this._elementRef.nativeElement; if (oldState === newState) { return; } if (this._currentAnimationClass.length > 0) { element.classList.remove(this._currentAnimationClass); } this._currentAnimationClass = this._getAnimationClassForCheckStateTransition(oldState, newState); this._currentCheckState = newState; if (this._currentAnimationClass.length > 0) { element.classList.add(this._currentAnimationClass); } } /** * @return {?} */ _emitChangeEvent() { let /** @type {?} */ event = new MatCheckboxChange(); event.source = this; event.checked = this.checked; this._controlValueAccessorChangeFn(this.checked); this.change.emit(event); } /** * Function is called whenever the focus changes for the input element. * @param {?} focusOrigin * @return {?} */ _onInputFocusChange(focusOrigin) { if (!this._focusRipple && focusOrigin === 'keyboard') { this._focusRipple = this.ripple.launch(0, 0, { persistent: true }); } else if (!focusOrigin) { this._removeFocusRipple(); this._onTouched(); } } /** * Toggles the `checked` state of the checkbox. * @return {?} */ toggle() { this.checked = !this.checked; } /** * Event handler for checkbox input element. * Toggles checked state if element is not disabled. * Do not toggle on (change) event since IE doesn't fire change event when * indeterminate checkbox is clicked. * @param {?} event * @return {?} */ _onInputClick(event) { // We have to stop propagation for click events on the visual hidden input element. // By default, when a user clicks on a label element, a generated click event will be // dispatched on the associated input element. Since we are using a label element as our // root container, the click event on the `checkbox` will be executed twice. // The real click event will bubble up, and the generated click event also tries to bubble up. // This will lead to multiple click events. // Preventing bubbling for the second event will solve that issue. event.stopPropagation(); // If resetIndeterminate is false, and the current state is indeterminate, do nothing on click if (!this.disabled && this._clickAction !== 'noop') { // When user manually click on the checkbox, `indeterminate` is set to false. if (this.indeterminate && this._clickAction !== 'check') { Promise.resolve().then(() => { this._indeterminate = false; this.indeterminateChange.emit(this._indeterminate); }); } this.toggle(); this._transitionCheckState(this._checked ? TransitionCheckState.Checked : TransitionCheckState.Unchecked); // Emit our custom change event if the native input emitted one. // It is important to only emit it, if the native input triggered one, because // we don't want to trigger a change event, when the `checked` variable changes for example. this._emitChangeEvent(); } else if (!this.disabled && this._clickAction === 'noop') { // Reset native input when clicked with noop. The native checkbox becomes checked after // click, reset it to be align with `checked` value of `mat-checkbox`. this._inputElement.nativeElement.checked = this.checked; this._inputElement.nativeElement.indeterminate = this.indeterminate; } } /** * Focuses the checkbox. * @return {?} */ focus() { this._focusMonitor.focusVia(this._inputElement.nativeElement, 'keyboard'); } /** * @param {?} event * @return {?} */ _onInteractionEvent(event) { // We always have to stop propagation on the change event. // Otherwise the change event, from the input element, will bubble up and // emit its event object to the `change` output. event.stopPropagation(); } /** * @param {?} oldState * @param {?} newState * @return {?} */ _getAnimationClassForCheckStateTransition(oldState, newState) { let /** @type {?} */ animSuffix = ''; switch (oldState) { case TransitionCheckState.Init: // Handle edge case where user interacts with checkbox that does not have [(ngModel)] or // [checked] bound to it. if (newState === TransitionCheckState.Checked) { animSuffix = 'unchecked-checked'; } else if (newState == TransitionCheckState.Indeterminate) { animSuffix = 'unchecked-indeterminate'; } else { return ''; } break; case TransitionCheckState.Unchecked: animSuffix = newState === TransitionCheckState.Checked ? 'unchecked-checked' : 'unchecked-indeterminate'; break; case TransitionCheckState.Checked: animSuffix = newState === TransitionCheckState.Unchecked ? 'checked-unchecked' : 'checked-indeterminate'; break; case TransitionCheckState.Indeterminate: animSuffix = newState === TransitionCheckState.Checked ? 'indeterminate-checked' : 'indeterminate-unchecked'; break; } return `mat-checkbox-anim-${animSuffix}`; } /** * Fades out the focus state ripple. * @return {?} */ _removeFocusRipple() { if (this._focusRipple) { this._focusRipple.fadeOut(); this._focusRipple = null; } } } MatCheckbox.decorators = [ { type: Component, args: [{selector: 'mat-checkbox', template: "<label [attr.for]=\"inputId\" class=\"mat-checkbox-layout\" #label><div class=\"mat-checkbox-inner-container\" [class.mat-checkbox-inner-container-no-side-margin]=\"!checkboxLabel.textContent || !checkboxLabel.textContent.trim()\"><input #input class=\"mat-checkbox-input cdk-visually-hidden\" type=\"checkbox\" [id]=\"inputId\" [required]=\"required\" [checked]=\"checked\" [attr.value]=\"value\" [disabled]=\"disabled\" [attr.name]=\"name\" [tabIndex]=\"tabIndex\" [indeterminate]=\"indeterminate\" [attr.aria-label]=\"ariaLabel\" [attr.aria-labelledby]=\"ariaLabelledby\" [attr.aria-checked]=\"_getAriaChecked()\" (change)=\"_onInteractionEvent($event)\" (click)=\"_onInputClick($event)\"><div matRipple class=\"mat-checkbox-ripple\" [matRippleTrigger]=\"label\" [matRippleDisabled]=\"_isRippleDisabled()\" [matRippleRadius]=\"25\" [matRippleCentered]=\"true\" [matRippleAnimation]=\"{enterDuration: 150}\"></div><div class=\"mat-checkbox-frame\"></div><div class=\"mat-checkbox-background\"><svg version=\"1.1\" focusable=\"false\" class=\"mat-checkbox-checkmark\" viewBox=\"0 0 24 24\" xml:space=\"preserve\"><path class=\"mat-checkbox-checkmark-path\" fill=\"none\" stroke=\"white\" d=\"M4.1,12.7 9,17.6 20.3,6.3\"/></svg><div class=\"mat-checkbox-mixedmark\"></div></div></div><span class=\"mat-checkbox-label\" #checkboxLabel (cdkObserveContent)=\"_onLabelTextChange()\"><span style=\"display:none\">&nbsp;</span><ng-content></ng-content></span></label>", styles: ["@keyframes mat-checkbox-fade-in-background{0%{opacity:0}50%{opacity:1}}@keyframes mat-checkbox-fade-out-background{0%,50%{opacity:1}100%{opacity:0}}@keyframes mat-checkbox-unchecked-checked-checkmark-path{0%,50%{stroke-dashoffset:22.91026}50%{animation-timing-function:cubic-bezier(0,0,.2,.1)}100%{stroke-dashoffset:0}}@keyframes mat-checkbox-unchecked-indeterminate-mixedmark{0%,68.2%{transform:scaleX(0)}68.2%{animation-timing-function:cubic-bezier(0,0,0,1)}100%{transform:scaleX(1)}}@keyframes mat-checkbox-checked-unchecked-checkmark-path{from{animation-timing-function:cubic-bezier(.4,0,1,1);stroke-dashoffset:0}to{stroke-dashoffset:-22.91026}}@keyframes mat-checkbox-checked-indeterminate-checkmark{from{animation-timing-function:cubic-bezier(0,0,.2,.1);opacity:1;transform:rotate(0)}to{opacity:0;transform:rotate(45deg)}}@keyframes mat-checkbox-indeterminate-checked-checkmark{from{animation-timing-function:cubic-bezier(.14,0,0,1);opacity:0;transform:rotate(45deg)}to{opacity:1;transform:rotate(360deg)}}@keyframes mat-checkbox-checked-indeterminate-mixedmark{from{animation-timing-function:cubic-bezier(0,0,.2,.1);opacity:0;transform:rotate(-45deg)}to{opacity:1;transform:rotate(0)}}@keyframes mat-checkbox-indeterminate-checked-mixedmark{from{animation-timing-function:cubic-bezier(.14,0,0,1);opacity:1;transform:rotate(0)}to{opacity:0;transform:rotate(315deg)}}@keyframes mat-checkbox-indeterminate-unchecked-mixedmark{0%{animation-timing-function:linear;opacity:1;transform:scaleX(1)}100%,32.8%{opacity:0;transform:scaleX(0)}}.mat-checkbox-checkmark,.mat-checkbox-mixedmark{width:calc(100% - 4px)}.mat-checkbox-background,.mat-checkbox-frame{top:0;left:0;right:0;bottom:0;position:absolute;border-radius:2px;box-sizing:border-box;pointer-events:none}.mat-checkbox{transition:background .4s cubic-bezier(.25,.8,.25,1),box-shadow 280ms cubic-bezier(.4,0,.2,1);cursor:pointer}.mat-checkbox-layout{cursor:inherit;align-items:baseline;vertical-align:middle;display:inline-flex;white-space:nowrap}.mat-checkbox-inner-container{display:inline-block;height:20px;line-height:0;margin:auto;margin-right:8px;order:0;position:relative;vertical-align:middle;white-space:nowrap;width:20px;flex-shrink:0}[dir=rtl] .mat-checkbox-inner-container{margin-left:8px;margin-right:auto}.mat-checkbox-inner-container-no-side-margin{margin-left:0;margin-right:0}.mat-checkbox-frame{background-color:transparent;transition:border-color 90ms cubic-bezier(0,0,.2,.1);border-width:2px;border-style:solid}.mat-checkbox-background{align-items:center;display:inline-flex;justify-content:center;transition:background-color 90ms cubic-bezier(0,0,.2,.1),opacity 90ms cubic-bezier(0,0,.2,.1)}.mat-checkbox-checkmark{top:0;left:0;right:0;bottom:0;position:absolute;width:100%}.mat-checkbox-checkmark-path{stroke-dashoffset:22.91026;stroke-dasharray:22.91026;stroke-width:2.66667px}.mat-checkbox-mixedmark{height:2px;opacity:0;transform:scaleX(0) rotate(0)}.mat-checkbox-label-before .mat-checkbox-inner-container{order:1;margin-left:8px;margin-right:auto}[dir=rtl] .mat-checkbox-label-before .mat-checkbox-inner-container{margin-left:auto;margin-right:8px}.mat-checkbox-checked .mat-checkbox-checkmark{opacity:1}.mat-checkbox-checked .mat-checkbox-checkmark-path{stroke-dashoffset:0}.mat-checkbox-checked .mat-checkbox-mixedmark{transform:scaleX(1) rotate(-45deg)}.mat-checkbox-indeterminate .mat-checkbox-checkmark{opacity:0;transform:rotate(45deg)}.mat-checkbox-indeterminate .mat-checkbox-checkmark-path{stroke-dashoffset:0}.mat-checkbox-indeterminate .mat-checkbox-mixedmark{opacity:1;transform:scaleX(1) rotate(0)}.mat-checkbox-unchecked .mat-checkbox-background{background-color:transparent}.mat-checkbox-disabled{cursor:default}.mat-checkbox-anim-unchecked-checked .mat-checkbox-background{animation:180ms linear 0s mat-checkbox-fade-in-background}.mat-checkbox-anim-unchecked-checked .mat-checkbox-checkmark-path{animation:180ms linear 0s mat-checkbox-unchecked-checked-checkmark-path}.mat-checkbox-anim-unchecked-indeterminate .mat-checkbox-background{animation:180ms linear 0s mat-checkbox-fade-in-background}.mat-checkbox-anim-unchecked-indeterminate .mat-checkbox-mixedmark{animation:90ms linear 0s mat-checkbox-unchecked-indeterminate-mixedmark}.mat-checkbox-anim-checked-unchecked .mat-checkbox-background{animation:180ms linear 0s mat-checkbox-fade-out-background}.mat-checkbox-anim-checked-unchecked .mat-checkbox-checkmark-path{animation:90ms linear 0s mat-checkbox-checked-unchecked-checkmark-path}.mat-checkbox-anim-checked-indeterminate .mat-checkbox-checkmark{animation:90ms linear 0s mat-checkbox-checked-indeterminate-checkmark}.mat-checkbox-anim-checked-indeterminate .mat-checkbox-mixedmark{animation:90ms linear 0s mat-checkbox-checked-indeterminate-mixedmark}.mat-checkbox-anim-indeterminate-checked .mat-checkbox-checkmark{animation:.5s linear 0s mat-checkbox-indeterminate-checked-checkmark}.mat-checkbox-anim-indeterminate-checked .mat-checkbox-mixedmark{animation:.5s linear 0s mat-checkbox-indeterminate-checked-mixedmark}.mat-checkbox-anim-indeterminate-unchecked .mat-checkbox-background{animation:180ms linear 0s mat-checkbox-fade-out-background}.mat-checkbox-anim-indeterminate-unchecked .mat-checkbox-mixedmark{animation:.3s linear 0s mat-checkbox-indeterminate-unchecked-mixedmark}.mat-checkbox-input{bottom:0;left:50%}.mat-checkbox-ripple{position:absolute;left:calc(50% - 25px);top:calc(50% - 25px);height:50px;width:50px;z-index:1;pointer-events:none}"], exportAs: 'matCheckbox', host: { 'class': 'mat-checkbox', '[id]': 'id', '[class.mat-checkbox-indeterminate]': 'indeterminate', '[class.mat-checkbox-checked]': 'checked', '[class.mat-checkbox-disabled]': 'disabled', '[class.mat-checkbox-label-before]': 'labelPosition == "before"', }, providers: [MAT_CHECKBOX_CONTROL_VALUE_ACCESSOR], inputs: ['disabled', 'disableRipple', 'color', 'tabIndex'], encapsulation: ViewEncapsulation.None, preserveWhitespaces: false, changeDetection: ChangeDetectionStrategy.OnPush },] }, ]; /** @nocollapse */ MatCheckbox.ctorParameters = () => [ { type: ElementRef, }, { type: ChangeDetectorRef, }, { type: FocusMonitor, }, { type: undefined, decorators: [{ type: Attribute, args: ['tabindex',] },] }, { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [MAT_CHECKBOX_CLICK_ACTION,] },] }, ]; MatCheckbox.propDecorators = { "ariaLabel": [{ type: Input, args: ['aria-label',] },], "ariaLabelledby": [{ type: Input, args: ['aria-labelledby',] },], "id": [{ type: Input },], "required": [{ type: Input },], "align": [{ type: Input },], "labelPosition": [{ type: Input },], "name": [{ type: Input },], "change": [{ type: Output },], "indeterminateChange": [{ type: Output },], "value": [{ type: Input },], "_inputElement": [{ type: ViewChild, args: ['input',] },], "ripple": [{ type: ViewChild, args: [MatRipple,] },], "checked": [{ type: Input },], "indeterminate": [{ type: Input },], }; /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ const MAT_CHECKBOX_REQUIRED_VALIDATOR = { provide: NG_VALIDATORS, useExisting: forwardRef(() => MatCheckboxRequiredValidator), multi: true }; /** * Validator for Material checkbox's required attribute in template-driven checkbox. * Current CheckboxRequiredValidator only work with `input type=checkbox` and does not * work with `mat-checkbox`. */ class MatCheckboxRequiredValidator extends CheckboxRequiredValidator { } MatCheckboxRequiredValidator.decorators = [ { type: Directive, args: [{ selector: `mat-checkbox[required][formControlName], mat-checkbox[required][formControl], mat-checkbox[required][ngModel]`, providers: [MAT_CHECKBOX_REQUIRED_VALIDATOR], host: { '[attr.required]': 'required ? "" : null' } },] }, ]; /** @nocollapse */ MatCheckboxRequiredValidator.ctorParameters = () => []; /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ class MatCheckboxModule { } MatCheckboxModule.decorators = [ { type: NgModule, args: [{ imports: [CommonModule, MatRippleModule, MatCommonModule, ObserversModule, A11yModule], exports: [MatCheckbox, MatCheckboxRequiredValidator, MatCommonModule], declarations: [MatCheckbox, MatCheckboxRequiredValidator], },] }, ]; /** @nocollapse */ MatCheckboxModule.ctorParameters = () => []; /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ /** * @fileoverview added by tsickle * @suppress {checkTypes} checked by tsc */ /** * Generated bundle index. Do not edit. */ export { MAT_CHECKBOX_CONTROL_VALUE_ACCESSOR, TransitionCheckState, MatCheckboxChange, MatCheckboxBase, _MatCheckboxMixinBase, MatCheckbox, MAT_CHECKBOX_CLICK_ACTION, MatCheckboxModule, MAT_CHECKBOX_REQUIRED_VALIDATOR, MatCheckboxRequiredValidator }; //# sourceMappingURL=checkbox.js.map