Ein Feld zum Eintippen
Fügen Sie ein Feld zum Ausfüllen hinzu: Name, Anschrift, mehrzeiliger Kommentar, verborgenes Passwort oder eine Zahl mit einem Kästchen pro Ziffer.
In einem echten PDF ansehen
Ein zweiseitiger Dienstleistungsvertrag
Ein Dienstleistungsvertrag über zwei Seiten, in dem keine Klausel je durch einen Seitenwechsel halbiert wird, mit Feldern für Unterschrift, Name und Datum am Ende, die am Bildschirm ausgefüllt werden.
Das PDF öffnen Das vollständige Beispiel ansehen
Auch zu sehen in: Ein archivierbares PDF/A-3-Formular · Ein interaktives Formular
Zusammenfassung
Das leere Feld eines Formulars, in das der Leser eine Antwort direkt am Bildschirm eintippt, ohne dass etwas gedruckt wird. Sie wählen, wo es sitzt, welche Schrift es verwendet und ob der Text links, mittig oder rechts steht. Ein Kommentarfeld nimmt mehrere Zeilen an; ein Passwort zeigt Punkte statt Buchstaben; und eine Referenznummer kann in kleine Kästchen geteilt werden, eines pro Zeichen, wie es amtliche Formulare tun.
Technisch
Angefordert mit
"type": "text_field"
Ein Textfeld ist eine /Widget-Annotation und ein Feld /FT /Tx im AcroForm, über das gelegt, was die anderen Elemente gezeichnet haben: Es begnügt sich mit den bereits vorhandenen Seiten, und ein leeres Feld lässt die Seite unverändert, wobei der Rahmen ihm seinen Umriss gibt. Der Anfangswert /V und der Wert, den ein Zurücksetzen wiederherstellt, /DV, werden getrennt angegeben, sodass ein Formular ausgefüllt beginnen und sich beim Zurücksetzen leeren kann. Die /Ff-Bits tragen mehrzeilig, Passwort und Kammfeld, und der Kammmodus setzt die /MaxLen voraus, die das Feld unterteilt. Der Name des Feldes ist das, was ein ausgefülltes Formular meldet, und zugleich das Ziel der Aktionen zum Senden und Zurücksetzen.
Anfrageschema
Erforderliche Schlüssel: name, eine Zeichenkette; rect; font; font_size. Optionale Schlüssel des Feldes selbst: value, der Anfangswert; default_value, der Wert, den ein Zurücksetzen wiederherstellt; multiline, password und comb, boolesche Werte, standardmäßig false; max_length, eine Ganzzahl; align, einer der Werte left (Standard), center oder right. Optionale Schlüssel, die jedes Feld teilt: read_only, required, no_export, boolesche Werte, standardmäßig false; background, die Farbe hinter dem Feld; border, ein Objekt mit erforderlichem width, einer color (standardmäßig Schwarz, als Lichtfarbe angegeben: Grau oder RGB) und einem style aus "solid" (Standard), {"dashed": {"lengths": …}}, "beveled", "inset" oder "underline"; tooltip, eine Zeichenkette, wofür das Feld da ist und unter welchem Namen ein Screenreader es ansagt; mapping_name, eine Zeichenkette, der Name, unter dem ein gesendetes Formular die Antwort meldet, wenn es nicht der eigene name des Feldes ist; flags, ein Objekt, das angibt, was eine Anzeigesoftware außer dem Zeichnen mit dem Widget tut, genau so geschrieben wie bei einer über eine Seite gelegten Prüfmarkierung, fehlt es, wird das Feld gedruckt und sonst nichts gesagt; description, eine Zeichenkette, was das Widget demselben Screenreader sagt; triggers, ein Objekt, das eine Aktion pro Zeitpunkt nennt; pages, ein Array von ab eins gezählten Ganzzahlen, standardmäßig leer; relative_to, ein Objekt aus id, edge, offset und einem optionalen part. Gegenseitige Ablehnungen: comb ohne max_length; eine CMYK-Farbe oder eine Farbe eines benannten Farbraums in border.color. Die zehn Zeitpunkte sind enter, der Zeiger kommt über das Feld; exit, der Zeiger verlässt es; down, die Zeigertaste wird darüber gedrückt; up, diese Taste wird darüber losgelassen; focused und blurred, das Feld erhält den Eingabefokus und verliert ihn; page_opened und page_closed, die Seite, auf der das Feld steht, wird geöffnet und geschlossen; page_shown und page_hidden, diese Seite kommt in den Blick und verschwindet daraus. Ein weggelassener Zeitpunkt fehlt auch in der Datei, und ein Feld, das zusätzlich eine action trägt, folgt dieser statt up. Ein Dokument, das pdfua2 beansprucht, verlangt, dass jedes Feld ein tooltip oder eine description trägt; eines, das einen anderen Teil von PDF/A als den vierten beansprucht, enthält überhaupt kein Feld, das etwas auslöst, und die Erzeugung wird abgelehnt, wobei pdfa4 und pdfa4f eines durchlassen. Ein Dokument, das irgendeinen Teil von PDF/A beansprucht, enthält kein Feld, dessen flags es verbergen, unsichtbar machen oder vom Bildschirm oder vom Papier fernhalten, und die Erzeugung wird abgelehnt: Jede Annotation einer Archivdatei wird gedruckt und angezeigt. Drei weitere Schlüssel teilt jedes Feld: highlight, einer der Werte none, invert, outline und push, was die Anzeigesoftware zeigt, solange das Feld gedrückt gehalten wird; layer, der Name einer deklarierten Ebene, mit der das Feld ein- und ausgeblendet wird; tab_rank, eine Ganzzahl, der Platz des Feldes in der Reihenfolge, die die Tabulatortaste durchläuft, die niedrigste zuerst, wobei ein Feld ohne Angabe nach jedem eingestuften kommt. Ein Textfeld, ein Auswahlfeld und eine Schaltfläche nehmen außerdem text_color an, eine als Lichtfarbe angegebene Farbe, standardmäßig Schwarz; und rotation, einer der Werte upright (Standard), quarter, half und three_quarters, wie weit der Inhalt im Kasten gegen den Uhrzeigersinn gedreht wird. Jedes Feld nimmt außerdem mark an, die Bezeichnung, über die der structure-Baum es mit den annotations eines Knotens beansprucht. Ein Feld, das eigenen Text zeichnet, nimmt außerdem text_stroke an, eine um jeden Buchstaben über seiner Füllung gezogene Kontur, {"width": 0.5, "color": [0, 0.2, 0.6]}, schwarz, wo die Farbe fehlt. Ein Textfeld nimmt außerdem file_select, do_not_spell_check und do_not_scroll an, boolesche Werte, standardmäßig false: Das Eingetippte ist der Pfad einer Datei, die das Formular an seiner Stelle sendet; die Anzeigesoftware prüft die Rechtschreibung nicht; die Anzeigesoftware nimmt keine Zeichen mehr an, sobald das Feld voll ist. Eine font_size von 0 bittet die Anzeigesoftware, den Text an das Feld anzupassen. Weitere gegenseitige Ablehnungen: comb neben multiline, password oder file_select.
Eine vollständige Anfrage, die ein PDF erzeugt
{
"standard_fonts": [{"name": "sans", "face": "helvetica"}],
"items": [
{
"type": "text_field",
"name": "customer",
"align": "left",
"rect": {"llx": 72, "lly": 700, "urx": 300, "ury": 718},
"font": "sans",
"font_size": 11,
"border": {"width": 0.75, "style": "underline"}
},
{
"type": "text_field",
"name": "office",
"value": "For office use",
"rotation": "quarter",
"rect": {"llx": 540, "lly": 500, "urx": 556, "ury": 760},
"font": "sans",
"font_size": 11,
"border": {"width": 0.75}
}
]
}Formularfelder
Ein Kästchen zum Ankreuzen Eine Liste zum Auswählen Mehrere Schaltflächen, eine Antwort Der für eine Signatur freigehaltene Platz Eine Schaltfläche zum Drücken
Wohin als Nächstes
Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen zweiundzwanzig Dinge, die Sie zeichnen können