1. IronPDF
  2. Poradniki
  3. Wypełnianie formularzy PDF

Jak wypełniać pola formularzy PDF w Pythonie

Curtis Chau
Curtis Chau
Zaktualizowano:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Wypełniaj formularze PDF programowo w Pythonie używając IronPDF: załaduj istniejący PDF, zlokalizuj każde pole po nazwie, przypisz wartości i zapisz wynik w kilku liniach kodu.

Szybki start: Wypełnianie pól formularzy PDF

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/quickstart.py
1. Install IronPDF: `pip install ironpdf`
2. Load your PDF: `form_document = PdfDocument.FromFile("form.pdf")`
3. Find form field: `field = form_document.Form.FindFormField("fieldname")`
4. Set field value: `field.Value = "Your Value"`
5. Save filled PDF: `form_document.SaveAs("filled_form.pdf")`
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
1. Install IronPDF: `pip install ironpdf`
2. Load your PDF: `form_document = PdfDocument.FromFile("form.pdf")`
3. Find form field: `field = form_document.Form.FindFormField("fieldname")`
4. Set field value: `field.Value = "Your Value"`
5. Save filled PDF: `form_document.SaveAs("filled_form.pdf")`
PYTHON

Jak wypełniać pola formularzy PDF w Pythonie

  1. Zainstaluj bibliotekę IronPDF dla Pythona
  2. Załaduj istniejący dokument PDF zawierający pola formularza
  3. Uzyskaj dostęp do pola formularza po nazwie przy użyciu metody FindFormField atrybutu Form
  4. Przypisz nową wartość do atrybutu Value pola
  5. Eksportuj zmodyfikowany dokument przy użyciu SaveAs

Zbieranie danych za pomocą interfejsu webowego, a następnie generowanie wypełnionego PDF do archiwizacji lub dalszego przetwarzania, jest powszechnym wzorcem automatyzacji dokumentów. Zamiast ręcznie przepisywać dane do formularzy PDF, skrypty Python mogą to obsłużyć natychmiast: odczytać nazwy pól, wypełniać wartości i tworzyć gotowe dokumenty do przechowywania lub dystrybucji.

IronPDF sprawia, że ten przepływ pracy jest bezpośredni: jedno API do tworzenia formularzy z HTML, jedna metoda do lokalizowania pola po nazwie, jedna właściwość do ustawienia jego wartości. PDF-formularze w naturze zawierają więcej niż tylko pola tekstowe. Pola wyboru, przyciski opcji i pola rozwijane są obsługiwane przy użyciu tego samego podejścia FindFormField i Value. Reszta tego przewodnika omawia kluczowe scenariusze: generowanie formularza z oznaczeń HTML, wypełnianie pól w istniejącym dokumencie, czytanie wszystkich typów pól oraz wykonywanie masowych wypełnień z zasobu danych.

Jak tworzę i wypełniam formularz PDF używając HTML w Pythonie?

IronPDF może konwertować elementy HTML <input> bezpośrednio na edytowalne pola PDF, zapewniając bezpośrednią ścieżkę od definicji formularza w stylu internetowym do dokumentu PDF z możliwością wypełniania. Możesz projektować formularze przy użyciu znajomego HTML i CSS, a następnie natychmiast je wypełniać, bez pośrednich kroków manualnych.

Poniższy przykład renderuje formularz HTML jako plik PDF, a następnie wypełnia pola firstname i lastname przed zapisaniem wyniku.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/fill-form-from-html.py
from ironpdf import *

# Define HTML content for a simple form
form_html = """
<html>
<body>
<h2>Editable PDF Form</h2>
<form>
First name: <br> <input type='text' name='firstname' value=''> <br>
Last name: <br> <input type='text' name='lastname' value=''>
</form>
</body>
</html>
"""

# Instantiate a PDF renderer
renderer = ChromePdfRenderer()

# Enable HTML form-to-PDF-field conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

# Render the HTML content to a PDF file
renderer.RenderHtmlAsPdf(form_html).SaveAs("BasicForm.pdf")

# Load the created PDF document
form_document = PdfDocument.FromFile("BasicForm.pdf")

# Access the "firstname" field and set its value
first_name_field = form_document.Form.FindFormField("firstname")
first_name_field.Value = "Minnie"
print("FirstNameField value: {}".format(first_name_field.Value))

# Access the "lastname" field and set its value
last_name_field = form_document.Form.FindFormField("lastname")
last_name_field.Value = "Mouse"
print("LastNameField value: {}".format(last_name_field.Value))

# Save the filled form
form_document.SaveAs("FilledForm.pdf")
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
from ironpdf import *

