Pokaż spis treści

Komponent treści

Contact form: contact-form

Formularz kontaktowy z danymi kontaktowymi, zgodą i komunikatami statusu. Dokumentacja tej podstrony opisuje, co operator ustawia w panelu, jak dane trafiają do renderera ContactFormBlock.astro i dlaczego komponent jest osobnym typem bloku.

Rola komponentu

Formularz kontaktowy z danymi kontaktowymi, zgodą i komunikatami statusu.

Administrator ustawia treść formularza i endpoint, domyślnie /api/contact. Publiczny endpoint waliduje pola, honeypoty, czas formularza, zgodę prywatności i recaptcha, a następnie wysyła wiadomość SMTP.

Pola edytora

  • title
  • paragraphs
  • items z label, value, kind i href
  • contactItemsGap
  • formTitle
  • formAction
  • formMethod
  • placeholdery pól
  • messageRows
  • consentLabel
  • privacyHref
  • buttonLabel
  • successMessage i errorMessage

Od danych bloku do renderera

flowchart LR
  A["Paleta buildera"] --> B["blockType: contact-form"]
  B --> C["Formularz pól komponentu"]
  C --> D["data_json"]
  D --> E["content_blocks"]
  E --> F["ContactFormBlock.astro"]
  F --> G["Sekcja publiczna"]

Decyzje administracyjne i inżynierskie

Formularz jest blokiem, ale jego wysyłka nie jest przypadkowym JavaScriptem w stronie. Walidacja i obsługa błędów są w kontrolowanym endpointcie.

Wspólne pola techniczne, takie jak sectionWidth, sectionMarginTop, sectionMarginBottom, sectionPaddingTop i sectionPaddingBottom, sprawiają, że każdy komponent można dopasować do rytmu strony bez dopisywania klas albo stylów inline.

Powiązanie z builderem

Ten komponent jest dostępny w palecie tylko wtedy, gdy jego typ pozostaje aktywny w ustawieniu enabledBlockTypes. Import YAML również sprawdza ten typ przez rejestr bloków.