DocumentatieAEM 6.5Handboek

Aangepaste weergaven maken in HTML5-formulieren create-custom-appearances-in-html-forms

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beheerder
  • Gebruiker
  • Ontwikkelaar

U kunt aangepaste widgets aansluiten op een mobiele Forms. U kunt bestaande jQuery-widgets uitbreiden of uw eigen aangepaste widgets ontwikkelen met het raamwerk voor weergaven. De motor XFA gebruikt diverse widgets, zie Kader van de Verschijning voor aanpassings en HTML5 vormenvoor gedetailleerde informatie.

Een voorbeeld van gebrek en douane widget

Een voorbeeld van de standaard- en aangepaste widget

Aangepaste widgets integreren met HTML5-formulieren integrating-custom-widgets-with-html-forms

Een profiel maken  create-a-profile-nbsp

U kunt een profiel maken of een bestaand profiel kiezen om een aangepaste widget toe te voegen. Voor meer informatie bij het creëren van profielen, zie Creërend douaneProfiel.

Een widget maken create-a-widget

HTML5-formulieren bieden een implementatie van het widgetframework dat kan worden uitgebreid om nieuwe widgets te maken. De implementatie is een widget jQuery abstractWidget die kan worden uitgebreid om een nieuwe widget te schrijven. De nieuwe widget kan alleen functioneel worden gemaakt door de hieronder vermelde functies uit te breiden of te overschrijven.

Functie/klasse
Beschrijving
renderen
De renderfunctie retourneert het jQuery-object voor het standaard HTML-element van de widget. Het standaardelement van HTML zou van brandpuntsafhankelijk type moeten zijn. Bijvoorbeeld <a>, <input> en <li>. Het geretourneerde element wordt gebruikt als $userControl. Als $userControl de bovengenoemde beperking specificeert, dan werken de functies van de klasse AbstractWidget zoals verwacht, anders vereisen sommige gemeenschappelijke APIs (nadruk, klik) veranderingen.
getEventMap
Retourneert een kaart om HTML-gebeurtenissen om te zetten in XFA-gebeurtenissen.

vervagen: XFA_EXIT_EVENT,

Dit voorbeeld toont aan dat de vervaging een HTML-gebeurtenis is en XFA_EXIT_EVENT corresponderende XFA-gebeurtenis.
getOptionsMap
Retourneert een kaart die gedetailleerde informatie bevat over de handeling die moet worden uitgevoerd bij wijziging van een optie. De sleutels zijn de opties die aan widget worden verstrekt en de waarden zijn de functies die worden geroepen wanneer een verandering in die optie wordt ontdekt. De widget biedt handlers voor alle algemene opties (behalve value en displayValue)
getCommitValue
Het widgetframework laadt de functie wanneer de waarde van de widget wordt opgeslagen in het XFAModel (bijvoorbeeld bij afsluitgebeurtenis van een textField). De implementatie moet de waarde retourneren die is opgeslagen in de widget. De handler krijgt de nieuwe waarde voor de optie.
showValue
Standaard wordt in XFA bij Enter de rawValue van het veld weergegeven. Deze functie wordt aangeroepen om de rawValue aan de gebruiker te tonen.
showDisplayValue
Standaard wordt in XFA bij afsluitgebeurtenis de formattedValue van het veld weergegeven. Deze functie wordt geroepen om formattedValue aan de gebruiker te tonen.

Als u uw eigen widget wilt maken, neemt u in het profiel dat hierboven is gemaakt verwijzingen op naar het JavaScript-bestand dat overschreven functies en toegevoegde functies bevat. Bijvoorbeeld, is sliderNumericFieldWidget een widget voor numerieke Gebieden. Als u de widget in uw profiel in de koptekstsectie wilt gebruiken, neemt u de volgende regel op:

window.formBridge.registerConfig("widgetConfig" , widgetConfigObject);

Aangepaste widget registreren met XFA Scripting Engine  register-custom-widget-with-xfa-scripting-engine-nbsp

Wanneer de code van de douanewidget klaar is, registreer widget met de scripting motor door registerConfig API voor Vorm Bridgete gebruiken. Het neemt widgetConfigObject als input.

window.formBridge.registerConfig("widgetConfig",
        {
        ".<field-identifier>":"<name-of-the-widget>"
        }
    );

widgetConfigObject widgetconfigobject

De widgetconfiguratie wordt aangeboden als een JSON-object (een verzameling sleutelwaardeparen), waarbij de sleutel de velden identificeert en de waarde de widget vertegenwoordigt die met deze velden moet worden gebruikt. Een voorbeeldconfiguratie ziet er als volgt uit:

*{*

*"identifier1" : "customwidgetname",
"identifier2" : "customwidgetname2",
..
}*

waarbij "id" een jQuery CSS-kiezer is die een bepaald veld, een set velden van een bepaald type of alle velden vertegenwoordigt. In het volgende voorbeeld wordt de waarde van de id in verschillende gevallen weergegeven:

Type id
Id
Beschrijving
Specifiek veld met naam van veld
Id:"div.fieldName"
Alle velden met de naam 'veldnaam' worden weergegeven met de widget.
Alle velden van het type ‘type’ (waarbij het type NumericField, DateField enzovoort is).:
Id: "div.type"
Voor Tijdveld en DateTimeField is het type tekstveld omdat deze velden niet worden ondersteund.
Alle velden
Id: "div.field"
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2