# Define HTML content for a simple form
form_html = """
<html>
<body>
<h2>Editable PDF Form</h2>
<form>
First name: <br> <input type='text' name='firstname' value=''> <br>
Last name: <br> <input type='text' name='lastname' value=''>
</form>
</body>
</html>
"""

# Instantiate a PDF renderer
renderer = ChromePdfRenderer()

# Enable HTML form-to-PDF-field conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

# Render the HTML content to a PDF file
renderer.RenderHtmlAsPdf(form_html).SaveAs("BasicForm.pdf")

# Load the created PDF document
form_document = PdfDocument.FromFile("BasicForm.pdf")

# Access the "firstname" field and set its value
first_name_field = form_document.Form.FindFormField("firstname")
first_name_field.Value = "Minnie"
print("FirstNameField value: {}".format(first_name_field.Value))

# Access the "lastname" field and set its value
last_name_field = form_document.Form.FindFormField("lastname")
last_name_field.Value = "Mouse"
print("LastNameField value: {}".format(last_name_field.Value))

# Save the filled form
form_document.SaveAs("FilledForm.pdf")
PYTHON

Ustawienie CreatePdfFormsFromHtml na True w atrybucie RenderingOptions nakazuje rendererowi przetłumaczyć każdy element <input> w HTML na odpowiednie interaktywne pole PDF. Bez tej flagi, pola tekstowe renderują się jako statyczne elementy wizualne i nie mogą być programowo wypełniane.

Po renderowaniu PdfDocument.FromFile ponownie ładuje zapisany plik do pamięci. Metoda FindFormField przyjmuje atrybut pola name jako ciąg znaków i zwraca obiekt FormField. Przypisanie do Value zapisuje dane w polu. Wywołanie SaveAs zapisuje zmodyfikowany dokument na dysku.

PoradyProjektując formularze HTML do konwersji do formatu PDF, należy dbać o to, aby atrybuty pól name były krótkie i bezpieczne dla adresów URL. Spacje i znaki specjalne w nazwach pól działają, ale mogą utrudniać późniejsze wyszukiwanie FindFormField.

Jak wygląda pusty formularz przed wypełnieniem?

Plik PDF wygenerowany przez IronPDF przedstawiający pusty formularz z polami tekstowymi

Wygenerowany PDF zachowuje wizualny układ formularza HTML. Każde pole tekstowe pojawia się jako klikalne, edytowalne pole. Gdy formularz jest otwierany w czytniku PDF, użytkownicy nadal mogą wpisywać dane ręcznie, lub pola można wypełnić przez API, jak pokazano powyżej.

Jak wygląda wypełniony formularz po wypełnieniu?

Formularz PDF wypełniony przez IronPDF, wyświetlający

Wypełniony dokument pokazuje wartości zapisane do każdego pola. Struktura formularza i interaktywność pól są w pełni zachowane: PDF można zapisać w tej formie do archiwizacji, lub spłaszczyć, aby zablokować wartości w miejscu do dystrybucji.

Jak wypełniać pola w istniejącym dokumencie PDF?

Wiele rzeczywistych przepływów pracy obejmuje formularze PDF stworzone w Adobe Acrobat, Wordzie lub innych narzędziach. IronPDF może wczytać dowolny plik PDF zawierający pola AcroForm i wypełnić je przy użyciu tych samych interfejsów API FindFormField i Value, które są używane podczas tworzenia formularzy z kodu HTML. AcroForm to standardowy interaktywny format formularza zdefiniowany w specyfikacji PDF i jest obsługiwany przez wszystkie główne czytniki PDF.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/fill-existing-form.py
from ironpdf import *

# Load a pre-existing PDF with form fields
form_document = PdfDocument.FromFile("existing_form.pdf")

# Enumerate available field names (helpful when exploring an unfamiliar form)
for field in form_document.Form.Fields:
    print("Field name:", field.Name, "| Current value:", field.Value)

# Fill a specific field by name
applicant_name_field = form_document.Form.FindFormField("applicant_name")
applicant_name_field.Value = "Jane Smith"

# Fill a second field
date_field = form_document.Form.FindFormField("application_date")
date_field.Value = "2026-05-03"

# Save the filled document
form_document.SaveAs("submitted_application.pdf")
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
from ironpdf import *

# Load a pre-existing PDF with form fields
form_document = PdfDocument.FromFile("existing_form.pdf")

# Enumerate available field names (helpful when exploring an unfamiliar form)
for field in form_document.Form.Fields:
    print("Field name:", field.Name, "| Current value:", field.Value)

