Zuletzt geändert am:
Die fachliche Semantik der gemeinsamen Formcentric-Keys ist zentral in Client (Allgemein) dokumentiert.
Diese Seite beschreibt daher vor allem die SDK-Schreibweise, das Verhalten von mount() und die SDK-spezifischen Optionen.
Der erste Parameter von mount() ist das Zielelement.
Unterstützt werden:
'#my-form'HTMLElementDas Zielelement muss im Browser-DOM vorhanden sein, wenn mount() aufgerufen wird.
Die gemeinsame Semantik dieser Felder ist in Client (Allgemein) beschrieben.
Im SDK heißen die entsprechenden Keys:
| SDK-Key |
embedId |
formDefinition |
srcUrl |
dataUrl |
designUrl |
Das npm-SDK verwendet die in @formcentric/client enthaltene Runtime und akzeptiert formappUrl nicht; untypisiert übergebene Werte werden mit einer Warnung ignoriert. Runtime-URLs für formcentric.js beschreibt Runtime & Auslieferung.
Die gemeinsame Semantik dieser Felder ist in Client (Allgemein) beschrieben.
Im SDK heißen die entsprechenden Keys:
| SDK-Key |
themeUrl |
themeVariableUrl |
themeVariables |
templateUrl |
themeDir |
theme |
skipThemeLoad |
skipTemplatesLoad |
skipFormLoad |
Die gemeinsame Semantik dieser Felder ist in Client (Allgemein) beschrieben.
Im SDK heißen die entsprechenden Keys:
| SDK-Key |
vars |
params |
refs |
token |
requestHeaders |
formName |
instanceId |
env |
configuration |
Die gemeinsame Semantik von Sprache, Locale und Übersetzungen ist in Client (Allgemein) beschrieben. Im SDK heißen die entsprechenden Keys language, locale, localesPath und locales.
Beispiel:
Gebündelte SDK-Integrationen können alternativ ein locales-Objekt direkt übergeben. Das ist der empfohlene Weg, wenn Sie date-fns- und Upload-Locale-Objekte einschließlich ihrer Funktionen bereitstellen möchten.
Der folgende Ausschnitt zeigt die Struktur; ergänzen Sie unter resources die benötigten Formcentric-Übersetzungen. Die Regeln für vorhandene und neue Sprachen stehen in Client (Allgemein) unter Konfiguration → Eigene Übersetzungen einbinden.
Die gemeinsame Semantik von maxWidth, height und debug ist in Client (Allgemein) beschrieben.
Beispiel:
Die fachliche Semantik von parentUrl ist in Client (Allgemein) beschrieben. Im SDK wird derselbe gemeinsame Key direkt als parentUrl verwendet.
Beispiel:
Wenn parentUrl nicht explizit gesetzt ist, wird die aktuelle Seiten-URL als Rücksprungkontext verwendet.
Das SDK unterstützt die folgenden Mount-Konfigurationsfelder:
embedId oder formDefinition muss gesetzt sein.data-fc-* Attribute am Ziel-Element werden nicht als Live-Konfigurationsquelle verwendet.conflictBehavior steht bei direkten SDK-Mounts standardmäßig auf 'throw'.embedId gewünscht ist, sollte conflictBehavior: 'stop-existing' gesetzt werden.skipThemeLoad und skipTemplatesLoad werden nur berücksichtigt, wenn sie explizit gesetzt sind.vars, params, themeVariables und configuration sollten als serialisierbare Objekte übergeben werden. locales ist die Ausnahme: Es enthält date-fns- und Upload-Locale-Objekte einschließlich ihrer Funktionen und wird per Referenz übergeben.data-fc-watch ist Static-only und wird bei SDK-Mounts ignoriert.
