@sapphire-ion/framework 1.2.62 → 1.3.1

package/src/lib/components/default/default-list/header-list/header-list.component.html

@@ -0,0 +1,32 @@
+<div class="flex flex-wrap w-full gap-2">
+  @if (!noPage) {
+    <div class="portrait:basis-[calc(50%-0.25rem)] landscape:w-48 portrait:order-1">
+      <ion-item class="rounded-2xl w-full h-full translucid-border" lines="full" style="--border-radius: 1rem !important; --background: transparent" >
+        <ion-select [disabled]="loading" [(ngModel)]="limit" (ionChange)="EmitLimit()" interface="popover">
+          @for (limit of lstLimits; track limit) {
+            <ion-select-option [value]="limit.value">{{limit.label}}</ion-select-option>
+          }
+        </ion-select>
+      </ion-item>
+    </div>
+  }
+  
+  <ng-content select="[slot=start]"></ng-content>
+
+  @if(!noSearch) {
+    <div class="portrait:basis-full portrait:order-3 grow flex items-center justify-center">
+      <ion-searchbar class="w-full min-h-0 p-0 m-0" [debounce]="500" [(ngModel)]="search" (ionInput)="this.EmitSearch()" [animated]="true" placeholder="Pesquisar..."></ion-searchbar>
+    </div>
+  }
+
+  <ng-content select="[slot=end]"></ng-content>
+
+  @if(!noNew){
+    <div class="portrait:basis-[calc(50%-0.25rem)] landscape:basis-24 portrait:order-2">
+      <ion-button [routerLink]="overrideNew ? null : [link]" (click)="onNew()" class="size-full m-0 rounded-2xl text-base" size="small" fill="clear">
+        <ion-icon name="add" slot="start"></ion-icon>
+        <ion-text class="text-base">Novo</ion-text>
+      </ion-button>
+    </div>
+  }
+</div>

package/src/lib/components/default/default-list/header-list/header-list.component.ts

@@ -0,0 +1,85 @@
+import { Component, Output, Input, EventEmitter, HostListener } from '@angular/core';
+import { IonSearchbar } from '@ionic/angular';
+
+import { EnvironmentService } from '../../../../services/environment.service';
+import { PageOption } from '../../../../classes/page-option';
+
+/** Componente de cabeçalho de listagem padrão  */
+@Component({
+  selector: 'header-list',
+  templateUrl: './header-list.component.html',
+  styleUrls: ['./header-list.component.scss'],
+})
+export class HeaderListComponent {
+
+  /** Número de páginas máximo (usando two way data binding) */
+  @Input()  limit: number | null;
+  @Output() limitChange: EventEmitter<number | null> = new EventEmitter<number | null>();
+
+  /** Valor da pagina, setado = 1 quando troca-se o valor de limite de paginas (usando two way data binding) */
+  @Input() page: number;
+  @Output() pageChange: EventEmitter<number> = new EventEmitter<number>();
+
+  /** Campo de pesquisa (usando two way data binding) */
+  @Input() search: string | null;
+  @Output() searchChange: EventEmitter<string | null> = new EventEmitter<string | null>();
+  
+  @Input() loading: boolean;
+
+  /** Evento de refersh
+   * Emitido em:
+   *  - Troca de página
+   *  - Pesquisa
+   */
+  @Output('refresh') refreshEmitter: EventEmitter<void> = new EventEmitter<void>();
+
+  /** Link a ser acessado no click do botão NOVO */
+  @Input() link : string = "view";
+
+  /** Remove o botão NOVO */
+  @Input() noNew: boolean = false;
+  /** Remove o select de paginas */
+  @Input() noPage: boolean = false;
+  /** Remove o elemento de pesquisa */
+  @Input() noSearch: boolean = false;
+    
+
+  /** Desabilita o redirect de novo em um botão para ser utilizado com [onNewEmitter] */
+  @Input() overrideNew: boolean = false;
+  /** Evento quando o botáo NOVO é clickado */
+  @Output('onNew') onNewEmitter: EventEmitter<void> = new EventEmitter<void>();
+
+  onNew(): void{
+    this.onNewEmitter.emit();
+  }
+
+  constructor(private environmentService: EnvironmentService) { 
+    this.lstLimits = environmentService.environment.defaultPageLimits;
+    this.limit = this.lstLimits[0].value
+  }
+
+  lstLimits: PageOption[] = []
+  EmitSearch(): void{
+    this.searchChange.emit(this.search);
+    this.EmitChange();
+  }
+
+  EmitLimit(): void{
+    this.limitChange.emit(this.limit);
+    this.pageChange.emit(1);
+    
+    this.EmitChange();
+  }
+
+  EmitChange(){
+    this.refreshEmitter.emit();
+  }
+
+  @HostListener('window:keydown',['$event'])
+  onKeyPress($event: KeyboardEvent) {
+    if(($event.ctrlKey || $event.metaKey) && ($event.key == 'F' || $event.key == 'f')){
+      (document.getElementById("list_search") as any as IonSearchbar).setFocus();
+      $event.preventDefault();
+    }
+  }
+}

