@po-ui/ng-components 20.6.0 → 20.8.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 (95) hide show
  1. package/fesm2022/po-ui-ng-components.mjs +3523 -2688
  2. package/fesm2022/po-ui-ng-components.mjs.map +1 -1
  3. package/index.d.ts +636 -452
  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-dropdown/po-dropdown-action.interface.d.ts +10 -0
  7. package/lib/components/po-dropdown/po-dropdown.component.d.ts +5 -0
  8. package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts +10 -5
  9. package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts +2 -2
  10. package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts +15 -0
  11. package/lib/components/po-field/po-checkbox/po-checkbox-base.component.d.ts +6 -8
  12. package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts +3 -12
  13. package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts +6 -8
  14. package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts +7 -12
  15. package/lib/components/po-field/po-combo/po-combo-base.component.d.ts +6 -8
  16. package/lib/components/po-field/po-combo/po-combo.component.d.ts +5 -12
  17. package/lib/components/po-field/po-datepicker/po-datepicker-base.component.d.ts +5 -7
  18. package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts +7 -14
  19. package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts +5 -7
  20. package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts +4 -12
  21. package/lib/components/po-field/po-decimal/po-decimal.component.d.ts +3 -4
  22. package/lib/components/po-field/po-email/po-email.component.d.ts +3 -3
  23. package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts +2 -0
  24. package/lib/components/po-field/po-field-container/po-field-container.component.d.ts +2 -0
  25. package/lib/components/po-field/po-field.model.d.ts +7 -16
  26. package/lib/components/po-field/po-input/po-input-base.component.d.ts +12 -19
  27. package/lib/components/po-field/po-input/po-input.component.d.ts +3 -3
  28. package/lib/components/po-field/po-input-generic/po-input-generic.d.ts +0 -2
  29. package/lib/components/po-field/po-login/po-login.component.d.ts +3 -1
  30. package/lib/components/po-field/po-lookup/po-lookup-base.component.d.ts +6 -8
  31. package/lib/components/po-field/po-lookup/po-lookup-modal/po-lookup-modal.component.d.ts +1 -1
  32. package/lib/components/po-field/po-lookup/po-lookup.component.d.ts +8 -14
  33. package/lib/components/po-field/po-multiselect/po-multiselect-base.component.d.ts +6 -8
  34. package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts +4 -12
  35. package/lib/components/po-field/po-number/po-number.component.d.ts +3 -2
  36. package/lib/components/po-field/po-password/po-password.component.d.ts +3 -1
  37. package/lib/components/po-field/po-radio/po-radio.component.d.ts +9 -0
  38. package/lib/components/po-field/po-radio-group/po-radio-group-base.component.d.ts +6 -8
  39. package/lib/components/po-field/po-radio-group/po-radio-group.component.d.ts +7 -12
  40. package/lib/components/po-field/po-rich-text/po-rich-text-base.component.d.ts +6 -8
  41. package/lib/components/po-field/po-rich-text/po-rich-text-body/po-rich-text-body.component.d.ts +1 -2
  42. package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts +4 -10
  43. package/lib/components/po-field/po-select/po-select.component.d.ts +7 -14
  44. package/lib/components/po-field/po-switch/po-switch.component.d.ts +33 -6
  45. package/lib/components/po-field/po-textarea/po-textarea-base.component.d.ts +6 -8
  46. package/lib/components/po-field/po-textarea/po-textarea.component.d.ts +7 -12
  47. package/lib/components/po-field/po-upload/po-upload-base.component.d.ts +6 -8
  48. package/lib/components/po-field/po-upload/po-upload.component.d.ts +5 -11
  49. package/lib/components/po-field/po-url/po-url.component.d.ts +3 -2
  50. package/lib/components/po-helper/po-helper-base.component.d.ts +11 -0
  51. package/lib/components/po-helper/po-helper.component.d.ts +1 -0
  52. package/lib/components/po-info/po-info-base.component.d.ts +15 -0
  53. package/lib/components/po-listbox/interfaces/po-listbox-literals.interface.d.ts +2 -0
  54. package/lib/components/po-listbox/po-item-list/po-item-list-base.component.d.ts +1 -0
  55. package/lib/components/po-listbox/po-listbox-base.component.d.ts +8 -7
  56. package/lib/components/po-listbox/po-listbox.component.d.ts +14 -3
  57. package/lib/components/po-loading/po-loading-base.component.d.ts +7 -4
  58. package/lib/components/po-page/interfaces/po-page-action.interface.d.ts +6 -5
  59. package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts +9 -8
  60. package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts +14 -0
  61. package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts +14 -0
  62. package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts +2 -0
  63. package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts +14 -0
  64. package/lib/components/po-popover/po-popover-base.component.d.ts +12 -0
  65. package/lib/components/po-popover/po-popover.component.d.ts +11 -0
  66. package/lib/components/po-popup/po-popup-action.interface.d.ts +36 -4
  67. package/lib/components/po-popup/po-popup-base.component.d.ts +1 -0
  68. package/lib/components/po-search/po-search-base.component.d.ts +16 -0
  69. package/lib/components/po-search/po-search.component.d.ts +1 -1
  70. package/lib/components/po-table/enums/po-table-spacing.enum.d.ts +1 -1
  71. package/lib/components/po-tag/po-tag-base.component.d.ts +1 -0
  72. package/lib/enums/po-density-mode.enum.d.ts +14 -0
  73. package/lib/enums/po-field-size.enum.d.ts +5 -3
  74. package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts +12 -0
  75. package/lib/services/po-theme/helpers/types/po-theme-dark-defaults-AA.constant.d.ts +4 -0
  76. package/lib/services/po-theme/helpers/types/po-theme-dark-defaults.constant.d.ts +5 -0
  77. package/lib/services/po-theme/po-theme.module.d.ts +1 -1
  78. package/lib/services/po-theme/po-theme.service.d.ts +39 -11
  79. package/lib/utils/util.d.ts +9 -2
  80. package/package.json +4 -4
  81. package/po-ui-ng-components-20.8.0.tgz +0 -0
  82. package/schematics/ng-add/index.js +1 -1
  83. package/schematics/ng-update/v14/index.js +1 -1
  84. package/schematics/ng-update/v15/index.js +1 -1
  85. package/schematics/ng-update/v16/index.js +1 -1
  86. package/schematics/ng-update/v17/index.js +1 -1
  87. package/schematics/ng-update/v18/index.js +2 -2
  88. package/schematics/ng-update/v19/index.js +2 -2
  89. package/schematics/ng-update/v2/index.js +1 -1
  90. package/schematics/ng-update/v20/index.js +2 -2
  91. package/schematics/ng-update/v3/index.js +1 -1
  92. package/schematics/ng-update/v4/index.js +1 -1
  93. package/schematics/ng-update/v5/index.js +1 -1
  94. package/schematics/ng-update/v6/index.js +1 -1
  95. package/po-ui-ng-components-20.6.0.tgz +0 -0
