@po-ui/ng-components 20.6.0 → 20.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/fesm2022/po-ui-ng-components.mjs +3395 -2696
  2. package/fesm2022/po-ui-ng-components.mjs.map +1 -1
  3. package/index.d.ts +432 -320
  4. package/lib/components/po-breadcrumb/po-breadcrumb-base.component.d.ts +15 -0
  5. package/lib/components/po-chart/interfaces/po-chart-serie.interface.d.ts +3 -2
  6. package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts +10 -5
  7. package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts +2 -2
  8. package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts +15 -0
  9. package/lib/components/po-field/po-checkbox/po-checkbox-base.component.d.ts +6 -8
  10. package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts +3 -12
  11. package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts +6 -8
  12. package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts +7 -12
  13. package/lib/components/po-field/po-combo/po-combo-base.component.d.ts +6 -8
  14. package/lib/components/po-field/po-combo/po-combo.component.d.ts +5 -12
  15. package/lib/components/po-field/po-datepicker/po-datepicker-base.component.d.ts +5 -7
  16. package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts +7 -14
  17. package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts +5 -7
  18. package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts +4 -12
  19. package/lib/components/po-field/po-decimal/po-decimal.component.d.ts +3 -4
  20. package/lib/components/po-field/po-email/po-email.component.d.ts +3 -3
  21. package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts +2 -0
  22. package/lib/components/po-field/po-field-container/po-field-container.component.d.ts +2 -0
  23. package/lib/components/po-field/po-field.model.d.ts +7 -16
  24. package/lib/components/po-field/po-input/po-input-base.component.d.ts +12 -19
  25. package/lib/components/po-field/po-input/po-input.component.d.ts +3 -3
  26. package/lib/components/po-field/po-input-generic/po-input-generic.d.ts +0 -2
  27. package/lib/components/po-field/po-login/po-login.component.d.ts +3 -1
  28. package/lib/components/po-field/po-lookup/po-lookup-base.component.d.ts +6 -8
  29. package/lib/components/po-field/po-lookup/po-lookup-modal/po-lookup-modal.component.d.ts +1 -1
  30. package/lib/components/po-field/po-lookup/po-lookup.component.d.ts +8 -14
  31. package/lib/components/po-field/po-multiselect/po-multiselect-base.component.d.ts +6 -8
  32. package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts +4 -12
  33. package/lib/components/po-field/po-number/po-number.component.d.ts +3 -2
  34. package/lib/components/po-field/po-password/po-password.component.d.ts +3 -1
  35. package/lib/components/po-field/po-radio/po-radio.component.d.ts +9 -0
  36. package/lib/components/po-field/po-radio-group/po-radio-group-base.component.d.ts +6 -8
  37. package/lib/components/po-field/po-radio-group/po-radio-group.component.d.ts +7 -12
  38. package/lib/components/po-field/po-rich-text/po-rich-text-base.component.d.ts +6 -8
  39. package/lib/components/po-field/po-rich-text/po-rich-text-body/po-rich-text-body.component.d.ts +1 -2
  40. package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts +4 -10
  41. package/lib/components/po-field/po-select/po-select.component.d.ts +7 -14
  42. package/lib/components/po-field/po-switch/po-switch.component.d.ts +33 -6
  43. package/lib/components/po-field/po-textarea/po-textarea-base.component.d.ts +6 -8
  44. package/lib/components/po-field/po-textarea/po-textarea.component.d.ts +7 -12
  45. package/lib/components/po-field/po-upload/po-upload-base.component.d.ts +6 -8
  46. package/lib/components/po-field/po-upload/po-upload.component.d.ts +5 -11
  47. package/lib/components/po-field/po-url/po-url.component.d.ts +3 -2
  48. package/lib/components/po-helper/po-helper-base.component.d.ts +11 -0
  49. package/lib/components/po-helper/po-helper.component.d.ts +1 -0
  50. package/lib/components/po-info/po-info-base.component.d.ts +15 -0
  51. package/lib/components/po-loading/po-loading-base.component.d.ts +7 -4
  52. package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts +9 -8
  53. package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts +14 -0
  54. package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts +14 -0
  55. package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts +2 -0
  56. package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts +14 -0
  57. package/lib/components/po-popover/po-popover-base.component.d.ts +12 -0
  58. package/lib/components/po-popover/po-popover.component.d.ts +11 -0
  59. package/lib/components/po-search/po-search-base.component.d.ts +16 -0
  60. package/lib/components/po-search/po-search.component.d.ts +1 -1
  61. package/lib/components/po-table/enums/po-table-spacing.enum.d.ts +1 -1
  62. package/lib/components/po-tag/po-tag-base.component.d.ts +1 -0
  63. package/lib/enums/po-density-mode.enum.d.ts +14 -0
  64. package/lib/enums/po-field-size.enum.d.ts +5 -3
  65. package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts +12 -0
  66. package/lib/services/po-theme/po-theme.module.d.ts +1 -1
  67. package/lib/services/po-theme/po-theme.service.d.ts +39 -11
  68. package/lib/utils/util.d.ts +9 -2
  69. package/package.json +4 -4
  70. package/po-ui-ng-components-20.7.0.tgz +0 -0
  71. package/schematics/ng-add/index.js +1 -1
  72. package/schematics/ng-update/v14/index.js +1 -1
  73. package/schematics/ng-update/v15/index.js +1 -1
  74. package/schematics/ng-update/v16/index.js +1 -1
  75. package/schematics/ng-update/v17/index.js +1 -1
  76. package/schematics/ng-update/v18/index.js +2 -2
  77. package/schematics/ng-update/v19/index.js +2 -2
  78. package/schematics/ng-update/v2/index.js +1 -1
  79. package/schematics/ng-update/v20/index.js +2 -2
  80. package/schematics/ng-update/v3/index.js +1 -1
  81. package/schematics/ng-update/v4/index.js +1 -1
  82. package/schematics/ng-update/v5/index.js +1 -1
  83. package/schematics/ng-update/v6/index.js +1 -1
  84. package/po-ui-ng-components-20.6.0.tgz +0 -0