package/src/lib/components/default/default-list/list.ts

@@ -0,0 +1,127 @@
+
+import { Component, effect, ElementRef, EventEmitter, Input, model, ModelSignal, OnInit, Output } from '@angular/core';
+import { RefresherCustomEvent } from "@ionic/angular";
+import { Observable, firstValueFrom } from "rxjs";
+import { ActivatedRoute } from '@angular/router';
+
+import { CompileLstTableField, Comparison } from "../../../classes/comparison/comparison";
+import { HttpService, ViewRetorno } from '../../../services/web/http.service';
+import { GenericService } from "../../../services/generic.service";
+import { ViewFiltros } from "../../../classes/filters/view-filtros";
+import { TableField } from "../../../classes/inputs/table-field";
+import { RouteData } from "../../../classes/routes/route-data";
+import { LongProperty } from '../../../classes/comparison/properties/long-property';
+
+//Classe de listagem, implemente carregamento e filtragem de dados
+@Component({ template: '', styles: '' })
+export abstract class List<T extends HttpService<V>, V = any> implements OnInit {
+
+  protected genericService: GenericService;
+  protected activatedRoute: ActivatedRoute;
+  protected elementRef: ElementRef;
+  @Input() service: T;
+
+  constructor() { 
+    effect(() => {
+      this.SetFilters();
+    });
+  }
+  
+  /** @optional Filtro a ser aplicado na busca da listagem na API */
+  preloadFilter: ModelSignal<Comparison[]> = model<Comparison[]>([]); 
+  
+  //TODO FIX https://stackoverflow.com/a/73761805 
+  /** End-point de carregamento de dados. Deve ser uma função no service aplicado */
+  @Input() loadFrom: (view: ViewFiltros) => Observable<ViewRetorno>;
+
+
+  lstDados: V[] = [];
+  total   : number;
+  nested  : boolean = false;
+  loading : boolean = true;
+  
+  originalFilters: Comparison[] = [];
+
+  /** Filtro précarregado  */
+  @Input() frm: ViewFiltros = new ViewFiltros();
+
+  /** Lista de campos a serem substituídos pelo padrão, armazenado no service enviado como parâmetro */
+  @Input() lstTableFields: TableField[] = [];
+
+  async ngOnInit(): Promise<void> {
+    this.originalFilters = this.frm.filter;
+
+    if(this.lstTableFields.length == 0){
+      this.lstTableFields = this.service.lstTableFields;
+    }
+    if(!this.service.route){ console.warn("[ Warning! ] [ Url is undefined ]")}
+    if(!this.service.title){ console.warn("[ Warning! ] [ titulo is undefined ]")}
+    
+    //[ Nested element ]
+    if(this.elementRef.nativeElement.parentElement){
+      this.nested = (this.elementRef.nativeElement.parentElement.tagName as string).toUpperCase() != "ION-CONTENT";
+    }else{
+      this.nested = true;
+    }
+
+    await this.SetFilters();
+    if(this.nested){ this.Refresh(); }
+  }
+
+  /** Carrega os filtros pré-carregados e os filtros compilados */
+  protected async SetFilters(): Promise<void>{
+    await this.LoadIdComparison();
+    const compiled      = CompileLstTableField(this.lstTableFields);
+    const preloadFilter = this.preloadFilter();
+    // Adiciona os filtros pré-carregados, os filtros compilados e os filtros originais e remove os nulos
+    this.frm.filter     = [...preloadFilter, ...compiled, ...this.originalFilters].filter(p => p);
+  }
+
+  async LoadIdComparison(): Promise<void>{
+    try{
+      const data: RouteData = (await firstValueFrom(this.activatedRoute.data)) as RouteData;
+
+      const id   = this.genericService.GetId(this.activatedRoute, data.idPreloaderConfiguration.routeDepth);
+      var index: number = this.lstTableFields.indexOf(this.lstTableFields.find(p => p.index == data.idPreloaderConfiguration.propertyName));
+      const filter: Comparison = new LongProperty(data.idPreloaderConfiguration.propertyName).Equals(id);
+
+      filter.value = id;
+      filter.disableChange = data.idPreloaderConfiguration.disableChange;
+      this.lstTableFields[index].filter = [filter];
+    }finally{ 
+      return;
+    }
+  }
+
+  @Output('WillRefresh') WillRefresh: EventEmitter<void> = new EventEmitter<void>();
+  @Output('DidRefresh') DidRefresh: EventEmitter<void> = new EventEmitter<void>();
+
+  async Refresh(event?: RefresherCustomEvent): Promise<void> {
+    this.WillRefresh.emit();
+    this.loading = true;
+    try{
+      await this.Load();
+    }
+    finally{ }
+    
+    if(event){ event.target.complete(); }
+    this.loading = false;
+    this.DidRefresh.emit();
+  }
+  
+  async Load(): Promise<void>{
+    var vRetorno: ViewRetorno;
+
+    try{
+      if(this.loadFrom){
+        vRetorno = await firstValueFrom(this.service[this.loadFrom.name](this.frm));
+      }
+      else{
+        vRetorno = await firstValueFrom(this.service.List(this.frm));
+      }
+      this.lstDados = vRetorno.lstDados; 
+      this.total    = vRetorno.total; 
+    } finally{ }
+    return;
+  }
+}

