dts-backoffice-util 18.2.1 → 18.3.0

package/README.md

@@ -12,7 +12,7 @@ Segue abaixo as últimas versões da Biblioteca, conforme a versão do PO-UI e A
 
 | PO-UI | Angular | Versão dtsBackofficeUtil |
 |-|-|-|
-| v18 | v18 | 18.2.1 |
+| v18 | v18 | 18.3.0 |
 | v17 | v17 | 17.1.0 |
 | v16 | v16 | 16.1.0 |
 | v15 | v15 | 15.4.1 |
@@ -29,7 +29,7 @@ Segue abaixo as últimas versões da Biblioteca, conforme a versão do PO-UI e A
 
 **Instalação do Pacote:**
 
-```
+```cmd
 npm install dts-backoffice-util
 ```
 
@@ -177,7 +177,7 @@ private loadLocalStorage(): void {
 }
 ```
 **Definições no Progress:**
-```
+```ts
 DEFINE TEMP-TABLE tt-param NO-UNDO
   FIELD destino AS INTEGER
   FIELD arquivo AS CHARACTER
@@ -235,8 +235,8 @@ IScheduleParameters
 
 | Nome | Tipo | Obrigatório | Descrição |
 |-|-|-|-|
-| enabledStates | string[] | Não | Parâmetro que recebe uma lista de siglas de estados que devem ser habilitados no mapa, aqueles não que forem informados serão desabilitado. Se este parâmetro não for informado, todos os estados ficaram habilitados.<br>**Observações:**<br>- Para o correto funcionamento, a variável informada no parâmetro, deve ser atualizada depois da inicialização da tela (ngOnInit);<br>- Sempre que o conteúdo da variável informada neste parâmetro for alterado, o mapa será atualizado automaticamente com o novo valor.
-| initialSelectedState | string | Não | Parâmetro para fornecer um estado a ser selecionado no mapa.<br>**Observações:**<br>- Para o correto funcionamento, a variável informada no parâmetro, deve ser atualizada depois da inicialização da tela (ngOnInit);<br>- Sempre que o conteúdo da variável informada neste parâmetro for alterado, o mapa será atualizado automaticamente com o novo valor.
+| enabledStates | string[] | Não | Parâmetro que recebe uma lista de siglas de estados que devem ser habilitados no mapa, aqueles não que forem informados serão desabilitado. Se este parâmetro não for informado, todos os estados ficaram habilitados.<br>Se o parâmetro receber uma variável, sempre que o conteúdo dela for alterado, o mapa será atualizado automaticamente com o novo valor.
+| initialSelectedState | string | Não | Parâmetro para fornecer um estado a ser selecionado no mapa.<br>Se o parâmetro receber uma variável, sempre que o conteúdo dela for alterado, o mapa será atualizado automaticamente com o novo valor.
 | selectedStateEvent | EventEmitter | Sim | Evento disparado ao selecionar um estado do mapa.<br>**Parâmetros:**<br>- State: Responsável por receber do componente o estado selecionado. |
 ---
 **Exemplo de Uso:**
@@ -248,7 +248,7 @@ Para a utilização, basta chamar o componente no .HTML e fazer a definição no
 // EXEMPLO 
 <app-totvs-map
    [enabledStates]="enabledStates"
-   initialSelectedState="SC"
+   [initialSelectedState]="initialSelectedState"
    (selectedStateEvent)="selectedState($event)">
 </app-totvs-map>
 ```
@@ -256,11 +256,25 @@ Para a utilização, basta chamar o componente no .HTML e fazer a definição no
 **Definições no JavaScript:**
 ```ts
 state: string;
-enabledStates: string[] = ["SC", "RJ", "PR", "SP"];
+enabledStates: string[];
+initialSelectedState: string;
 