# Fill a specific field by name
applicant_name_field = form_document.Form.FindFormField("applicant_name")
applicant_name_field.Value = "Jane Smith"

# Fill a second field
date_field = form_document.Form.FindFormField("application_date")
date_field.Value = "2026-05-03"

# Save the filled document
form_document.SaveAs("submitted_application.pdf")
PYTHON

Powtarzanie form_document.Form.Fields przed wypełnieniem jest przydatne podczas pracy z formularzami, których nazwy pól nie są udokumentowane. Pętla drukuje każdą nazwę pola i jego bieżącą wartość, dając pełną mapę tego, co formularz wymaga, zanim jakiekolwiek wartości zostaną zapisane.

Zwróć uwagęIronPDF obsługuje pola AcroForm, standardowy interaktywny format formularza. Skanowane PDF-y i dokumenty tylko z obrazami nie zawierają danych pól; użyj IronOCR, aby najpierw wyodrębnić tekst z tych dokumentów.

Jak pracować z polami wyboru i innymi typami pól?

Pola tekstowe są najczęstszym elementem formularza, ale rzeczywiste formularze zawierają pola wyboru, przyciski radiowe i pola rozwijane (combo box). IronPDF udostępnia wszystkie te funkcje za pośrednictwem tej samej kolekcji Form.Fields. Właściwość Value akceptuje odpowiedni ciąg znaków dla każdego typu.

Tabela poniżej pokazuje akceptowane wartości dla trzech najczęściej spotykanych typów pól innych niż tekstowe:

Konwencje wartości pól formularzy PDF IronPDF dla wpisów innych niż tekstowe
Typ polaTyp wejścia HTMLWartość do ustawieniaUwagi
Pole wyboru"true" lub "false"Bez rozróżnienia wielkości liter; używaj ciągu znaków, a nie typu logicznego
Przycisk radiowyAtrybut value opcji do wyboruTa sama nazwa, różne wartości dla każdej opcji
Rozwijane (combo box)Tekst wyświetlany dla wybranej opcjiMusi dokładnie odpowiadać istniejącej opcji
 
:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/fill-field-types.py
from ironpdf import *

# Load a form with multiple field types
form_document = PdfDocument.FromFile("application_form.pdf")

# Fill a text field
form_document.Form.FindFormField("full_name").Value = "Alex Rivera"

# Check a checkbox (use string "true")
form_document.Form.FindFormField("agree_terms").Value = "true"

# Select a radio button option by its value attribute
form_document.Form.FindFormField("employment_status").Value = "full_time"

# Select a dropdown option by display text
form_document.Form.FindFormField("country").Value = "United States"

form_document.SaveAs("completed_application.pdf")
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
from ironpdf import *

# Load a form with multiple field types
form_document = PdfDocument.FromFile("application_form.pdf")

# Fill a text field
form_document.Form.FindFormField("full_name").Value = "Alex Rivera"

# Check a checkbox (use string "true")
form_document.Form.FindFormField("agree_terms").Value = "true"

# Select a radio button option by its value attribute
form_document.Form.FindFormField("employment_status").Value = "full_time"

# Select a dropdown option by display text
form_document.Form.FindFormField("country").Value = "United States"

form_document.SaveAs("completed_application.pdf")
PYTHON

Podczas iteracji form_document.Form.Fields każdy obiekt FormField udostępnia właściwość Name oraz właściwość Value. W przypadku grup opcji i list rozwijanych PRINTowanie istniejącego kodu Value przed rozpoczęciem pisania pozwoli wyświetlić aktualny wybór i potwierdzić oczekiwany format dla tego pola.

UwagaJeśli FindFormField zwraca None, nazwa pola nie istnieje w dokumencie. PRINT wszystkie nazwy za pomocą form_document.Form.Fields, aby sprawdzić pisownię i potwierdzić obecność pola. Nazwy pól są rozróżniane pod względem wielkości liter.

Jak wypełniać formularze masowo z zasobu danych?

Tworzenie jednego wypełnionego PDF dla każdego rekordu z arkusza kalkulacyjnego lub zapytania do bazy danych to jeden z najczęstszych powodów, dla których zespoły sięgają po programowe wypełnianie formularzy. IronPDF obsługuje to, traktując każdą operację wypełniania jako pozbawioną stanu: załaduj szablon, wypełnij pola, zapisz pod unikalną nazwą i powtórz.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/bulk-fill-forms.py
from ironpdf import *