package/src/lib/components/default/default-pagination/default-pagination.component.html

@@ -0,0 +1,52 @@
+<div id="pagination" class="flex items-center rounded-b-2xl p-2 portrait:flex-col">
+  <div class="w-full h-full items-center justify-start flex portrait:justify-center">
+    <ion-spinner [hidden]="!(loading && lstPages.length == 0)"></ion-spinner>
+    <ion-text [hidden]="loading && lstPages.length == 0">
+      <div class="flex">
+        Mostrando &nbsp;
+        <ion-skeleton-text *ngIf="loading" [animated]="true" style="width: 2ch"></ion-skeleton-text>
+        <b *ngIf="!loading">{{limit * page - limit + length}}</b>  &nbsp;
+        de 
+        @if (total != null) {
+          <b>&nbsp; {{total}} &nbsp;</b> itens
+        }
+        @else{
+          <b>&nbsp; - &nbsp; </b> itens
+        }
+      </div>
+    </ion-text>
+  </div>
+  <div class="w-full h-full items-center justify-end flex portrait:justify-center" *ngIf="total != null">
+    <button class="flex items-center" [disabled]="loading" (click)="PageSub()">
+      <ion-icon [ngClass]="{'opacity-20': page == 1}" name="chevron-back" class="cursor-pointer default transition"></ion-icon>
+    </button>
+
+    <ion-spinner *ngIf="loading && lstPages.length == 0"></ion-spinner>
+
+    <button [disabled]="loading" class="page" *ngFor="let item of lstPages" [ngClass]="{ 'selected' : page == item }" (click)="SetPage(item)"> {{item}} </button>
+
+    <button class="flex items-center" [disabled]="loading" (click)="PageAdd()">
+      <ion-icon [ngClass]="{'opacity-20': page == TotalPages }" name="chevron-forward" class="cursor-pointer default transition"></ion-icon>
+    </button>
+
+    @if (TotalPages > 5) {
+      <button [disabled]="loading" class="page" [id]="pop_id"><ion-icon name="search"></ion-icon></button>
+      <ion-popover [trigger]="pop_id" triggerAction="click">
+        <ng-template>
+          <ion-content>
+            <div class="grid grid-cols-10 pl-3">
+              <div class="col-span-8 pb-2">
+                <ion-input class="number-class" [(ngModel)]="_page" type="Number" labelPlacement="stacked" label="Página [Max. {{TotalPages}}]"></ion-input>
+              </div>
+              <div class="col-span-2">
+                <ion-button [disabled]="loading" class="size-full" size="small" (click)="SetPageManual()" style="--border-radius: 0rem">
+                  <ion-icon class="w-4 aspect-square" slot="icon-only" name="checkmark-circle"></ion-icon>
+                </ion-button>
+              </div>
+            </div>
+          </ion-content>
+        </ng-template>
+      </ion-popover>
+    }
+    </div>
+</div>

package/src/lib/components/default/default-pagination/default-pagination.component.ts

@@ -0,0 +1,118 @@
+import { Component, OnInit, Input, Output, EventEmitter } from '@angular/core';
+import { GenericService } from '../../../services/generic.service';
+import { Utils } from '../../../services/utils.service';
+
+/** Componente de paginação padrão  */
+@Component({
+  selector: 'default-pagination',
+  templateUrl: './default-pagination.component.html',
+  styleUrls: ['./default-pagination.component.scss'],
+})
+export class DefaultPaginationComponent  implements OnInit {
+
+
+  total: number = 0;
+  limit: number | null = 0;
+  /** Valor total de dados */
+  @Input('total') set _total(value: number){  
+    this.total = value;
+    this.TotalPages = this.GetTotalPages();
+    this.lstPages = this.GetlstPages();
+  };
+  /** Limite de páginas */
+  @Input('limit') set _limit(value: number | null){ 
+    this.limit = value;
+    this.TotalPages = this.GetTotalPages();
+    this.lstPages = this.GetlstPages();
+  };
+
+  /** Quantidade de dados em tela */
+  @Input() length: number;
+  @Input() loading: boolean;
+  
+  /** Pagina atual (usando two way data binding) */
+  @Input() page: number;
+  @Output() pageChange: EventEmitter<number> = new EventEmitter<number>();
+  
+  /** Evento emitido na mudança de valores (Pagina) */
+  @Output('change') changeEmitter: EventEmitter<void> = new EventEmitter<void>();
+  
+  constructor(
+    private genericService: GenericService
+  ) { }
+
+  ngOnInit() {}
+  pop_id: string = "popover-id-" + Utils.GenerateGUID();
+
+  GetlstPages(): number[] {
+    if(!this.TotalPages){ return []; }
+    var startIndex: number;
+    var start: number[] = [];
+
+    startIndex = this.page - 1;
+
+    var _: number[] = [];
+    for(let i = this.TotalPages - 4; i <= this.TotalPages ; i++){
+      if(i > 0){
+        _.push(i);
+      }
+    }
+
+    for(let i = startIndex; i <= this.TotalPages && i < startIndex + 5; i++){
+      if(i > 0){
+        start.push(i);
+      }
+    }
+    if(startIndex == 0 && this.TotalPages >= 5){
+      start.push(5);
+    }
+
+    if(start[0] > _[0]){
+      return _;
+    }
+
+    return start;
+  }
+
+  GetTotalPages(): number{
+    return this.limit ? Math.ceil(this.total / this.limit) : Math.ceil(this.total / this.total)
+  }
+
+  lstPages  : number[] = [];
+  TotalPages: number = 0;
+
+  PageAdd(): void{
+    if(this.page + 1 > this.TotalPages){ return; }
+    this.SetPage(this.page + 1);
+  }
+  
+  PageSub(): void{
+    if(this.page - 1 < 1){ return; }
+    this.SetPage(this.page - 1);
+  }
+
+  SetPage(value: number): void{
+    if(value != this.page){
+      this.pageChange.emit(value);
+      this.EmitChange()
+
+      setTimeout(() => {
+        this.TotalPages = this.GetTotalPages();
+        this.lstPages = this.GetlstPages();
+      }, 100);
+    }
+  }
+
+  _page: number;
+  SetPageManual(){
+    if(this._page && this._page > 0 && this._page <= this.TotalPages){
+      this.SetPage(this._page);
+    }else{
+      this.genericService.PresentToast("Página inválida")
+    }
+  }
+
+  EmitChange(): void{
+    this.changeEmitter.emit();
+  }
+}

package/src/lib/components/default/default-table/default-table.component.html

