[AEM Forms]{class="badge positive" title="van toepassing op AEM Forms)."}
Object Scope in aangepaste functies
In Adaptief Forms wordt een bereikobject als laatste argument doorgegeven aan functies wanneer een regel wordt uitgevoerd. Deze kan worden gebruikt om formulier-/veldeigenschappen te lezen en het formulier vanuit de functies te wijzigen. Het bereikobject bevat een alleen-lezen proxyobject voor het formulier, de getriggerde gebeurtenis en het doelveld. De eigenschappen van het formulier en het veld zijn toegankelijk via het object scope door $ toe te voegen, bijvoorbeeld scope.form.$id en scope.field.$id .
Formulierwijzigingfuncties met bereikobject
Object Scope heeft de volgende functies voor formulierwijziging:
Functie
Syntaxis
Beschrijving
Codevoorbeeld
setProperty
setProperty(any $element, any $payload)Hiermee wordt een eigenschap op het doelveld ingesteld met de eigenschap
$payload . klik hier om het voorbeeld te bekijken.
bevestigt
validate([any $element])Hiermee wordt validatie uitgevoerd op het doelveld. Hiermee wordt validatie uitgevoerd op het gehele formulier als er geen doel is opgegeven, en wordt een array met validatiefouten geretourneerd.
klik hier om het voorbeeld te bekijken.
teruggestelde (afgekeurd)
reset([any $element])Vervangen. Gebruik in plaats hiervan
dispatchEvent($target, 'reset') . Hiermee herstelt u het doelveld of, als er geen doel is opgegeven, herstelt u het hele formulier. klik hier om het voorbeeld te bekijken.
importData
importData(any $payload)Hiermee importeert u gegevens in het formulier, waarbij bestaande formuliergegevens worden vervangen. Als
qualifiedName is opgegeven, worden alleen gegevens in dat containerveld geïmporteerd. klik hier om het voorbeeld te bekijken.
exportData
exportData()Retourneert de gegevens van het formulier.
klik hier om het voorbeeld te bekijken.
submitForm
submitForm(any $data [, boolean $validate_form = true, string $submit_as = 'multipart/form-data'])Triggert een verzonden formulier. U kunt opgeven wat u wilt verzenden via de parameter
$payload en het inhoudstype instellen via de parameter $contentType . Gegevens worden standaard verzonden als multipart/form-data . Met de optionele parameter $validateForm wordt opgegeven of het formulier moet worden gevalideerd vóór verzending (standaard: true). Als de bewerking succesvol is, wordt submitSuccess geactiveerd; als de bewerking mislukt, wordt submitError geactiveerd. klik hier om het voorbeeld te bekijken.
setFocus
setFocus(any $element [, FocusOption $focusOption])Hiermee wordt de focus ingesteld op het doelveld, dat een deelvenster of formulierveld kan zijn. Als geen doel wordt verstrekt, wordt de nadruk geplaatst aan het gebied dat de regel teweegbracht. Met de optionele parameter
$focusOption wordt opgegeven of het volgende of vorige item ten opzichte van het doel de focus moet krijgen. Ondersteunde waarden: 'nextItem', 'previousItem' . Bij gebruik met een deelvenster blijft de navigatie beperkt tot dat deelvenster. Indien gebruikt met een veld, vindt navigatie plaats binnen het bovenliggende deelvenster van dat veld. klik hier om het voorbeeld te bekijken.
dispatchEvent
dispatchEvent(any $element, string $eventName [, any $payload])Verzendt een gebeurtenis van het type
$eventName op het element dat door $target wordt bepaald. Als er geen doel is opgegeven, wordt de gebeurtenis verzonden op het formulier. De optionele $payload is beschikbaar voor expressies die de gebeurtenis afhandelen. De optionele parameter $dispatch bestuurt het gedrag van de gebeurtenisdoorgave. klik hier om het voorbeeld te bekijken.
markFieldAsInvalid
markFieldAsInvalid(string $fieldIdentifier, string $validationMessage [, any $option = {useId: true}])Hiermee markeert u het veld dat door
$fieldIdentifier wordt aangegeven als ongeldig en geeft u $validationMessage weer. De optionele parameter $option geeft aan of $fieldIdentifier wordt geïnterpreteerd als id , dataRef of qualifiedName . De standaardwaarde is {useId: true} . Ondersteunde waarden: {useId: true}, {useDataRef: true}, {useQualifiedName: true} . klik hier om het voorbeeld te bekijken.
Zie ook
- Inleiding aan de Redacteur van de Regel voor AanpassingsForms die op de Componenten van de Kern wordt gebaseerd
- De types en de gebeurtenissen van de exploitant in regelredacteur van een Adaptief Vorm die op de Componenten van de Kern wordt gebaseerd
- De Redacteur van de regel Gebruikersinterface voor Adaptieve Forms die op de Componenten van de Kern wordt gebaseerd
- Verschillende gevallen van gebruik van de Rule Editor voor een adaptief formulier op basis van kerncomponenten
- Verschil in verschillende versies van de redacteur van de Regel
- Asynchrone functies in een adaptief formulier gebruiken
- De verhogingen van de Dienst van de aanwending in de Visuele Redacteur van de Regel voor vormen die op de Componenten van de Kern worden gebaseerd
- Inleiding tot aangepaste functies voor adaptieve Forms op basis van kerncomponenten
- Een aangepaste functie maken voor een adaptief formulier op basis van kerncomponenten
- Object Scope in aangepaste functies
- Voorbeelden van het ontwikkelen en gebruiken van een aangepaste functie
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab