ionic-framework/ionic/components/searchbar/searchbar.ts

import {ElementRef, Pipe, NgControl, Renderer, FORM_DIRECTIVES, NgIf, NgClass} from 'angular2/angular2';

import {Ion} from '../ion';
import {Config} from '../../config/config';
import {ConfigComponent} from '../../config/decorators';
import {Icon} from '../icon/icon';

/**
 * @name Searchbar
 * @module ionic
 * @description
 * Manages the display of a search bar which can be used to search or filter items.
 *
 * @usage
 * ```html
 * <ion-searchbar [(ng-model)]="defaultSearch"></ion-searchbar>
 * ```
 *
 * @property [placeholder] - sets input placeholder to value passed in
 * @property [show-cancel] - shows the cancel button based on boolean value passed in
 * @property [cancel-text] - sets the cancel button text to the value passed in
 * @property [cancel-action] - the function that gets called by clicking the cancel button
 * @see {@link /docs/v2/components#search Search Component Docs}
 */
@ConfigComponent({
  selector: 'ion-searchbar',
  defaultInputs: {
    'showCancel': false,
    'cancelText': 'Cancel',
    'placeholder': 'Search'
  },
  inputs: ['cancelAction'],
  host: {
   '[class.left-align]': 'shouldLeftAlign',
   '[class.focused]': 'isFocused',
  },
  template:
    '<div class="searchbar-input-container">' +
      '<button (click)="cancelSearchbar($event, query)" clear dark class="searchbar-cancel-icon"><icon arrow-back></icon></button>' +
      '<div class="searchbar-search-icon"></div>' +
      '<input [(value)]="query" (focus)="inputFocused()" (blur)="inputBlurred()" ' +
      '(input)="inputChanged($event)" class="searchbar-input" type="search" [attr.placeholder]="placeholder">' +
      '<button clear *ng-if="query" class="searchbar-close-icon" (click)="clearInput($event)"></button>' +
    '</div>' +
    '<button *ng-if="showCancel" (click)="cancelSearchbar($event, query)" class="searchbar-cancel">{{cancelText}}</button>',
  directives: [FORM_DIRECTIVES, NgIf, NgClass, Icon]
})
export class Searchbar extends Ion {
  /**
   * @private
   * This holds the searchbar input value used for querying
   */
  query: string;

  constructor(
    elementRef: ElementRef,
    config: Config,
    ngControl: NgControl,
    renderer: Renderer
  ) {
    super(elementRef, config);
    this.renderer = renderer;
    this.elementRef = elementRef;

    // If there is no control then we shouldn't do anything
    if (!ngControl) return;

    this.ngControl = ngControl;
    this.ngControl.valueAccessor = this;
  }

  /**
   * @private
   * After the view has initialized check if the searchbar has a value
   * and then store that value in query
   */
  afterViewInit() {
    // If the user passes in a value to the model we should left align
    this.shouldLeftAlign = this.ngControl.value && this.ngControl.value.trim() != '';
    this.query = this.ngControl.value || '';
  }

  /**
   * @private
   * Write a new value to the element.
   */
  writeValue(value) {
    this.query = value;
  }

  /**
   * @private
   * Set the function to be called when the control receives a change event.
   */
  registerOnChange(fn) {
    this.onChange = fn;
  }

  /**
   * @private
   * Set the function to be called when the control receives a touch event.
   */
  registerOnTouched(fn) {
    this.onTouched = fn;
  }

  /**
   * @private
   * Updates the value of the control when the searchbar input changes.
   */
  inputChanged(event) {
    this.writeValue(event.target.value);
    this.onChange(event.target.value);
  }

  /**
   * @private
   * Sets the searchbar to focused and aligned left on input focus.
   */
  inputFocused() {
    this.isFocused = true;
    this.shouldLeftAlign = true;
  }

  /**
   * @private
   * Sets the searchbar to not focused and checks if it should align left
   * based on whether there is a value in the searchbar or not on input blur.
   */
  inputBlurred() {
    this.isFocused = false;
    this.shouldLeftAlign = this.ngControl.value && this.ngControl.value.trim() != '';
  }

  /**
   * @private
   * Clears the input field and triggers the control change.
   */
  clearInput(event) {
    this.writeValue('');
    this.onChange('');
  }

  /**
   * @private
   * Blurs the input field, clears the input field and removes the left align
   * then calls the custom cancel function if the user passed one in.
   */
  cancelSearchbar(event, query) {
    this.element = this.elementRef.nativeElement.querySelector('input');
    this.element.blur();
    this.clearInput();
    this.shouldLeftAlign = false;

    this.cancelAction && this.cancelAction(event, query);
  }
}