@@ -0,0 +1,104 @@
+<div class="size-full rounded-xl flex flex-col overflow-hidden relative">
+    <loading [type]="3" [loading]="loading()"></loading>
+    <content-block text="Sem Dados" [value]="!(items.length != 0 || loading)"></content-block>
+
+     <div class="size-full shrink relative overflow-y-auto">
+        <table>
+            <thead>
+                <tr>
+                    @if(acoesTemplate){
+                        <th scope="col" class="p-2"> 
+                            Ações 
+                        </th>
+                    }
+
+                    @for (tfa of lstTableFieldsAvailable(); track tfa.tf.index) {
+                        <th scope="col" class="p-2"> 
+                            <div class="flex gap-2 items-center justify-start th">
+                                @if(!noFilters()){
+                                    <th-filter class="!text-base" style="text-transform: none !important" 
+                                    *ngIf="((tfa.tf.type != InputType.File || (tfa.tf.filter && tfa.tf.disabledChange())) && !noFilters())"
+                                        [field]="tfa.tf"
+                                        (change)="ChangeFilter()"
+                                    ></th-filter>
+                                }
+
+                                {{tfa.tf.header}} 
+
+                                @if((tfa.tf.type != InputType.File || (tfa.tf.filter && tfa.tf.disabledChange())) && !noFilters()){
+                                    <a [ngClass]="{ 'bg-light/10 !opacity-100': tfa.ascending || tfa.descending }"
+                                        class="order h-4 w-5 relative cursor-pointer rounded-lg opacity-0 default-transition" 
+                                        (click)="SwitchOrder(tfa.tf)"
+                                    >
+                                        <ion-icon 
+                                            [class.text-primary]="tfa.ascending"
+                                            class="absolute left-0 top-0" 
+                                            name="arrow-up"
+                                        ></ion-icon> 
+                                        <ion-icon 
+                                            [class.text-primary]="tfa.descending"
+                                            class="absolute right-0 bottom-0" 
+                                            name="arrow-down"
+                                        ></ion-icon> 
+                                    </a>
+                                }
+                            </div>
+                        </th>
+                    }
+                </tr>
+            </thead>
+            <tbody>
+                @for (row of lstRows; track row.id || $index) {
+                    <tr [hidden]="loading()">
+                        @if(acoesTemplate){
+                            <td (click)="Redirect(undefined, row.item)" class="whitespace-nowrap py-1 px-3 {{row.acoesClass}}" [style]="row.acoesStyle" >
+                                <ng-container *ngTemplateOutlet="acoesTemplate; context: { $implicit: row.item }"></ng-container>
+                            </td>
+                        }
+
+                        @for (col of row.lstColumns; track col.tf.index) {
+                            <td class="{{col.class}} p-2 cursor-pointer" (click)="Redirect(col.tf, row.item)" [style]="'white-space: var(--ion-table-row-wrap);' + col.style">
+                                @if(col.tf.index == 'ativo') {
+                                    <div class="size-full flex items-center justify-start" [routerLink]="null">
+                                        <ion-toggle [checked]="col.value" [disabled]="loading()" (ionChange)="Ativar(row.id)" ></ion-toggle>
+                                    </div>
+                                }
+                                @else if (col.tf.type == InputType.Bool){
+                                    <div class="h-full flex items-center justify-start">
+                                        @if(col.tf.configuration.type == 'toggle') {
+                                            <ion-toggle [checked]="col.value" [disabled]="true"></ion-toggle>
+                                        }
+                                        @else {
+                                            <ion-checkbox [checked]="col.value" [disabled]="true"></ion-checkbox>
+                                        }
+                                    </div>
+                                }
+                                @else if (col.tf.type == InputType.File) {
+                                    <download-button [(ngModel)]="col.value" [configuration]="col.tf.configuration"></download-button>
+                                }
+                                @else if (col.loading){
+                                    <ion-spinner name="dots"></ion-spinner>
+                                } @else {
+                                    <span [ngClass]="col.class">{{ col.label }}</span>
+                                }
+                            </td>
+                        }
+                    </tr>
+                    <ng-content select="[slot=item-end]"></ng-content>
+                }
+            </tbody>
+        </table>
+     </div>
+     @if(!noPagination()){
+        <div class="shrink-0 z-[100]">
+            <default-pagination
+                [page]="page()"
+                (pageChange)="page.set($event); refresh.emit()"
+                [total]="total()"
+                [limit]="limit()"
+                [length]="items().length"
+                [loading]="loading()"
+            ></default-pagination>
+        </div>
+    }
+</div>