import { PoHelperOptions } from './interfaces/po-helper.interface'; /** * @description * * O componente `po-helper` exibe um ícone de ajuda ou informação ao lado de campos, botões ou outros elementos, permitindo ao usuário acessar conteúdos explicativos em um popover. * * Principais funcionalidades: * - Exibe ícone de ajuda (`help`) ou informação (`info`) conforme configuração. * - Permite definir título, conteúdo e ações no popover via propriedade `p-helper`. * - Suporte a acessibilidade: navegação por teclado, atributos ARIA e leitura do conteúdo por leitores de tela. * - Controle do tamanho do componente via propriedade `p-size` (`small` ou `medium`). * - Permite customizar ações no rodapé do popover. * * Exemplo de uso: * ```html * * ``` * * Também é possível passar apenas uma string para o conteúdo: * ```html * * ``` * * A propriedade `p-helper` aceita um objeto do tipo `PoHelperOptions`: * ```typescript * interface PoHelperOptions { * title?: string; * content: string; * type?: 'help' | 'info'; * eventOnClick?: Function; * footerAction?: { label: string; action: Function }; * } * ``` * * > **Importante:** A propriedade `footerAction` não pode ser utilizada quando o tipo do helper for `info`, pois o ícone de informação é destinado apenas para exibir informações estáticas sem ações adicionais. * * #### Tokens customizáveis * * É possível alterar o estilo do componente usando os seguintes tokens (CSS): * * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization). * * | Propriedade | Descrição | Valor Padrão | * |--------------------------------------------|---------------------------------------------------------------|---------------------------------------------------| * | `--color` | Cor principal do ícone | `var(--color-action-default)` | * | `--border-color-hover` | Cor da borda no estado hover | `var(--color-brand-01-darkest)` | * | `--background-pressed` | Cor de background no estado de pressionado  | `var(--color-brand-01-light)` | * | `--color-disabled` | Cor principal no estado disabled | `var(--color-action-disabled)` | * */ export declare class PoHelperBaseComponent { /** * @optional * * @description * * Define o conteúdo e as opções do popover de ajuda/informação. * * Aceita uma string simples (exibida como conteúdo) ou um objeto do tipo `PoHelperOptions` para configuração avançada: * - `title`: Título do popover. * - `content`: Conteúdo explicativo exibido no popover. * - `type`: Tipo do ícone (`help` ou `info`). * - `eventOnClick`: Função chamada ao clicar no ícone. * - `footerAction`: Objeto com `label` e `action` para ação customizada no rodapé do popover. * * Exemplo de uso: * ```html * * * ``` * */ helper: import("@angular/core").InputSignal; /** * @optional * * @description * * Define o tamanho do componente: * - `small`: altura do ícone com seu valor de 16px (disponível apenas para acessibilidade AA). * - `medium`: altura do ícone com seu valor de 24px. * * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido. * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme). * * @default `medium` */ size: import("@angular/core").InputSignal; get hostSize(): string; /** * @optional * * @description * * Indica se o helper deve ser exibido no estado desativado, desabilitando interações do usuário. * * @default `false` */ disabled: import("@angular/core").InputSignal; /** * @optional * * @description * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento * correto do conteúdo próximo ao elemento. */ appendBox: import("@angular/core").InputSignal; private transformHelper; }