react-lgpd-consent - v0.3.4
    Preparing search index...

    Function CookieBanner

    • Banner principal de consentimento LGPD que solicita decisão do usuário sobre cookies.

      Parameters

      • props: Readonly<CookieBannerProps>

        Propriedades para customizar comportamento e aparência do banner (tipado via CookieBannerProps)

      Returns null | Element

      Banner de consentimento ou null se não deve ser exibido

      Components

      O CookieBanner é o ponto de entrada principal para interação com o sistema de consentimento. Aparece automaticamente quando o usuário ainda não tomou decisão sobre cookies, oferecendo opções claras de aceitar, rejeitar ou personalizar preferências.

      • Exibição condicional: Aparece apenas se usuário não deu consentimento
      • Duas modalidades: Bloqueante (modal) ou não-bloqueante (snackbar)
      • Ações do usuário: Aceitar tudo, rejeitar tudo, ou abrir preferências
      • Link para política: Opção de link para política de privacidade
      • Branding opcional: Marca discreta "fornecido por LÉdipO.eti.br"
      • Totalmente customizável: Via props, tokens de design ou componente próprio
      • Não exibido: Usuário já consentiu ou ainda hidratando (SSR)
      • Snackbar: Modo não-bloqueante, permite interação com a página
      • Modal: Modo bloqueante, impede interação até decisão
      • Debug: Sempre visível independente do estado (desenvolvimento)
      • Conecta automaticamente com ConsentProvider
      • Usa textos do useConsentTexts() para i18n
      • Aplica design tokens do useDesignTokens()
      • Registra todas as interações via sistema de logging
      • Suporte completo a SSR com hidratação segura

      Para controle total, use CookieBannerComponent no ConsentProvider:

      function CustomBanner() {
      const { acceptAll, rejectAll } = useConsent();
      return <div>Meu banner customizado</div>;
      }

      <ConsentProvider CookieBannerComponent={CustomBanner}>
      // ConsentProvider renderiza CookieBanner automaticamente
      function App() {
      return (
      // ConsentProvider envolve a aplicação
      // CookieBanner aparece quando necessário
      );
      }
      // Configuração com propriedades customizadas
      const bannerProps = {
      policyLinkUrl: "/privacy",
      blocking: false,
      hideBranding: true
      };

      // ConsentProvider com cookieBannerProps
      function App() {
      const bannerConfig = {
      policyLinkUrl: "https://example.com/cookies",
      blocking: true,
      PaperProps: { elevation: 8 },
      SnackbarProps: { anchorOrigin: { vertical: 'top' as const } }
      };

      // Renderização manual com config avançada
      return null; // CookieBanner com bannerConfig
      }

      0.1.0