@po-ui/ng-components 19.2.0 → 19.3.0

package/lib/components/po-button/po-button-base.component.d.ts

@@ -109,6 +109,7 @@ export declare class PoButtonBaseComponent {
      * @default `PoButtonType.Button`
      */
     type?: PoButtonType;
+    blur: EventEmitter<any>;
     /** Ação que será executada quando o usuário clicar sobre o `po-button`. */
     click: EventEmitter<null>;
     private _danger?;
@@ -197,6 +198,6 @@ export declare class PoButtonBaseComponent {
      */
     ariaLabel?: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoButtonBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoButtonBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "loading": { "alias": "p-loading"; "required": false; }; "danger": { "alias": "p-danger"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "kind": { "alias": "p-kind"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "ariaLabel": { "alias": "p-aria-label"; "required": false; }; }, { "click": "p-click"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoButtonBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "loading": { "alias": "p-loading"; "required": false; }; "danger": { "alias": "p-danger"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "kind": { "alias": "p-kind"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "ariaLabel": { "alias": "p-aria-label"; "required": false; }; }, { "blur": "p-blur"; "click": "p-click"; }, never, never, true, never>;
     static ngAcceptInputType_danger: any;
 }

package/lib/components/po-button/po-button.component.d.ts

@@ -27,6 +27,7 @@ import * as i0 from "@angular/core";
  */
 export declare class PoButtonComponent extends PoButtonBaseComponent {
     buttonElement: ElementRef;
+    onBlur(): void;
     /**
      * Função que atribui foco ao componente.
      *

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form-field.interface.d.ts

@@ -21,20 +21,12 @@ export interface PoDynamicFormField extends PoDynamicField {
     /**
      * Evento disparado ao clicar no ícone de ajuda adicional.
      * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
-     *
-     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
-     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
-     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
      */
     additionalHelp?: Function;
     /**
      * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
-     *
-     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
-     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
-     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
      */
     additionalHelpTooltip?: string;
     /**
@@ -44,10 +36,6 @@ export interface PoDynamicFormField extends PoDynamicField {
      *
      * > O uso dessa propriedade pode acarretar na perda sequencial da tabulação da página.
      * Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
-     *
-     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
-     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
-     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
      */
     appendBox?: boolean;
     /**
@@ -60,6 +48,11 @@ export interface PoDynamicFormField extends PoDynamicField {
      * **Componentes compatíveis:** `po-radio-group`, `po-lookup`, `po-checkbox-group`.
      */
     columns?: Array<PoLookupColumn> | number;
+    /**
+     * Função executada quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown?: Function;
     /** Define a obrigatoriedade do campo. */
     required?: boolean;
     /**

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form-fields/po-dynamic-form-fields.component.d.ts

@@ -19,6 +19,7 @@ export declare class PoDynamicFormFieldsComponent extends PoDynamicFormFieldsBas
     components: QueryList<{
         name: string;
         focus: () => void;
+        showAdditionalHelp: () => void;
     }>;
     private previousValue;
     constructor(titleCasePipe: TitleCasePipe, validationService: PoDynamicFormValidationService, changes: ChangeDetectorRef, form: NgForm);
@@ -27,6 +28,7 @@ export declare class PoDynamicFormFieldsComponent extends PoDynamicFormFieldsBas
     isDisabled(field: PoDynamicFormField): boolean;
     onChangeField(visibleField: PoDynamicFormField, objectValue?: any): Promise<void>;
     onChangeFieldModel(visibleField: PoDynamicFormField): void;
+    showAdditionalHelp(property: string): void;
     updatePreviousValue(): void;
     trackBy(index: any): any;
     private applyFieldValidation;

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts

@@ -36,8 +36,10 @@ export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent i
     fieldsComponent: {
         focus: (property: string) => void;
         updatePreviousValue: () => void;
+        showAdditionalHelp: (property: string) => void;
     };
     disabledForm: boolean;
+    displayAdditionalHelp: boolean;
     private _form;
     private onLoadSubscription;
     private sendFormSubscription;
@@ -78,6 +80,35 @@ export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent i
     focus(property: string): void;
     getObjectValue(): Observable<any>;
     sendObjectValue(objectValue: any): void;
+    /**
+     * Método que exibe `additionalHelpTooltip` ou executa a ação definida em `additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `keydown`.
+     *
+     * ```
+     * import { PoDynamicModule } from '@po-ui/ng-components';
+     * ...
+     * @ViewChild('dynamicForm', { static: true }) dynamicForm: PoDynamicFormComponent;
+     *
+     * fields: Array<PoDynamicFormField> = [
+     *  {
+     *    property: 'name',
+     *    ...
+     *    help: 'Mensagem de ajuda.',
+     *    additionalHelpTooltip: 'Mensagem de ajuda complementar.',
+     *    keydown: this.onKeyDown.bind(this, 'name')
+     *  },
+     * ]
+     *
+     * onKeyDown(property: string, event: KeyboardEvent): void {
+     *  if (event.code === 'F9') {
+     *    this.dynamicForm.showAdditionalHelp(property);
+     *  }
+     * }
+     * ```
+     *
+     * @param { string } property Identificador da coluna.
+     */
+    showAdditionalHelp(property: string): void;
     validateForm(field: PoDynamicFormField): void;
     private applyFormUpdatesOnLoad;
     private applyFormValidation;

package/lib/components/po-field/po-checkbox/po-checkbox-base.component.d.ts

@@ -98,6 +98,7 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      */
     additionalHelp: EventEmitter<any>;
+    blur: EventEmitter<any>;
     /**
      * @optional
      *
@@ -106,9 +107,18 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      * Evento disparado quando o valor do *checkbox* for alterado.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     checkboxValue: boolean | null | string;
     checkBoxRequired: boolean;
     disabladTabindex: boolean;
+    displayAdditionalHelp: boolean;
     id: string;
     propagateChange: any;
     onTouched: any;
@@ -149,7 +159,7 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     writeValue(value: any): void;
     protected abstract changeModelValue(value: boolean | null): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "checkboxValue": { "alias": "p-checkboxValue"; "required": false; }; "checkBoxRequired": { "alias": "p-required"; "required": false; }; "disabladTabindex": { "alias": "p-disabled-tabindex"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "checkboxValue": { "alias": "p-checkboxValue"; "required": false; }; "checkBoxRequired": { "alias": "p-required"; "required": false; }; "disabladTabindex": { "alias": "p-disabled-tabindex"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_checkBoxRequired: any;

package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts

@@ -53,6 +53,28 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
     emitAdditionalHelp(): void;
     getAdditionalHelpTooltip(): string;
     onKeyDown(event: KeyboardEvent, value: boolean | string): void;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-checkbox
+     *  #checkbox
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, checkbox)"
+     * ></po-checkbox>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoCheckboxComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     protected changeModelValue(value: boolean | null | string): void;
     private isAdditionalHelpEventTriggered;

package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts

@@ -101,14 +101,6 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      */
     fieldErrorMessage: string;
-    /**
-     * @optional
-     *
-     * @description
-     * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
-     */
-    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -138,6 +130,14 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      */
     ngModelChange: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado ao clicar no ícone de ajuda adicional.
+     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -146,9 +146,18 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * Evento disparado ao alterar valor do campo
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     checkboxGroupOptionsView: Array<PoCheckboxGroupOptionView>;
     checkedOptions: any;
     checkedOptionsList: any;
+    displayAdditionalHelp: boolean;
     mdColumns: number;
     propagateChange: any;
     validatorChange: any;
@@ -247,7 +256,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
     private removeDuplicatedOptions;
     private setCheckboxGroupOptionsView;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxGroupBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "indeterminate": { "alias": "p-indeterminate"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "ngModelChange": "ngModelChange"; "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxGroupBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "indeterminate": { "alias": "p-indeterminate"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "ngModelChange": "ngModelChange"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts

@@ -30,6 +30,7 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     constructor(changeDetector: ChangeDetectorRef);
     ngAfterViewChecked(): void;
     ngAfterViewInit(): void;
+    onBlur(checkbox: PoCheckboxComponent): void;
     emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
@@ -52,10 +53,33 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     getAdditionalHelpTooltip(): string;
     getErrorPattern(): string;
     hasInvalidClass(): any;
-    onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption): void;
+    onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption, checkbox?: PoCheckboxComponent): void;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-checkbox-group
+     *  #checkboxGroup
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, checkboxGroup)"
+     * ></po-checkbox-group>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoCheckboxGroupComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
     private isAdditionalHelpEventTriggered;
+    private isCheckboxOptionFocused;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoCheckboxGroupComponent, "po-checkbox-group", never, {}, {}, never, never, false, never>;
 }

package/lib/components/po-field/po-combo/po-combo-base.component.d.ts

@@ -258,6 +258,14 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * > Pode-se optar pelo recebimento do objeto selecionado ao invés do model através da propriedade `p-emit-object-value`.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     /**
      * @optional
      *
@@ -299,6 +307,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     page: number;
     pageSize: number;
     loading: boolean;
+    displayAdditionalHelp: boolean;
     dynamicLabel: string;
     dynamicValue: string;
     shouldApplyFocus: boolean;
@@ -576,7 +585,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     abstract getInputValue(): string;
     abstract initInputObservable(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoComboBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoComboBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "emitObjectValue": { "alias": "p-emit-object-value"; "required": false; }; "disabledTabFilter": { "alias": "p-disabled-tab-filter"; "required": false; }; "removeInitialFilter": { "alias": "p-remove-initial-filter"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "disabledInitFilter": { "alias": "p-disabled-init-filter"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterMinlength": { "alias": "p-filter-minlength"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "changeOnEnter": { "alias": "p-change-on-enter"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "ngModelChange": "ngModelChange"; "inputChange": "p-input-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoComboBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "emitObjectValue": { "alias": "p-emit-object-value"; "required": false; }; "disabledTabFilter": { "alias": "p-disabled-tab-filter"; "required": false; }; "removeInitialFilter": { "alias": "p-remove-initial-filter"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "disabledInitFilter": { "alias": "p-disabled-init-filter"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterMinlength": { "alias": "p-filter-minlength"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "changeOnEnter": { "alias": "p-change-on-enter"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; "ngModelChange": "ngModelChange"; "inputChange": "p-input-change"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_clean: any;
     static ngAcceptInputType_emitObjectValue: any;

package/lib/components/po-field/po-combo/po-combo.component.d.ts

@@ -132,6 +132,28 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     cleanListbox(): void;
     getInputValue(): any;
     setInputValue(value: string): void;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-combo
+     *  #combo
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, combo)"
+     * ></po-combo>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoComboComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     wasClickedOnToggle(event: MouseEvent): void;
     isValidCharacterToSearch(keyCode: any): boolean;
     searchOnEnterOrArrow(event: any, value: string): void;

package/lib/components/po-field/po-datepicker/po-datepicker-base.component.d.ts

@@ -186,6 +186,14 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * Evento disparado ao alterar valor do campo.
      */
     onchange: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     offset: number;
     protected firstStart: boolean;
     protected hour: string;
@@ -346,7 +354,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     abstract writeValue(value: any): void;
     abstract refreshValue(value: Date): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "errorAsync": { "alias": "p-error-async"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "format": { "alias": "p-format"; "required": false; }; "isoFormat": { "alias": "p-iso-format"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onblur": "p-blur"; "onchange": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "errorAsync": { "alias": "p-error-async"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "format": { "alias": "p-format"; "required": false; }; "isoFormat": { "alias": "p-iso-format"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onblur": "p-blur"; "onchange": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_appendBox: any;
 }

package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts

@@ -45,6 +45,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     label?: string;
     /** Texto de apoio do campo. */
     help?: string;
+    displayAdditionalHelp: boolean;
     el: ElementRef;
     hour: string;
     id: string;
@@ -92,9 +93,32 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     clear(): void;
     eventOnBlur($event: any): void;
     eventOnClick($event: any): void;
+    onKeyDown(event: KeyboardEvent): void;
     onKeyPress(event: any): void;
     formatToDate(value: Date): string;
     refreshValue(value: Date): void;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-datepicker
+     *  #datepicker
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, datepicker)"
+     * ></po-datepicker>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoDatepickerComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     writeValue(value: any): void;
     isValidDateIso(value: string): boolean;
     isValidExtendedIso(value: any): boolean;

package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts

@@ -52,6 +52,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected poDateService: PoDateService;
     private languageService;
     additionalHelpEventTrigger: string | undefined;
+    name: string;
     /**
      * @optional
      *
@@ -158,8 +159,17 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * Evento disparado ao alterar valor do campo.
      */
     onChange: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     errorMessage: string;
     dateRange: PoDatepickerRange;
+    displayAdditionalHelp: boolean;
     protected format: any;
     protected isDateRangeInputFormatValid: boolean;
     protected isStartDateRangeInputValid: boolean;
@@ -352,7 +362,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected abstract resetDateRangeInputValidation(): void;
     protected abstract updateScreenByModel(dateRange: PoDatepickerRange): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerRangeBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onChange": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "name": { "alias": "name"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onChange": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts

@@ -96,6 +96,28 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     onKeyup(event: any): void;
     resetDateRangeInputValidation(): void;
     showAdditionalHelpIcon(): boolean;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-datepicker-range
+     *  #datepickerRange
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, datepickerRange)"
+     * ></po-datepicker-range>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoDatepickerRangeComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     toggleCalendar(): void;
     updateScreenByModel(model: PoDatepickerRange): void;
     private applyFocusOnDatePickerRangeField;

package/lib/components/po-field/po-decimal/po-decimal.component.d.ts

@@ -144,6 +144,7 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     onFocus(event: FocusEvent): void;
     onInput(event: any): void;
     onInputKeyboardAndroid(event: any): any;
+    onKeyDown(event: KeyboardEvent): void;
     onKeyPress(event: KeyboardEvent): void;
     setPaddingInput(): void;
     writeValueModel(value: any): void;

package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts

@@ -1,4 +1,5 @@
-import { EventEmitter } from '@angular/core';
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { PoTooltipDirective } from '../../../../directives';
 import * as i0 from "@angular/core";
 /**
  * @docsPrivate
@@ -8,7 +9,8 @@ import * as i0 from "@angular/core";
  * Componente de uso interno, responsável por gerar uma margem inferior nos componentes que utilizam o po-field-container.
  * Essa margem inferior pode conter uma mensagem de erro.
  */
-export declare class PoFieldContainerBottomComponent {
+export declare class PoFieldContainerBottomComponent implements OnChanges {
+    poTooltip: PoTooltipDirective;
     /** Texto exibido no tooltip do ícone de ajuda adicional. */
     additionalHelpTooltip?: string;
     /** Define se o tooltip será inserido no `body` em vez do componente. */
@@ -24,11 +26,15 @@ export declare class PoFieldContainerBottomComponent {
      */
     errorLimit: boolean;
     help?: string;
+    /** Ativa a exibição da ajuda adicional. */
+    showAdditionalHelp: boolean;
     /** Exibe o ícone de ajuda adicional. */
     showAdditionalHelpIcon: boolean;
     /** Evento disparado ao clicar no ícone de ajuda adicional. */
     additionalHelp: EventEmitter<any>;
+    private isInitialChange;
+    ngOnChanges(changes: SimpleChanges): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerBottomComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "showAdditionalHelp": { "alias": "p-show-additional-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
     static ngAcceptInputType_appendBox: any;
 }

package/lib/components/po-field/po-field.model.d.ts

@@ -59,6 +59,15 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * Evento disparado ao alterar valor do campo.
      */
     change: EventEmitter<T>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
+    displayAdditionalHelp: boolean;
     value: T;
     protected onTouched: any;
     private propagateChange;
@@ -70,12 +79,34 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     emitAdditionalHelp(): void;
     emitChange(value: any): void;
     getAdditionalHelpTooltip(): string;
+    /**
+     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * ```
+     * <po-nome-component
+     *  #component
+     *  ...
+     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
+     *  (p-keydown)="onKeyDown($event, component)"
+     * ></po-nome-component>
+     * ```
+     * ```
+     * ...
+     * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     private isAdditionalHelpEventTriggered;
     protected updateModel(value: T): void;
     abstract onWriteValue(value: T): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldModel<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldModel<any>, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldModel<any>, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_disabled: any;
 }