# Sample data records (replace with database or CSV source)
applicants = [
    {"name": "Alice Johnson", "id": "A001", "date": "2026-05-03"},
    {"name": "Bob Williams", "id": "B002", "date": "2026-05-03"},
    {"name": "Carol Davis",  "id": "C003", "date": "2026-05-03"},
]

for applicant in applicants:
    # Load template from disk on each iteration to avoid cross-contamination
    form_document = PdfDocument.FromFile("application_template.pdf")

    # Fill each field from the data record
    form_document.Form.FindFormField("applicant_name").Value = applicant["name"]
    form_document.Form.FindFormField("applicant_id").Value   = applicant["id"]
    form_document.Form.FindFormField("submission_date").Value = applicant["date"]

    # Save each filled form with a unique filename
    output_path = f"output/application_{applicant['id']}.pdf"
    form_document.SaveAs(output_path)
    print(f"Saved: {output_path}")
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
from ironpdf import *

# Sample data records (replace with database or CSV source)
applicants = [
    {"name": "Alice Johnson", "id": "A001", "date": "2026-05-03"},
    {"name": "Bob Williams", "id": "B002", "date": "2026-05-03"},
    {"name": "Carol Davis",  "id": "C003", "date": "2026-05-03"},
]

for applicant in applicants:
    # Load template from disk on each iteration to avoid cross-contamination
    form_document = PdfDocument.FromFile("application_template.pdf")

    # Fill each field from the data record
    form_document.Form.FindFormField("applicant_name").Value = applicant["name"]
    form_document.Form.FindFormField("applicant_id").Value   = applicant["id"]
    form_document.Form.FindFormField("submission_date").Value = applicant["date"]

    # Save each filled form with a unique filename
    output_path = f"output/application_{applicant['id']}.pdf"
    form_document.SaveAs(output_path)
    print(f"Saved: {output_path}")
PYTHON

Ładowanie szablonu wewnątrz pętli, a nie raz przed nią, zapobiega kumulacji wartości pól przez iteracje. Każde wywołanie PdfDocument.FromFile generuje nową kopię szablonu, więc wypełnienie jednego rekordu nie może wpłynąć na następny.

WażneW przypadku przetwarzania dużych partii danych warto rozważyć jednokrotne załadowanie szablonu z PdfDocument.FromFile i użycie mechanizmu kopiowania, jeśli API to obsługuje. Zbenchmarkować oba podejścia w odniesieniu do wymagań dotyczących ilości przed wdrożeniem.

IronPDF nie narzuca sztucznego limitu na liczbę dokumentów, jakie skrypt może wygenerować w jednym uruchomieniu. Przepustowość jest determinowana przez dostępny RAM i prędkość I/O docelowego miejsca zapisu. Dla bardzo dużych partii zapisywanie na lokalnym SSD, a następnie przenoszenie do przechowywania sieciowego jest szybsze niż bezpośrednie zapisywanie na udziale sieciowym.

Jak spłaszczyć wypełniony formularz PDF?

Spłaszczanie przekształca interaktywne pola formularza w statyczną zawartość strony, blokując obecne wartości w miejscu. Spłaszczony PDF jest właściwym wyborem do archiwizacji, drukowania lub wysyłania do odbiorców, którzy nie powinni modyfikować wartości pól.

IronPDF udostępnia metodę spłaszczania pól formularza, która działa na każdym załadowanym PdfDocument. Wywołaj ją po wypełnieniu pól, a następnie zapisz wynik.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-fill-pdf-form/flatten-form.py
from ironpdf import *

# Load and fill a form
form_document = PdfDocument.FromFile("application_template.pdf")
form_document.Form.FindFormField("full_name").Value = "Jordan Lee"
form_document.Form.FindFormField("application_date").Value = "2026-05-03"

# Flatten all form fields to lock values as static content
form_document.Form.Flatten()

# Save the flattened, non-editable PDF
form_document.SaveAs("archived_application.pdf")
// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
from ironpdf import *

# Load and fill a form
form_document = PdfDocument.FromFile("application_template.pdf")
form_document.Form.FindFormField("full_name").Value = "Jordan Lee"
form_document.Form.FindFormField("application_date").Value = "2026-05-03"

# Flatten all form fields to lock values as static content
form_document.Form.Flatten()

# Save the flattened, non-editable PDF
form_document.SaveAs("archived_application.pdf")
PYTHON

Po Flatten() dokument nie zawiera już interaktywnych obiektów pól. Systemy odbierające plik widzą zwykłą zawartość tekstową, a nie widgety formularzy. Jest to ważne dla zgodności archiwizacyjnej PDF/A i zapobiegania niezamierzonym edytom w wieloetapowych szeregach recenzji.