@@ -21,8 +21,7 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
21
21
  * @optional
22
22
  *
23
23
  * @description
24
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
25
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
24
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
26
25
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
27
26
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
28
27
  *
@@ -34,11 +33,11 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
34
33
  *
35
34
  * @description
36
35
  *
37
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
36
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
38
37
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
39
38
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
40
39
  *
41
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
40
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
42
41
  *
43
42
  * @default `false`
44
43
  */
@@ -147,10 +146,10 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
147
146
  *
148
147
  * @description
149
148
  *
150
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
149
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
150
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
151
151
  *
152
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
153
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
152
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
154
153
  */
155
154
  poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
156
155
  /**
@@ -175,7 +174,6 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
175
174
  *
176
175
  * @description
177
176
  * Evento disparado ao clicar no ícone de ajuda adicional.
178
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
179
177
  *
180
178
  * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
181
179
  */
@@ -7,12 +7,11 @@ export declare class PoRichTextBodyComponent implements OnInit, OnDestroy {
7
7
  modelValue?: string;
8
8
  placeholder?: string;
9
9
  readonly?: string;
10
- /** Tamanho do fonte */
11
- size?: string;
12
10
  change: EventEmitter<any>;
13
11
  commands: EventEmitter<any>;
14
12
  keydown: EventEmitter<KeyboardEvent>;
15
13
  selectedLink: EventEmitter<any>;
14
+ size: string;
16
15
  shortcutCommand: EventEmitter<any>;
17
16
  value: EventEmitter<any>;
18
17
  blur: EventEmitter<any>;
@@ -3,6 +3,7 @@ import { PoRichTextToolbarActions } from './enum/po-rich-text-toolbar-actions.en
3
3
  import { PoRichTextBaseComponent } from './po-rich-text-base.component';
4
4
  import { PoRichTextBodyComponent } from './po-rich-text-body/po-rich-text-body.component';
5
5
  import { PoRichTextToolbarComponent } from './po-rich-text-toolbar/po-rich-text-toolbar.component';
6
+ import { PoHelperComponent } from '../../po-helper';
6
7
  /**
7
8
  * @docsExtends PoRichTextBaseComponent
8
9
  *
@@ -28,6 +29,7 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
28
29
  private element;
29
30
  bodyElement: PoRichTextBodyComponent;
30
31
  richTextToolbar: PoRichTextToolbarComponent;
32
+ helperEl?: PoHelperComponent;
31
33
  private listener;
32
34
  private modelLastUpdate;
33
35
  toolbarActions: Array<PoRichTextToolbarActions>;
@@ -59,20 +61,12 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
59
61
  onChangeValue(value: any): void;
60
62
  onKeyDown(event: KeyboardEvent): void;
61
63
  /**
62
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
64
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
63
65
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
64
66
  *
65
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
67
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
66
68
  *
67
69
  * ```
68
- * <po-rich-text
69
- * #richtext
70
- * ...
71
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
72
- * (p-keydown)="onKeyDown($event, richtext)"
73
- * ></po-rich-text>
74
- * ```
75
- * ```
76
70
  * // Exemplo com p-label e p-helper
77
71
  * <po-rich-text
78
72
  * #richtext
@@ -3,7 +3,7 @@ import { AbstractControl } from '@angular/forms';
3
3
  import { PoFieldValidateModel } from '../po-field-validate.model';
4
4
  import { PoSelectOptionGroup } from './po-select-option-group.interface';
5
5
  import { PoSelectOption } from './po-select-option.interface';
6
- import { PoHelperOptions } from '../../po-helper';
6
+ import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
7
7
  /**
8
8
  * @docsExtends PoFieldValidateModel
9
9
  *
@@ -77,6 +77,7 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
77
77
  renderer: Renderer2;
78
78
  private _iconToken;
79
79
  selectElement: ElementRef;
80
+ helperEl?: PoHelperComponent;
80
81
  /**
81
82
  * @optional
82
83
  *
@@ -213,10 +214,10 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
213
214
  *
214
215
  * @description
215
216
  *
216
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
217
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
218
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
217
219
  *
218
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
219
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
220
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
220
221
  */
221
222
  poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
222
223
  /**
@@ -268,19 +269,11 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
268
269
  onKeyDown(event: KeyboardEvent): void;
269
270
  registerOnTouched(fn: any): void;
270
271
  /**
271
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
272
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
272
273
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
273
274
  *
274
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
275
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
275
276
  *
276
- * ```html
277
- * <po-select
278
- * #select
279
- * ...
280
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
281
- * (p-keydown)="onKeyDown($event, select)"
282
- * ></po-select>
283
- * ```
284
277
  * ```
285
278
  * //Exemplo com p-label e p-helper
286
279
  * <po-select
@@ -1,8 +1,8 @@
1
- import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
1
+ import { AfterViewInit, ElementRef, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
2
2
  import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
3
3
  import { PoFieldModel } from '../po-field.model';
4
4
  import { PoSwitchLabelPosition } from './po-switch-label-position.enum';
5
- import { PoHelperOptions } from '../../po-helper';
5
+ import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
6
6
  /**
7
7
  * @docsExtends PoFieldModel
8
8
  *
@@ -76,10 +76,11 @@ import { PoHelperOptions } from '../../po-helper';
76
76
  * <file name="sample-po-switch-order-reactive-form/sample-po-switch-order-reactive-form.component.ts"> </file>
77
77
  * </example>
78
78
  */
79
- export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy {
79
+ export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy, OnChanges {
80
80
  private readonly changeDetector;
81
81
  private readonly injector;
82
82
  switchContainer: ElementRef;
83
+ helperEl?: PoHelperComponent;
83
84
  id: string;
84
85
  value: boolean;
85
86
  private _labelOff;
@@ -196,10 +197,10 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
196
197
  *
197
198
  * @description
198
199
  *
199
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
200
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
201
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
200
202
  *
201
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
202
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
203
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
203
204
  */
204
205
  poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
205
206
  /**
@@ -218,6 +219,7 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
218
219
  private readonly el;
219
220
  private readonly injectOptions;
220
221
  private control;
222
+ ngOnChanges(changes: SimpleChanges): void;
221
223
  ngOnDestroy(): void;
222
224
  /**
223
225
  * Função que atribui foco ao componente.
@@ -252,4 +254,29 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
252
254
  hideAdditionalHelp: boolean;
253
255
  helperSettings?: any;
254
256
  };
257
+ /**
258
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
259
+ * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
260
+ *
261
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
262
+ *
263
+ * ```
264
+ * //Exemplo com p-label e p-helper
265
+ * <po-switch
266
+ * #switch
267
+ * ...
268
+ * p-label="Label do switch"
269
+ * [p-helper]="helperOptions"
270
+ * (p-keydown)="onKeyDown($event, switch)"
271
+ * ></po-switch>
272
+ * ```
273
+ * ```typescript
274
+ * onKeyDown(event: KeyboardEvent, inp: PoSwitchComponent): void {
275
+ * if (event.code === 'F9') {
276
+ * inp.showAdditionalHelp();
277
+ * }
278
+ * }
279
+ * ```
280
+ */
281
+ showAdditionalHelp(): boolean;
255
282
  }
@@ -55,8 +55,7 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
55
55
  * @optional
56
56
  *
57
57
  * @description
58
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
59
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
58
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
60
59
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
61
60
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
62
61
  *
@@ -68,11 +67,11 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
68
67
  *
69
68
  * @description
70
69
  *
71
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
70
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
72
71
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
73
72
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
74
73
  *
75
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
74
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
76
75
  *
77
76
  * @default `false`
78
77
  */
@@ -140,10 +139,10 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
140
139
  *
141
140
  * @description
142
141
  *
143
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
142
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
143
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
144
144
  *
145
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
146
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
145
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
147
146
  */
148
147
  poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
149
148
  /**
@@ -168,7 +167,6 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
168
167
  *
169
168
  * @description
170
169
  * Evento disparado ao clicar no ícone de ajuda adicional.
171
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
172
170
  *
173
171
  * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
174
172
  */
@@ -1,5 +1,6 @@
1
- import { AfterViewInit, ElementRef } from '@angular/core';
1
+ import { AfterViewInit, ElementRef, OnChanges, SimpleChanges } from '@angular/core';
2
2
  import { PoTextareaBaseComponent } from './po-textarea-base.component';
3
+ import { PoHelperComponent } from '../../po-helper';
3
4
  /**
4
5
  * @docsExtends PoTextareaBaseComponent
5
6
  *
@@ -26,9 +27,10 @@ import { PoTextareaBaseComponent } from './po-textarea-base.component';
26
27
  * </example>
27
28
  *
28
29
  */
29
- export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
30
+ export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
30
31
  private el;
31
32
  inputEl: ElementRef;
33
+ helperEl?: PoHelperComponent;
32
34
  id: string;
33
35
  valueBeforeChange: any;
34
36
  fireChange: boolean;
@@ -53,6 +55,7 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
53
55
  */
54
56
  focus(): void;
55
57
  ngAfterViewInit(): void;
58
+ ngOnChanges(changes: SimpleChanges): void;
56
59
  getAdditionalHelpTooltip(): string;
57
60
  getErrorPattern(): string;
58
61
  hasInvalidClass(): boolean;
@@ -64,20 +67,12 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
64
67
  controlChangeEmitter(): void;
65
68
  onKeyDown(event: KeyboardEvent): void;
66
69
  /**
67
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
70
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
68
71
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
69
72
  *
70
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
73
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
71
74
  *
72
75
  * ```
73
- * <po-textarea
74
- * #textarea
75
- * ...
76
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
77
- * (p-keydown)="onKeyDown($event, textarea)"
78
- * ></po-textarea>
79
- * ```
80
- * ```
81
76
  * //Exemplo com p-label e p-helper
82
77
  * <po-textarea
83
78
  * #textarea
@@ -77,8 +77,7 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
77
77
  * @optional
78
78
  *
79
79
  * @description
80
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
81
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
80
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
82
81
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
83
82
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
84
83
  *
@@ -90,11 +89,11 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
90
89
  *
91
90
  * @description
92
91
  *
93
- * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
92
+ * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
94
93
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
95
94
  * posicionamento correto do tooltip próximo ao elemento.
96
95
  *
97
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
96
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
98
97
  *
99
98
  * @default `false`
100
99
  */
@@ -207,10 +206,10 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
207
206
  *
208
207
  * @description
209
208
  *
210
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
209
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
210
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
211
211
  *
212
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
213
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
212
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
214
213
  */
215
214
  poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
216
215
  /**
@@ -235,7 +234,6 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
235
234
  *
236
235
  * @description
237
236
  * Evento disparado ao clicar no ícone de ajuda adicional.
238
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
239
237
  *
240
238
  * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
241
239
  */
@@ -5,6 +5,7 @@ import { PoModalAction, PoModalComponent } from '../../po-modal';
5
5
  import { PoUploadBaseComponent } from './po-upload-base.component';
6
6
  import { PoUploadFile } from './po-upload-file';
7
7
  import { PoUploadStatus } from './po-upload-status.enum';
8
+ import { PoHelperComponent } from '../../po-helper';
8
9
  /**
9
10
  * @docsExtends PoUploadBaseComponent
10
11
  *
@@ -48,6 +49,7 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
48
49
  private poUploadDragDropComponent;
49
50
  uploadButton: PoButtonComponent;
50
51
  modalComponent: PoModalComponent;
52
+ helperEl?: PoHelperComponent;
51
53
  id: string;
52
54
  infoByUploadStatus: {
53
55
  [key: string]: {
@@ -102,7 +104,6 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
102
104
  getAdditionalHelpTooltip(): string;
103
105
  hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
104
106
  isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
105
- onBlur(): void;
106
107
  onFileChange(event: any): void;
107
108
  onFileChangeDragDrop(files: any): void;
108
109
  onKeyDown(event: KeyboardEvent): void;
@@ -119,18 +120,11 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
119
120
  sendFiles(): void;
120
121
  setDirectoryAttribute(canHandleDirectory: boolean): void;
121
122
  /**
122
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
123
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
123
124
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
124
125
  *
125
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
126
- * ```
127
- * <po-upload
128
- * #upload
129
- * ...
130
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
131
- * (p-keydown)="onKeyDown($event, upload)"
132
- * ></po-upload>
133
- * ```
126
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
127
+ *
134
128
  * ```
135
129
  * //Exemplo com p-label e p-helper
136
130
  * <po-upload
@@ -1,4 +1,4 @@
1
- import { AfterViewInit, OnDestroy } from '@angular/core';
1
+ import { AfterViewInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
2
2
  import { AbstractControl } from '@angular/forms';
3
3
  import { PoInputGeneric } from '../po-input-generic/po-input-generic';
4
4
  /**
@@ -26,7 +26,7 @@ import { PoInputGeneric } from '../po-input-generic/po-input-generic';
26
26
  * </example>
27
27
  *
28
28
  */
29
- export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
29
+ export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
30
30
  id: string;
31
31
  icon: string;
32
32
  type: string;
@@ -36,6 +36,7 @@ export declare class PoUrlComponent extends PoInputGeneric implements AfterViewI
36
36
  constructor();
37
37
  ngAfterViewInit(): void;
38
38
  ngOnDestroy(): void;
39
+ ngOnChanges(changes: SimpleChanges): void;
39
40
  extraValidation(c: AbstractControl): {
40
41
  [key: string]: any;
41
42
  };
@@ -105,5 +105,16 @@ export declare class PoHelperBaseComponent {
105
105
  * @default `false`
106
106
  */
107
107
  disabled: import("@angular/core").InputSignal<boolean>;
108
+ /**
109
+ * @Input
110
+ *
111
+ * @optional
112
+ *
113
+ * @description
114
+ * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
115
+ * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
116
+ * correto do conteúdo próximo ao elemento.
117
+ */
118
+ appendBox: import("@angular/core").InputSignal<boolean>;
108
119
  private transformHelper;
109
120
  }
@@ -40,6 +40,7 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
40
40
  ngOnChanges(changes: SimpleChanges): void;
41
41
  ngOnDestroy(): void;
42
42
  openHelperPopover(): void;
43
+ helperIsVisible(): boolean;
43
44
  closeHelperPopover(): void;
44
45
  emitClick(event: MouseEvent): void;
45
46
  onKeyDown(event: KeyboardEvent): void;
@@ -15,6 +15,7 @@ export declare class PoInfoBaseComponent {
15
15
  readonly poInfoOrientation: typeof PoInfoOrientation;
16
16
  private _labelSize;
17
17
  private _orientation;
18
+ private _size?;
18
19
  /**
19
20
  * @optional
20
21
  *
@@ -43,4 +44,18 @@ export declare class PoInfoBaseComponent {
43
44
  */
44
45
  set orientation(value: PoInfoOrientation);
45
46
  get orientation(): PoInfoOrientation;
47
+ /**
48
+ * @optional
49
+ *
50
+ * @description
51
+ *
52
+ * Define o tamanho do componente entre `small` ou `medium`.
53
+ *
54
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
55
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
56
+ *
57
+ * @default `medium`
58
+ */
59
+ set size(value: string);
60
+ get size(): string;
46
61
  }
@@ -15,7 +15,7 @@ export declare const poLoadingLiteralsDefault: {
15
15
  * ou aguardando a resposta de alguma requisição.
16
16
  */
17
17
  export declare class PoLoadingBaseComponent {
18
- private languageService;
18
+ protected languageService: PoLanguageService;
19
19
  private _text?;
20
20
  private _size?;
21
21
  /**
@@ -25,14 +25,17 @@ export declare class PoLoadingBaseComponent {
25
25
  get text(): string;
26
26
  /**
27
27
  * Define o tamanho do ícone.
28
- *
29
- * @default `lg`
30
- *
31
28
  * Valores válidos:
32
29
  * - `xs`: 16px
33
30
  * - `sm`: 24px
34
31
  * - `md`: 32px
35
32
  * - `lg`: 80px
33
+ *
34
+ * > Em nível de acessibilidade **AA**, caso o valor de `p-size` não seja definido, o valor padrão será `sm`
35
+ * > quando o valor padrão dos componentes for configurado como `small` no
36
+ * > [serviço de tema](https://po-ui.io/documentation/po-theme).
37
+ *
38
+ * @default `lg`
36
39
  */
37
40
  set size(value: string);
38
41
  get size(): string;
@@ -18,14 +18,15 @@ export declare const poPageDefaultLiteralsDefault: {
18
18
  *
19
19
  * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
20
20
  *
21
- * | Propriedade | Descrição | Valor Padrão |
22
- * |----------------------------------------|-------------------------------------------------------|-------------------------------------------------|
23
- * | **Default Values** | | |
24
- * | `--padding` | Espaçamento do componente | `var(--spacing-xs) var(--spacing-md)` |
25
- * | `--gap` | Gap entre o header e o conteúdo | `var(--spacing-md)` |
26
- * | `--padding-top-header` | Espaçamento do topo do header | `var(--color-neutral-light-30)` |
27
- * | `--gap-actions` | Gap entre os botões de action | `var(--spacing-xs)` |
28
- * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
21
+ * | Propriedade | Descrição | Valor Padrão |
22
+ * |---------------------|---------------------------------------------|---------------------------------------|
23
+ * | **Header** | | |
24
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
25
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
27
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
28
+ * | **Content** | | |
29
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
29
30
  */
30
31
  export declare abstract class PoPageDefaultBaseComponent {
31
32
  poPageContent: PoPageContentComponent;
@@ -14,6 +14,20 @@ export declare const poPageDetailLiteralsDefault: {
14
14
  *
15
15
  * O componente **po-page-detail** é utilizado como container principal para a tela de
16
16
  * detalhamento de um registro, tendo a possibilidade de usar as ações de "Voltar", "Editar" e "Remover".
17
+ *
18
+ * #### Tokens customizáveis
19
+ *
20
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
21
+ *
22
+ * | Propriedade | Descrição | Valor Padrão |
23
+ * |---------------------|---------------------------------------------|---------------------------------------|
24
+ * | **Header** | | |
25
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
27
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
28
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
29
+ * | **Content** | | |
30
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
17
31
  */
18
32
  export declare class PoPageDetailBaseComponent {
19
33
  poPageContent: PoPageContentComponent;
@@ -18,6 +18,20 @@ export declare const poPageEditLiteralsDefault: {
18
18
  * Os botões "Salvar" e "Salvar e Novo" podem ser habilitados/desabilitados utilizando a propriedade `p-disable-submit`.
19
19
  * Esta propriedade pode ser utilizada para desabilitar os botões caso exista um formulário inválido na página ou alguma
20
20
  * regra de negócio não tenha sido atendida.
21
+ *
22
+ * #### Tokens customizáveis
23
+ *
24
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
25
+ *
26
+ * | Propriedade | Descrição | Valor Padrão |
27
+ * |---------------------|---------------------------------------------|---------------------------------------|
28
+ * | **Header** | | |
29
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
30
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
31
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
32
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
33
+ * | **Content** | | |
34
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
21
35
  */
22
36
  export declare class PoPageEditBaseComponent {
23
37
  poPageContent: PoPageContentComponent;
@@ -10,6 +10,8 @@ import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
10
10
  export declare class PoPageHeaderBaseComponent {
11
11
  /** Título da página. */
12
12
  title: string;
13
+ /** Define o tamanho dos componentes no header. */
14
+ size: string;
13
15
  /** Subtítulo da página. */
14
16
  subtitle: string;
15
17
  private _breadcrumb;
@@ -23,6 +23,20 @@ export declare const poPageListLiteralsDefault: {
23
23
  *
24
24
  * Para facilitar a manipulação e visualização dos filtros aplicados, é possível também utilizar o componente
25
25
  * [`po-disclaimer-group`](/documentation/po-disclaimer-group).
26
+ *
27
+ * #### Tokens customizáveis
28
+ *
29
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
30
+ *
31
+ * | Propriedade | Descrição | Valor Padrão |
32
+ * |---------------------|---------------------------------------------|---------------------------------------|
33
+ * | **Header** | | |
34
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
35
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
36
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
37
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
38
+ * | **Content** | | |
39
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26
40
  */
27
41
  export declare abstract class PoPageListBaseComponent {
28
42
  poPageContent: PoPageContentComponent;
@@ -140,4 +140,16 @@ export declare class PoPopoverBaseComponent {
140
140
  */
141
141
  set trigger(value: string);
142
142
  get trigger(): string;
143
+ /**
144
+ * @Input
145
+ *
146
+ * @optional
147
+ *
148
+ * @description
149
+ * Permite a inclusão de classes CSS customizadas ao componente.
150
+ *
151
+ * Exemplo: `p-custom-classes="minha-classe-1 minha-classe-2"`.
152
+ *
153
+ */
154
+ customClasses: import("@angular/core").InputSignal<string>;
143
155
  }