-selectedState(state: string) {
-   this.state = state;
+searchTax(): void {
+    this.servTaxSubscription$ = this.servTax
+        .getTax()
+        .subscribe((response: ITotalTax) => {
+
+        if (response) {
+            ...
+            this.enabledStates = response.listStates;
+            this.initialSelectedState = response.listStates[0];
+        }
+    });
 }
+
+selectedState(state: string) {
+  this.state = state;
+}    
 ```
 
 **Alterando as cores do mapa:**
@@ -268,42 +282,68 @@ selectedState(state: string) {
 O mapa já possui as cores da TOTVS como padrão. Mas caso seja necessário alterar alguma cor, deve-se utilizar o código abaixo dentro do styles.css do projeto, alterando os valores.
 
 ```css
-//Muda a cor de fundo do mapa todo
-#svg-map path {
+/* Cor padrão de um estado não selecionado */
+.defaultState {
     fill: #0c6c94;
 }
 
-//Muda a cor do texto
-#svg-map text {
-    fill: #fff;
-    font: 12px Arial-BoldMT, sans-serif;
-    cursor: pointer
+/* Cor padrão de um estado não selecionado, quando passar o mouse em cima*/
+.defaultState:hover {
+    fill: #29b5c4;
+    cursor: pointer;
 }
 
-#svg-map a {
-    text-decoration: none
+/* Cor padrão de um estado pequeno (DF, ES, RJ) não selecionado */
+.defaultStateCircle {
+    fill: #0c6c94;
 }
 
-#svg-map a:hover {
+/* Cor padrão de um estado pequeno (DF, ES, RJ) não selecionado, quando passar o mouse em cima */
+.defaultStateCircle:hover {
+    fill: #29b5c4;
     cursor: pointer;
-    text-decoration: none
 }
 
-//Muda a cor do estado quando passar o mouse em cima
-#svg-map a:hover path {
-    fill: #29b5c4 !important;
+/* Cor padrão de um estado desabilitado */
+.disabledState {
+    fill: grey !important;
 }
 
-//Muda a cor dos círculos para pequenos estados
-#svg-map .circle {
+/* Cor padrão de um estado selecionado */
+.selectedState {
     fill: #29b5c4;
 }
 
-//Muda a cor dos círculos para pequenos estados quando passa o mouse em cima
-#svg-map a:hover .circle {
-    fill: #4c8d94 !important;
+/* Cor padrão de um estado pequeno (DF, ES, RJ) selecionado */
+.selectedStateCircle {
+    fill: #29b5c4;
+}
+
+.disableEvents {
+    pointer-events: none;
+}
+
+/* Cor e fonte padrão do nome dos estados */
+.text {
+    fill: #fff;
+    font: 12px Arial-BoldMT, sans-serif;
     cursor: pointer
 }
+
+/* Padrão do estado como um todo - estado + texto (que seria a tag <a>) */
+.stateWithText {
+    text-decoration: none
+}
+
+.stateWithText:hover {
+    cursor: pointer;
+    text-decoration: none;
+}
+
+/* Cor padrão ao passar o mouse em cima do estado como um todo - estado + texto */
+.stateWithText:hover .defaultState, .stateWithText:hover .defaultStateCircle {
+    fill: #29b5c4;
+}
 ```
 
 # Pipes
@@ -770,7 +810,7 @@ followUpCallBack(execStatus: IExecutionStatus): boolean {
 }
 ```
 **Definições no Progress:**
-```
+```ts
 DEFINE TEMP-TABLE tt-param NO-UNDO
   FIELD destino AS INTEGER
   FIELD arquivo AS CHARACTER
@@ -1047,7 +1087,7 @@ getQrCode(text: string): Observable<Blob> {
 }
 ```
 **Definições no Progress:**
-```
+```ts
 // Conteúdo do Método que BackEnd que retorna o Arquivo em Base64
 DEFINE VARIABLE v_dir_arq AS CHARACTER NO-UNDO.
 DEFINE VARIABLE v_cod_arq AS CHARACTER NO-UNDO.