PoradySpłaszcz w momencie zapisywania, kiedy dokument jest przeznaczony do archiwizacji. Jeżeli ten sam dokument będzie najpierw przeglądany i poprawiany, pozostaw pola interaktywne do momentu ostatecznego zapisania.

Jak zainstalować IronPDF w Pythonie?

IronPDF jest dostępny z PyPI. Zainstaluj go przy pomocy pip:

pip install ironpdf

Po instalacji zaimportuj bibliotekę na początku każdego skryptu za pomocą from ironpdf import *. Bezpłatna licencja próbna jest dostępna do oceny. Wdrożenia produkcyjne wymagają klucza licencji komercyjnej ustawionego za pomocą właściwości License.LicenseKey przed uruchomieniem jakichkolwiek operacji na plikach PDF.

Zwróć uwagęIronPDF wymaga Pythona 3.6 lub nowszego. Pakiet zawiera niewidzialny silnik Chromium używany do renderowania HTML na PDF, więc pierwszy import może zająć moment, podczas gdy silnik się inicjuje.

Jakie są następne kroki dla automatyzacji formularzy PDF w Pythonie?

Ten przewodnik obejmował tworzenie formularzy PDF z HTML, wypełnianie pól w istniejących dokumentach, pracowanie z polami wyboru i rozwijanymi, generowanie partii wypełnionych formularzy z zapisów danych, i spłaszczanie wypełnionych PDF-ów do archiwizacji. Każda technika wykorzystuje ten sam podstawowy interfejs API: FindFormField do lokalizowania pola według nazwy, Value do przypisywania danych oraz SaveAs do zapisywania wyniku.

Aby poznać powiązane możliwości w IronPDF for Python:

Rozpocznij bezpłatny okres próbny, aby przetestować wypełnianie formularzy w swoim własnym projekcie Pythona. Gdy będziesz gotów do wdrożenia, zobacz opcje licencji dla indywidualnych deweloperów i pakietów Enterprise.

Często Zadawane Pytania

Jakie są podstawowe kroki, aby wypełnić formularz PDF programowo w języku Python?

Zainstaluj IronPDF za pomocą pip install ironpdf, ładuj swój PDF używając PdfDocument.FromFile(), znajdź docelowe pole za pomocą form_document.Form.FindFormField(), przypisz wartość do field.Value, a następnie zapisz za pomocą SaveAs().

Jak uzyskać dostęp do określonych pól formularza w dokumencie PDF i je modyfikować?

Użyj metody FindFormField na atrybucie Form załadowanego PdfDocument, przekazując nazwę pola jako ciąg znaków. Metoda zwraca obiekt FormField, którego własność Value można odczytać lub ustawić.

Jak wypełnić pola wyboru i pola rozwijane za pomocą IronPDF?

Dla pól wyboru ustaw Value na ciąg "true" lub "false". Dla przycisków radiowych ustaw Value na wartość atrybutu wybranej opcji. Dla pól rozwijanych ustaw Value na dokładny tekst wyświetlany opcji, którą chcesz wybrać.

Czy mogę zautomatyzować masowe wypełnianie formularzy PDF dla wielu dokumentów?

Tak. Ładuj szablon wewnątrz pętli z PdfDocument.FromFile() przy każdej iteracji, aby uzyskać świeżą kopię, wypełniaj pola z wiązanego źródła danych i zapisuj każdy wynik z unikalną nazwą pliku używając SaveAs().

Czym jest spłaszczanie formularzy i kiedy powinienem go używać?

Spłaszczanie konwertuje interaktywne pola formularzy do statycznej zawartości strony, blokując wartość na swoim miejscu. Wywołaj form_document.Form.Flatten() przed zapisaniem, gdy dokument jest przeznaczony do archiwizacji, drukowania lub dystrybucji do odbiorców, którzy nie powinni edytować wartości pól.

Co się stanie, jeśli FindFormField nie znajdzie pola?

Jeśli pole o podanej nazwie nie istnieje, FindFormField zwraca None. Iteruj przez form_document.Form.Fields, aby wydrukować wszystkie dostępne nazwy pól i potwierdzić poprawną pisownię. Nazwy pól są czułe na wielkość liter.

Jakie typy formularzy PDF obsługuje IronPDF?

IronPDF obsługuje pola AcroForm, standardowy format interaktywnego formularza używany przez Adobe Acrobat i większość narzędzi do tworzenia PDF. Skanowane PDF-y i dokumenty tylko z obrazami nie zawierają pól AcroForm i wymagają przetwarzania OCR przed możliwym wydobywaniem tekstu.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.