Modeldefinities, velden en componenttypen field-types
In het deelvenster Eigenschappen vindt u voorbeelden van velden en componenttypen die de Universal Editor kan bewerken. Begrijp hoe u uw eigen app kunt instrumenteren door een modeldefinitie te maken en aan de component te koppelen.
Overzicht overview
Wanneer u uw eigen toepassingen aanpast voor gebruik met de universele editor, moet u de componenten van instrumenten voorzien en definiëren welke velden en componenttypen ze kunnen manipuleren in het deelvenster Eigenschappen van de editor. U doet dit door een model te creëren en met dat van de component te verbinden.
Dit document biedt een overzicht van een modeldefinitie en van de velden en componenttypen waarover u beschikt, samen met voorbeeldconfiguraties.
Modeldefinitiestructuur model-structure
Als u een component wilt configureren via het deelvenster Eigenschappen in de Universal Editor, moet er een modeldefinitie bestaan en aan de component zijn gekoppeld.
De modeldefinitie is een JSON-structuur, te beginnen met een array van modellen.
[
{
"id": "model-id", // must be unique
"fields": [] // array of fields which shall be rendered in the properties panel
}
]
Zie de sectie van Gebieden van dit document voor meer informatie over hoe te om uw fields
serie te bepalen.
U kunt een model aan een component op twee manieren verbinden: het gebruiken van de componentendefinitieof via de instrumentatie.
Koppelen met gebruik van componentdefinitie component-definition
Dit is de voorkeursmethode voor het koppelen van het model aan de component. Hierdoor kunt u de koppeling centraal behouden in de componentdefinitie en kunt u componenten over containers slepen.
Neem gewoon de eigenschap model
op in het componentobject in de components
-array in het component-definition.json
-bestand.
Voor details, gelieve te zien de document Definitie van de Component.
Koppeling met behulp van instrumentatie instrumentation
Als u de modeldefinitie met een component wilt gebruiken, kunt u het attribuut data-aue-model
gebruiken.
<div data-aue-resource="urn:datasource:/content/path" data-aue-type="component" data-aue-model="model-id">Click me</div>
- Projecten die de koppeling naar het model via de instrumenten hebben geïmplementeerd, zullen ongewijzigd blijven werken en hoeven niet te worden gewijzigd.
- Als u het model in de componentendefinitieevenals in de instrumentatie bepaalt, zal de instrumentatie altijd worden gebruikt.
Modeldefinitie laden loading-model
Wanneer een model is gemaakt, kan ernaar worden verwezen als een extern bestand.
<script type="application/vnd.adobe.aue.model+json" src="<url-of-model-definition>"></script>
U kunt het model ook inline definiëren.
<script type="application/vnd.adobe.aue.model+json">
{ ... model definition ... }
</script>
Velden fields
Een veldobject heeft de volgende typedefinitie.
component
ComponentType
name
string
label
FieldLabel
description
FieldDescription
placeholder
string
value
FieldValue
valueType
ValueType
string
, string[]
, number
, date
, boolean
zijnrequired
boolean
readOnly
boolean
hidden
boolean
condition
RulesLogic
multi
boolean
validation
ValidationType
raw
unknown
Componenttypen component-types
Hieronder vindt u de componenttypen die u kunt gebruiken voor het weergeven van velden.
aem-tag
aem-content
boolean
checkbox-group
container
aem-content-fragment
date-time
aem-experience-fragment
multiselect
number
radio-group
reference
richtext
select
tab
text
AEM-tag aem-tag
Een AEM-tagcomponenttype maakt een AEM-tagkiezer mogelijk, die kan worden gebruikt om tags aan de component te koppelen.
code language-json |
---|
|

AEM Content aem-content
Een AEM-inhoudcomponenttype maakt een AEM-inhoudkiezer mogelijk, die kan worden gebruikt om een willekeurige AEM-bron te selecteren. In tegenstelling tot de verwijzingscomponent, die slechts activa kan selecteren, kan de de inhoudscomponent van AEM van verwijzingen voorzien de inhoud van AEM. Het biedt een aanvullend validatietype aan.
rootPath
string
code language-json |
---|
|