@@ -1,6 +1,7 @@
1
- import { AfterViewInit, DoCheck, ElementRef, QueryList } from '@angular/core';
1
+ import { AfterViewInit, DoCheck, ElementRef, QueryList, OnChanges, SimpleChanges } from '@angular/core';
2
2
  import { PoRadioComponent } from '../po-radio/po-radio.component';
3
3
  import { PoRadioGroupBaseComponent } from './po-radio-group-base.component';
4
+ import { PoHelperComponent } from '../../po-helper';
4
5
  /**
5
6
  * @docsExtends PoRadioGroupBaseComponent
6
7
  *
@@ -27,7 +28,7 @@ import { PoRadioGroupBaseComponent } from './po-radio-group-base.component';
27
28
  * </example>
28
29
  *
29
30
  */
30
- export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck {
31
+ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck, OnChanges {
31
32
  private el;
32
33
  private cd;
33
34
  /** Label do campo. */
@@ -36,10 +37,12 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
36
37
  help?: string;
37
38
  inputEl: ElementRef;
38
39
  radioLabels: QueryList<PoRadioComponent>;
40
+ helperEl?: PoHelperComponent;
39
41
  differ: any;
40
42
  constructor();
41
43
  ngAfterViewInit(): void;
42
44
  ngDoCheck(): void;
45
+ ngOnChanges(changes: SimpleChanges): void;
43
46
  emitAdditionalHelp(): void;
44
47
  eventClick(value: any, disabled: any): void;
45
48
  /**
@@ -69,20 +72,12 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
69
72
  onKeyUp(event: KeyboardEvent, value: any): void;
70
73
  /**
71
74
  *
72
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
75
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
73
76
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
74
77
  *
75
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
78
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
76
79
  *
77
80
  * ```
78
- * <po-radio-group
79
- * #radioGroup
80
- * ...
81
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
82
- * (p-keydown)="onKeyDown($event, radioGroup)"
83
- * ></po-radio-group>
84
- * ```
85
- * ```
86
81
  * // Exemplo com p-label e p-helper
87
82
  * <po-radio-group
88
83
  * #radioGroup
@@ -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
  }
@@ -6,6 +6,8 @@
6
6
  * Interface para definição de literais utilizadas no `po-listbox`
7
7
  */
8
8
  export interface PoListBoxLiterals {
9
+ /** Texto do botão para voltar ao agrupador anterior. */
10
+ backToPreviousGroup?: string;
9
11
  /** Texto exibido quando não houver itens na lista */
10
12
  noItems?: string;
11
13
  /** Texto do *placeholder* do campo de busca. */
@@ -76,6 +76,7 @@ export declare class PoItemListBaseComponent {
76
76
  * Define um ícone que será exibido ao lado esquerdo do rótulo.
77
77
  */
78
78
  icon: string | TemplateRef<void>;
79
+ iconPosition: 'left' | 'right';
79
80
  /**
80
81
  * @optional
81
82
  *
@@ -22,6 +22,7 @@ export declare class PoListBoxBaseComponent {
22
22
  private _literals;
23
23
  private language;
24
24
  private _size?;
25
+ listboxSubitems: boolean;
25
26
  visible: boolean;
26
27
  set type(value: string);
27
28
  get type(): PoItemListType;
@@ -32,18 +33,11 @@ export declare class PoListBoxBaseComponent {
32
33
  get isItemListGroup(): boolean;
33
34
  isTabs: boolean;
34
35
  param?: any;
35
- selectItem: EventEmitter<any>;
36
- closeEvent: EventEmitter<any>;
37
- change: EventEmitter<any>;
38
- selectCombo: EventEmitter<any>;
39
- changeAll: EventEmitter<any>;
40
- UpdateInfiniteScroll: EventEmitter<any>;
41
36
  checkboxAllValue: any;
42
37
  selectedOptions: Array<any>;
43
38
  selectedOption?: any;
44
39
  fieldValue: string;
45
40
  fieldLabel: string;
46
- changeSearch: EventEmitter<any>;
47
41
  literalSearch?: any;
48
42
  fieldValueSearch: string;
49
43
  hideSearch?: boolean;
@@ -69,6 +63,13 @@ export declare class PoListBoxBaseComponent {
69
63
  footerActionListbox: boolean;
70
64
  placeholderListbox: string;
71
65
  separator: boolean;
66
+ changeSearch: EventEmitter<any>;
67
+ selectItem: EventEmitter<any>;
68
+ closeEvent: EventEmitter<any>;
69
+ change: EventEmitter<any>;
70
+ selectCombo: EventEmitter<any>;
71
+ changeAll: EventEmitter<any>;
72
+ UpdateInfiniteScroll: EventEmitter<any>;
72
73
  activatedTab: EventEmitter<any>;
73
74
  clickTab: EventEmitter<any>;
74
75
  changeStateTabs: EventEmitter<any>;