Browse Source

add some comments

robert2206 8 năm trước cách đây
mục cha
commit
fdc3dd5d85
4 tập tin đã thay đổi với 180 bổ sung64 xóa
  1. 49 10
      src/base/base-details-view.ts
  2. 89 41
      src/base/base-list-view.ts
  3. 41 10
      src/base/base-view.ts
  4. 1 3
      src/pages/order/order.html

+ 49 - 10
src/base/base-details-view.ts

@@ -4,6 +4,18 @@ import { Observable } from "rxjs/Observable";
 
 import { EventsManager } from "../base/events/event-manager";
 
+/**
+ *
+ * ██████╗  █████╗ ███████╗███████╗██████╗ ███████╗████████╗ █████╗ ██╗██╗     ███████╗██╗   ██╗██╗███████╗██╗    ██╗
+ * ██╔══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔══██╗██║██║     ██╔════╝██║   ██║██║██╔════╝██║    ██║
+ * ██████╔╝███████║███████╗█████╗  ██║  ██║█████╗     ██║   ███████║██║██║     ███████╗██║   ██║██║█████╗  ██║ █╗ ██║
+ * ██╔══██╗██╔══██║╚════██║██╔══╝  ██║  ██║██╔══╝     ██║   ██╔══██║██║██║     ╚════██║╚██╗ ██╔╝██║██╔══╝  ██║███╗██║
+ * ██████╔╝██║  ██║███████║███████╗██████╔╝███████╗   ██║   ██║  ██║██║███████╗███████║ ╚████╔╝ ██║███████╗╚███╔███╔╝
+ * ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝╚══════╝╚══════╝  ╚═══╝  ╚═╝╚══════╝ ╚══╝╚══╝
+ *
+ * Clase que maneja las vistas de detalles.
+ *
+ */
 export abstract class BaseDetailsView<T> extends BaseView<T> {
 
     item: T;
@@ -18,6 +30,15 @@ export abstract class BaseDetailsView<T> extends BaseView<T> {
         this.action = this.itemExists() ? "to_update" : "to_create";
     }
 
+    // ------------------------------------------------------------
+    //   ██████╗ ███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝ ██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ██║  ███╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ██║   ██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ╚██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //   ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // ------------------------------------------------------------
+
     /**
      * 
      */
@@ -27,32 +48,41 @@ export abstract class BaseDetailsView<T> extends BaseView<T> {
 
     /**
      * 
-     * @param item 
      */
-    setItem(item: T) {
-        this.item = item;
+    getKind(): string {
+        return this.kind;
     }
 
     /**
      * 
      */
-    getKind(): string {
-        return this.kind;
+    getAction(): string {
+        return this.action;
     }
 
+    // -----------------------------------------------------------
+    //  ███████╗███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ███████╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ╚════██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ███████║███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //  ╚══════╝╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // -----------------------------------------------------------
+    
     /**
      * 
-     * @param kind 
+     * @param item 
      */
-    setKind(kind: string): void {
-        this.kind = kind;
+    setItem(item: T) {
+        this.item = item;
     }
 
     /**
      * 
+     * @param kind 
      */
-    getAction(): string {
-        return this.action;
+    setKind(kind: string): void {
+        this.kind = kind;
     }
 
     /**
@@ -63,6 +93,15 @@ export abstract class BaseDetailsView<T> extends BaseView<T> {
         this.action = action;
     }
 
+    //---------------------------------------------------------------
+    //  ███████╗███████╗██████╗ ██╗   ██╗██╗ ██████╗███████╗███████╗
+    //  ██╔════╝██╔════╝██╔══██╗██║   ██║██║██╔════╝██╔════╝██╔════╝
+    //  ███████╗█████╗  ██████╔╝██║   ██║██║██║     █████╗  ███████╗
+    //  ╚════██║██╔══╝  ██╔══██╗╚██╗ ██╔╝██║██║     ██╔══╝  ╚════██║
+    //  ███████║███████╗██║  ██║ ╚████╔╝ ██║╚██████╗███████╗███████║
+    //  ╚══════╝╚══════╝╚═╝  ╚═╝  ╚═══╝  ╚═╝ ╚═════╝╚══════╝╚══════╝                                                    
+    //---------------------------------------------------------------
+    
     /**
      * 
      */

+ 89 - 41
src/base/base-list-view.ts

@@ -5,6 +5,18 @@ import { Observer } from "rxjs/Observer";
 
 import { EventsManager } from "../base/events/event-manager";
 
+/**
+ *
+ * ██████╗  █████╗ ███████╗███████╗██╗     ██╗███████╗████████╗██╗   ██╗██╗███████╗██╗    ██╗
+ * ██╔══██╗██╔══██╗██╔════╝██╔════╝██║     ██║██╔════╝╚══██╔══╝██║   ██║██║██╔════╝██║    ██║
+ * ██████╔╝███████║███████╗█████╗  ██║     ██║███████╗   ██║   ██║   ██║██║█████╗  ██║ █╗ ██║
+ * ██╔══██╗██╔══██║╚════██║██╔══╝  ██║     ██║╚════██║   ██║   ╚██╗ ██╔╝██║██╔══╝  ██║███╗██║
+ * ██████╔╝██║  ██║███████║███████╗███████╗██║███████║   ██║    ╚████╔╝ ██║███████╗╚███╔███╔╝
+ * ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝╚══════╝   ╚═╝     ╚═══╝  ╚═╝╚══════╝ ╚══╝╚══╝
+ *
+ *  Clase que reúne todas la capacidades para mostrar e interactuar con una vista de lista.
+ *
+ */
 export abstract class BaseListView<T> extends BaseView<T>{
 
     items: T[];
@@ -29,9 +41,14 @@ export abstract class BaseListView<T> extends BaseView<T>{
         this.initialize();
     }
 
-    //-------------------------------------------------------------------------------
-    //                           BEGIN GETTERS AND SETTERS                          |
-    //-------------------------------------------------------------------------------
+    // ------------------------------------------------------------
+    //   ██████╗ ███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝ ██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ██║  ███╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ██║   ██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ╚██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //   ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // ------------------------------------------------------------
 
     /**
      * 
@@ -39,66 +56,85 @@ export abstract class BaseListView<T> extends BaseView<T>{
     getItems(): T[] {
         return this.items;
     }
-    
+
     /**
      * 
-     * @param items 
      */
-    setItems(items: T[]): void {
-        this.items = items;
-        this.setItemsShown(this.getItems().slice(this.getRange().start, this.getRange().end));
+    getItemsShown(): T[] {
+        return this.itemsShown;
     }
 
     /**
      * 
      */
-    getItemsShown(): T[] {
-        return this.itemsShown;
+    getItemsMatched(): T[] {
+        return this.itemsMatched;
     }
 
     /**
      * 
-     * @param itemsShown 
      */
-    setItemsShown(itemsShown: T[]): void {
-        this.itemsShown = itemsShown;
-    } 
+    getSelectedItem(): T {
+        return this.selectedItem;
+    }
 
     /**
      * 
      */
-    getItemsMatched(): T[] {
-        return this.itemsMatched;
+    getFilters(): Array<[string, string, any]> {
+        return this.filters;
     }
 
     /**
      * 
-     * @param itemsMatched 
      */
-    setItemsMatched(itemsMatched: T[]): void {
-        this.itemsMatched = itemsMatched;
+    getRange(): { start: number, end: number } {
+        return this.range;
     }
-
+    
+    // -----------------------------------------------------------
+    //  ███████╗███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ███████╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ╚════██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ███████║███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //  ╚══════╝╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // -----------------------------------------------------------
+                                                          
     /**
      * 
-     * @param item 
+     * @param items 
      */
-    setSelectedItem(item: T): void {
-        this.selectedItem = item;
+    setItems(items: T[]): void {
+        this.items = items;
+        this.setItemsShown(this.getItems().slice(this.getRange().start, this.getRange().end));
     }
 
+   
     /**
      * 
+     * @param itemsShown 
      */
-    getSelectedItem(): T {
-        return this.selectedItem;
+    setItemsShown(itemsShown: T[]): void {
+        this.itemsShown = itemsShown;
+    } 
+
+    
+
+    /**
+     * 
+     * @param itemsMatched 
+     */
+    setItemsMatched(itemsMatched: T[]): void {
+        this.itemsMatched = itemsMatched;
     }
 
     /**
      * 
+     * @param item 
      */
-    getFilters(): Array<[string, string, any]> {
-        return this.filters;
+    setSelectedItem(item: T): void {
+        this.selectedItem = item;
     }
 
     /**
@@ -126,13 +162,6 @@ export abstract class BaseListView<T> extends BaseView<T>{
         this.search = search;
     }
 
-    /**
-     * 
-     */
-    getRange(): { start: number, end: number } {
-        return this.range;
-    }
-
     /**
      * 
      * @param range 
@@ -141,8 +170,15 @@ export abstract class BaseListView<T> extends BaseView<T>{
         this.range = range;
     }
 
-    // ------------------------------- SPECIAL GETTERS -------------------------------
-
+    // -------------------------------------------------------------------------------------------------------------------
+    //  ███████╗██████╗ ███████╗ ██████╗██╗ █████╗ ██╗          ██████╗ ███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝██╔══██╗██╔════╝██╔════╝██║██╔══██╗██║         ██╔════╝ ██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ███████╗██████╔╝█████╗  ██║     ██║███████║██║         ██║  ███╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ╚════██║██╔═══╝ ██╔══╝  ██║     ██║██╔══██║██║         ██║   ██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ███████║██║     ███████╗╚██████╗██║██║  ██║███████╗    ╚██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //  ╚══════╝╚═╝     ╚══════╝ ╚═════╝╚═╝╚═╝  ╚═╝╚══════╝     ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // -------------------------------------------------------------------------------------------------------------------
+                                                                                                                  
     /**
      * 
      */
@@ -211,8 +247,15 @@ export abstract class BaseListView<T> extends BaseView<T>{
         return this.getItemsMatched().indexOf(this.getSelectedItem());
     }
 
-    // ---------------------------- SPECIAL SETTERS -----------------------------
-
+    // ------------------------------------------------------------------------------------------------------------------
+    //  ███████╗██████╗ ███████╗ ██████╗██╗ █████╗ ██╗         ███████╗███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝██╔══██╗██╔════╝██╔════╝██║██╔══██╗██║         ██╔════╝██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ███████╗██████╔╝█████╗  ██║     ██║███████║██║         ███████╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ╚════██║██╔═══╝ ██╔══╝  ██║     ██║██╔══██║██║         ╚════██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ███████║██║     ███████╗╚██████╗██║██║  ██║███████╗    ███████║███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //  ╚══════╝╚═╝     ╚══════╝ ╚═════╝╚═╝╚═╝  ╚═╝╚══════╝    ╚══════╝╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // ------------------------------------------------------------------------------------------------------------------
+                                                                                                                 
     /**
      * 
      * @param start 
@@ -229,9 +272,14 @@ export abstract class BaseListView<T> extends BaseView<T>{
         this.setRange({ start: this.getRange().start, end: end });
     }
 
-    //---------------------------------------------------------------------------
-    //                               BEGIN SERVICES                             |
-    //---------------------------------------------------------------------------
+    //---------------------------------------------------------------
+    //  ███████╗███████╗██████╗ ██╗   ██╗██╗ ██████╗███████╗███████╗
+    //  ██╔════╝██╔════╝██╔══██╗██║   ██║██║██╔════╝██╔════╝██╔════╝
+    //  ███████╗█████╗  ██████╔╝██║   ██║██║██║     █████╗  ███████╗
+    //  ╚════██║██╔══╝  ██╔══██╗╚██╗ ██╔╝██║██║     ██╔══╝  ╚════██║
+    //  ███████║███████╗██║  ██║ ╚████╔╝ ██║╚██████╗███████╗███████║
+    //  ╚══════╝╚══════╝╚═╝  ╚═╝  ╚═══╝  ╚═╝ ╚═════╝╚══════╝╚══════╝                                                    
+    //---------------------------------------------------------------
 
     /**
      * Inicializa la lista.

+ 41 - 10
src/base/base-view.ts

@@ -1,7 +1,20 @@
 import { ReflectiveInjector } from "@angular/core";
 import { getMetadataStorage } from "../odoo/utils/metadata-storage";
 
-export class BaseView<T> {
+/**
+ *
+ * ██████╗  █████╗ ███████╗███████╗██╗   ██╗██╗███████╗██╗    ██╗
+ * ██╔══██╗██╔══██╗██╔════╝██╔════╝██║   ██║██║██╔════╝██║    ██║
+ * ██████╔╝███████║███████╗█████╗  ██║   ██║██║█████╗  ██║ █╗ ██║
+ * ██╔══██╗██╔══██║╚════██║██╔══╝  ╚██╗ ██╔╝██║██╔══╝  ██║███╗██║
+ * ██████╔╝██║  ██║███████║███████╗ ╚████╔╝ ██║███████╗╚███╔███╔╝
+ * ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝  ╚═══╝  ╚═╝╚══════╝ ╚══╝╚══╝
+ *
+ * Clase de la cual hereda tanto las clases que manejan vistas de lista como la de detalles
+ * y exponen métodos comunes entre ambos.
+ *
+ */
+export abstract class BaseView<T> {
 
     type: T = {} as T;
     model: any = {};
@@ -15,6 +28,15 @@ export class BaseView<T> {
         this.title = "Sin título";
     }
 
+    // ------------------------------------------------------------
+    //   ██████╗ ███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝ ██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ██║  ███╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ██║   ██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ╚██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //   ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // ------------------------------------------------------------
+
     /**
      * 
      * @param injectable 
@@ -34,15 +56,7 @@ export class BaseView<T> {
         return this.title;
     }
 
-    /**
-     * 
-     * @param title 
-     */
-    setTitle(title: string): void {
-        this.title = title;
-    }
-
-    /**
+       /**
      * 
      */
     getType(): T {
@@ -69,4 +83,21 @@ export class BaseView<T> {
     getInjector(): any {
         return this.injector;
     }
+
+    // -----------------------------------------------------------
+    //  ███████╗███████╗████████╗████████╗███████╗██████╗ ███████╗
+    //  ██╔════╝██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗██╔════╝
+    //  ███████╗█████╗     ██║      ██║   █████╗  ██████╔╝███████╗
+    //  ╚════██║██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗╚════██║
+    //  ███████║███████╗   ██║      ██║   ███████╗██║  ██║███████║
+    //  ╚══════╝╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝
+    // -----------------------------------------------------------
+    
+    /**
+     * 
+     * @param title 
+     */
+    setTitle(title: string): void {
+        this.title = title;
+    }
 }

+ 1 - 3
src/pages/order/order.html

@@ -10,11 +10,9 @@
 </ion-header>
 <ion-content>
     <form>
-        <ion-item-divider color="light">Cliente</ion-item-divider>
         <ion-item>
-            <ion-input type="text" placeholder="Sin cliente" clearInput></ion-input>
+            <ion-input type="text" placeholder="Seleccione un cliente"></ion-input>
         </ion-item>
-        <ion-item-divider color="light">Cliente</ion-item-divider>
     </form>
 
     <ion-fab right bottom>