Boolean boolean
Een type van booleaanse component slaat een eenvoudige waar/vals waarde op die als knevel wordt teruggegeven. Het biedt een aanvullend validatietype aan.
customErrorMsg
string
code language-json |
---|
|
code language-json |
---|
|

Groep selectievakjes checkbox-group
Net als bij een booleaanse component staat een componenttype voor selectievakjes het selecteren van meerdere true/false-items toe, die als meerdere selectievakjes worden weergegeven.
code language-json |
---|
|

Container container
Met een containercomponenttype kunnen componenten worden gegroepeerd. Het biedt een extra configuratie aan.
collapsible
boolean
code language-json |
---|
|

Inhoudsfragment content-fragment
De plukker van het Fragment van de Inhoud kan worden gebruikt om a het Fragment van de Inhouden zijn variaties (indien vereist) te selecteren. Het biedt een extra configuratie aan.
variationName
string
Het biedt ook een aanvullend validatietype.
rootPath
string
code language-json |
---|
|

Datum en tijd date-time
Met een componenttype voor datumtijd kunt u een datum, tijd of combinatie daarvan opgeven. Het biedt extra configuraties aan.
displayFormat
string
valueFormat
string
Het biedt ook een aanvullend validatietype.
customErrorMsg
string
valueFormat
niet wordt gehaaldcode language-json |
---|
|
code language-json |
---|
|

Ervaar fragment experience-fragment
De plukker van het Fragment van de Ervaring kan worden gebruikt om een Fragment van de Ervaringen zijn variaties (indien vereist) te selecteren. Het biedt een extra configuratie aan.
variationName
string
Het biedt ook een aanvullend validatietype.
rootPath
string
code language-json |
---|
|

Multiselect multiselect
Een multiselect componenttype stelt veelvoudige punten voor selectie in een drop-down met inbegrip van de capaciteit voor om de selecteerbare elementen te groeperen.
code language-json |
---|
|
code language-json |
---|
|


Getal number
Een type van aantalcomponent staat voor de input van een aantal toe. Er zijn aanvullende validatietypen.
numberMin
number
numberMax
number
customErrorMsg
string
numberMin
of numberMax
niet wordt gehaaldcode language-json |
---|
|
code language-json |
---|
|

Groep keuzerondjes radio-group
Een componenttype voor een groep keuzerondjes maakt het mogelijk om meerdere opties die als een groep worden gerenderd, uit te sluiten, net als een groep selectievakjes.
code language-json |
---|
|

Referentie reference
Een type van verwijzingscomponent laat een de activakiezer van AEM toe, die kan worden gebruikt om om het even welk element van AEM te selecteren waarnaar te verwijzen. In tegenstelling tot de de inhoudscomponent van AEM, die om het even welk middel van AEM kan selecteren, kan de verwijzingscomponent slechts activa van verwijzingen voorzien. Het biedt een aanvullend validatietype aan.
Een type referentiecomponent maakt een verwijzing naar een ander gegevensobject van het huidige object mogelijk.
code language-json |
---|
|

RTF rich-text
RTF-tekst staat toe dat tekst met meerdere regels wordt ingevoerd.
code language-json |
---|
|

Selecteren select
Met een componenttype select kunt u één optie selecteren in een lijst met vooraf gedefinieerde opties in een vervolgkeuzemenu.
code language-json |
---|
|

Tab tab
Met een componenttype tab kunt u andere invoervelden groeperen op meerdere tabbladen om de indeling van de auteurs te verbeteren.
Een definitie tab
kan worden beschouwd als een scheidingsteken in de array van fields
. Alles wat na een tab
wordt geleverd, wordt op dat tabblad geplaatst totdat er een nieuwe tab
wordt gevonden. Hierna worden de volgende items op het nieuwe tabblad geplaatst.
Als u items boven alle tabbladen wilt weergeven, moet u deze vóór alle tabbladen definiëren.
code language-json |
---|
|

Tekst text
Met tekst kunt u één regel tekst invoeren. Het bevat aanvullende validatietypen.
minLength
number
maxLength
number
regExp
string
customErrorMsg
string
minLength
, maxLength
en/of regExp
wordt/worden overtredencode language-json |
---|
|
code language-json |
---|
|
