Formateringskonstruktioner för adaptiva formulär styling-constructs-for-adaptive-forms

Adobe rekommenderar att man använder modern och utbyggbar datainhämtning Kärnkomponenterfor skapa ny Adaptive Formseller lägga till adaptiv Forms på AEM Sites-sidor. De här komponenterna utgör ett betydande framsteg när det gäller att skapa adaptiva Forms-filer, vilket ger imponerande användarupplevelser. I den här artikeln beskrivs det äldre sättet att skapa Adaptiv Forms med baskomponenter.

Förutsättningar prerequisites

Kunskap om CSS och LESS Framework.

Vad kan anpassas what-can-be-customized

I artikeln listas allmänt tillgängliga CSS-klasser för adaptiva formulär. Du kan använda dessa klasser för att formatera olika komponenter i ett anpassat formulär. Formateringen av redigeringskomponenter, t.ex. dialogrutor och statusfält som visar varningar, ligger utanför artikelns omfång. Använd dessa formateringskonstruktioner för att skapa format (med CSS eller Less) endast när du inte kan formatera komponenter med temaredigerare.

Anpassa format i anpassningsbara formulär customizing-styles-in-adaptive-forms

Med LESS-ramverket blir det enklare att anpassa format i anpassningsbara formulär. I ramverket kan du definiera format med hjälp av en uppsättning variabler och funktioner (mixins). LESS-ramverket hjälper till att minska storleken på den paketerade koden och ökar dess återanvändbarhet.

Du kan anpassa anpassade formulärformat på följande sätt:

  • Ändra temat
  • Ändra komponentens stil

Ändra tema changing-theme

Du kan ändra temat för ett anpassat formulär för att se till att det ser ut som på de webbsidor där det anpassade formuläret är inbäddat.

Ändringar av det övergripande utseendet på det adaptiva formuläret med hjälp av CSS-egenskaper är vanligtvis en del av temaförändringar. Stora förändringar av logotypen"ok och känsla i den adaptiva formen, t.ex. ändringar av komponenternas layout och placering, betraktas inte som temaförändringar.

Baserat på Bootstrap definierar följande uppsättning CSS-egenskaper temat för en webbsida:

  • Bakgrundsfärg
  • Kant (text, färg, tjocklek)
  • Teckenfärg
  • Utfyllnad
  • Marginal
  • Teckenstorlek
  • LineHeight

För närvarande definieras LESS-variabler bara för dessa egenskaper för de olika elementen i en adaptiv form.

Ändra komponentstil changing-component-style

Du kan ändra utseende, layout, placering och synlighet för element. För att utföra den här uppgiften skapar eller uppdaterar du dina anpassade css-filer så att de innehåller de formateringskonstruktioner som listas i den här artikeln.

Om du vill använda ett format på ett anpassat formulär öppnar du det adaptiva formuläret i för redigering, öppnar egenskaper för adaptiv formulärbehållare och anger sökvägen till en anpassad CSS-fil på fliken Grundläggande. Standardformateringskonstruktioner för det adaptiva formuläret och åsidosätts av de konstruktioner som anges i den anpassade css-filen.

Komponenter components

Komponenterna som beskrivs i den här artikeln har sina fördefinierade CSS-klasser. Du kan redigera variablerna om du vill ändra formaten i CSS-klasserna. Du kan också skriva om hela klassen. I det här avsnittet beskrivs klasserna i komponenter och format som du kan ändra med variabler.

Behållarformat container-styling

En behållare är komponenten på den översta nivån. Andra paneler och fält ligger under behållarkomponenten.

CSS, klass
guideContainerNode
Variabelbeskrivning
Variabelbeskrivning
container-bgColor
Behållarens bakgrundsfärg
container-padding
Utfyllnad för behållaren
container-margin
Behållarens marginal
container-fontColor
Teckenfärg för behållaren

Fältformat field-styling

Anpassningsbara formulär innehåller olika typer av fält. Varje fält har ett unikt klassnamn, som är fältets namn. Fältet har också ett vanligt klassnamn guideFieldNode.

Fälten innehåller etiketter, widgetar, hjälpbeskrivning (både lång och kort beskrivning) och hjälpikoner (frågetecken).

CSS, klass
guideFieldNode
Variabel
Beskrivning
field-padding
Utfyllnad för fältet
field-error-font-color
Teckenfärg för felmeddelandet i fältet
field-error-font-size
Teckensnittsstorlek för felmeddelandet i fältet

Etikettformat label-styling

Elementet HTML label som används för fältet innehåller klasserna vänster eller top beroende på om etiketten är högst upp eller till vänster.

CSS, klass
guideFieldLabel
Variabel
Beskrivning
label-font-color
Teckenfärg för fältetiketten
label-font-size
Teckensnittsstorlek för fältetiketten
label-line-height
Egenskapen CSS-radhöjd för fältetiketten
label-font-weight
Egenskapen CSS-teckensnittsvikt för fältetiketten
label-margin
Marginal för fältetiketten

CSS-reglerna för etiketten tillämpas med guideFieldLabel etikett. Om du är författare åsidosätter du den här regeln för att göra dina anpassade ändringar synliga.

Widgets-format widgets-styling

Beroende på typ innehåller widgetar även klasser. Vanligtvis innehåller widgetarna guideFieldWidget klassen. De widgetar som levereras med HTML använder normalt elementindata och markering för standardelementet HTML. Formateringen görs därefter. Du kan inte formatera en anpassad widget genom att ändra variablerna.

CSS, klass
guideFieldWidget
Variabel``
Beskrivning
widgets-bg-color
Bakgrundsfärg för widgetar (fungerar inte för kryssrutor och alternativknappar)
widgets-border-color
Kantfärg för widgetar
widgets-border-thickness
Kantstorlek för widgetar
widgets-border-radius
Kantradie för widgetar
widgets-border-type
Kanttyp för widgetar
widget-border-focus-type
Fokusera typ för widgetkanter
widgets-border
Konsoliderad kantlinjestil för widgetar
widgets-font-color
Textens färg i widgeten
widgets-font-size
Storlek på texten i widgeten
widgets-line-height
CSS-egenskapen lineheight för widgeten
widgets-padding
CSS-utfyllnadsegenskap för widgeten
widgets-focus-border-color
Kantfärg när widgeten är i fokus
widgets-mandatory-border-color
Kantfärg för widgeten för de obligatoriska fälten
widgets-mandatory-bg-color
Bakgrundsfärg för widgeten för de obligatoriska fälten
widgets-disabled-bg-color
Bakgrundsfärg för widgeten när fältet är inaktiverat
widgets-disabled-font-color
Teckenfärg för widgeten när fältet är inaktiverat
widgets-disabled-border-color
Kantfärg för widgeten när fältet är inaktiverat
widget-height
Widgetens höjd (fungerar inte för kryssrutor och alternativknappar)
checkbutton-height
Höjd för kryssruta och alternativknapp.
listboxwidget-height
Maximal höjd för en flervalslistruta

Begränsningar i widgetformat limitations-in-widget-styling

Formateringen för fokuserade, obligatoriska och inaktiverade fält är begränsad med hjälp av variabler. Du kan dock ändra den genom att åsidosätta formaten. Begränsningar med hjälp av variabler anges huvudsakligen för att hålla antalet variabler under kontroll. Begränsningen kan förenklas om utseendet på ett fält ändras drastiskt eftersom det är i något av de lägen som diskuterades tidigare.

Hjälpbeskrivning help-description

En författare kan ange hjälpinnehåll i fälten med hjälp av komponenterna för kort och lång beskrivning. Båda komponenterna har en gemensam klass .guideHelpDescription och en annan klass .long/ .short, beroende på typen av beskrivning. Hjälpinnehållet omsluts av ett styckeelement för att åsidosätta formateringen av beskrivningen. Hjälpbeskrivningen (både lång och kort) ändras med variabler som börjar med widgetshelp, vilket anges i följande tabell:

Variabel
Beskrivning
widgets-help-long-bg-color
Bakgrundsfärg för widgetens långa hjälp
widgets-help-long-border-color
Kantfärg för widgetens långa hjälp
widgets-help-long-border-indicator-color
Den vänstra indikatorns kantlinjefärg för widgetens långa hjälp
widgets-help-short-bg-color
Bakgrundsfärg för widgetens korta hjälp
widgets-help-short-color
Teckenfärg för widgetens korta hjälp
widgets-help-short-tooltip-bg-color
Bakgrundsfärg för widgetens korta verktygstips Hjälp
widgets-help-short-tooltip-color
Teckenfärg för widgetens korta verktygstips Hjälp

Villkor terms-and-conditions

Villkor (TnC) ``) kan du ange villkor. Du kan anpassa widgeten med hjälp av de variabler som beskrivs i följande tabell.

Variabel
Beskrivning
tnc-unvisited
Teckensnittsfärg för obesökt kontaktlänk.
tnc-visited
Teckensnittsfärg för den besökta kontaktlänken.

Knapp button

Knappar är också widgetar. Men deras format skiljer sig något från widgetarna. I anpassningsbara former utgör något av följande en knapp:

  • input[type = text]
  • knapp
  • element med klass .button

HTML för knapp:

<button type="button" >

<span class="iconButtonicon"></

span>

<span class="iconButtonlabel"></

span>

</button>

CSS-klass
Beskrivning
iconButton-icon
Visar ikoner för knappen
iconButton-label
Etikett/bildtext för knappknappen Stilar
Variabel``
Beskrivning
button-border-size
Kantstorlek för knapparna
button-border-type
Kanttyp
button-padding
CSS-utfyllnadsegenskap för knappen
button-font-size
Knappens teckensnittsstorlek
button-background-color
Bakgrundsfärg för knappen
button-font-color
Knappens teckensnittsfärg
button-border-color
Kantfärg för knappen
button-large-padding
Utfyllnad för stora knappar (knappar med klassen .buttonLarge)
button-large-font-size
Teckenstorlek för stora knappar
button-small-padding
Utfyllnad för små knappar (knappar med klassen .buttonSmall)
button-small-font-size
Teckenstorlek för små knappar
button-info-background-color
Bakgrundsfärg för informativa knappar (knappar med klassen .buttoninformative)
button-info-font-color
Teckenfärg för informativa knappar
button-info-border-color
Kantfärg för informativa knappar
button-warning-background-color
Bakgrundsfärg för varningsknappar (knappar med klassen .buttonWarning)
button-warning-font-color
Teckenfärg för varningsknappar
button-warning-border-color
Kantfärg för varningsknappar
button-alert-background-color
Bakgrundsfärg för varningsknappar (knappar med klassen .buttonalert)
button-alert-font-color
Teckenfärg för varningsknappar
button-alert-border-color
Kantfärg för varningsknappar

Frågetecken question-mark

För widgetarna visas ett questionMark när en författare lägger till en lång beskrivning i hjälpinnehållet. Standardikonen som finns i Bootstrap används. Om du vill använda en anpassad ikon kan du anpassa bootstrap-ikonerna.

CSS, klass
guideHelpQuestionMark
Variabel
Beskrivning
questionmark-font-color
Ikonens färg
questionmark-hover-font-color
Färg på ikonen när muspekaren förs över den

Tabell table

Du kan ändra färgtemat för huvud- och innehållsrader i en tabell med hjälp av följande variabler.

Variabel
Beskrivning
table-header-bg-color
Bakgrundsfärg för rubrikraden. Standardvärdet är #333.
table-odd-row-bg-color
Bakgrundsfärg för den udda innehållsraden. Standardvärdet är rgb(255, 255, 255).
table-even-row-bg-color
Bakgrundsfärg för den jämna innehållsraden. Standardvärdet är #eee.

Bifogad fil file-attachment

Med widgeten Bifogad fil i adaptiva formulär kan du överföra filer. Du kan också anpassa widgeten med hjälp av variablerna.

Variabel
Beskrivning
fileItemPadding
Utfyllnad för de filer som visas i widgeten
fileItemBackground
Bakgrundsfärg för filobjektet
fileItemBorderColor
Kantfärg för den övre kanten
fileItemColor
Teckenfärg för filobjektet
filePreviewIconColor
Färg för ikonen Förhandsvisa (Bootstrap) i widgeten
fileItemCommentHeight
Höjd på kommentar för filobjektet

Det finns fyra typer av navigeringsflikar. Det finns flikar till vänster, högst upp i guiden och dragspelet. Varje navigator har en egen klass.

Navigator
CSS, klass
Accordion
.accordion-navigators
tabs on the left
.tab-navigators-vertical
tabs on the top
.tab-navigators
Wizard
.wizard-navigators

Här följer HTML-koden för tabbnavigeringselementet (liknar bootstrap-flikarna):

<li>

<a>tab title</a>

</li>

Accordion navigator is an exception, it has following barebone

structure:

<div class="accordion.navigators">

<div>

<div class = "guideHeader">

<a>

<span class = "guideSummary" ></code>

........................... repeatable buttons, if the repeatable configuration is set ................................

<div class = "repeatableButtons">

<button name="Add" class="Add"/>

<button name="Remove" class="Remove"/>

</div>

</a>

</div>

................................ panel content ..................................

</div>

</div>

Du kan ändra navigatorns format med CSS-regler som markerar elementen med underordnad väljare. Så här lägger du till ett textdekorationsformat till ankartaggen:

Fliknavigator överst:

.tab-navigators

li a {

text-decoration:

underline;

}

Tab navigator on left:

.tab-navigators-vertical

li a {

text-decoration:

underline;

}

Accordion navigator:

.accordion-navigators .guideHeader a .guideSummary {

text-decoration:

underline;

}

Wizard navigator:

.wizard-navigators

li a {

text-decoration:

underline;

}

Det finns dessutom klasser för att formatera tabbnavigatorer (både vänster och överst) baserat på om de har kapslade/underordnade/underordnade navigatorer.

CSS-klass
Beskrivning
nested_true
Tabbnavigatörer (vänster och överst) med kapslade/underordnade/underordnade navigatorer
nested_false
Tabbnavigatörer (vänster och överst) som inte har kapslade/underordnade/underordnade navigatorer

Klassen guideNavIcon innehåller en standardikon för tabbnavigering (både vänster och överst) och guidenavigatorer.

CSS, klass
guideNavIcon
NOTE
Du kan ändra ikonen för en viss navigator genom att ange en CSS-klass på panelen vid redigering, formulärexempel <class_name>. Du lägger till en <class_name>nav för navigeringsikonen.
Variabel
Beskrivning
Fliknavigatörer
navigator-bg-color
Bakgrundsfärg för hela fliknavigatorn
tabs-bg-color
Bakgrundsfärg för fliken
tabs-font-color
Teckenfärg för fliken
tabs-hover-bg-color
Bakgrundsfärg för fliken vid hovring
tabs-hover-font-color
Teckenfärg för fliken vid hovring
tabs-active-bg-color
Bakgrundsfärg när panelen är i fokus (aktiv)
tabs-active-font-color
Teckenfärg när panelen är i fokus
tabs-completed-bg-color
Bakgrundsfärg när panelens slutförandeuttryck returnerar true
tabs-completed-font-color
Teckenfärg när panelens slutförandeuttryck returnerar true
tabs-stepped-bg-color
Bakgrundsfärg när panelen har fokus en gång men slutförandeuttrycket returnerar false
tabs-stepped-font-color
Teckenfärg när panelen har fokus en gång men slutförandeuttrycket returnerar false
tabs-border-color
Kantfärg för fliken
tabs-font-size
Teckenstorlek för fliken
tabs-padding
Utfyllnad för fliken
tabs-margin
Marginal för fliken
tabs-vertical-margin
Marginal för de lodräta flikarna
tabs-border-thickness
Kantstorlek för flikarna
tabs-min-height
Flikarnas minsta höjd
heirarichal-indent
Indrag för kapslade flikar
Guidenavigatörer
wizard-navigator-bg-color
Bakgrundsfärg för hela guidenavigatorn
wizard-tabs-bg-color
Bakgrundsfärg för guiden
wizard-tabs-font-color
Teckenfärg för guiden
wizard-tabs-active-bg-color
Bakgrundsfärg när panelen är i fokus (aktiv)
wizard-tabs-active-font-color
Teckenfärg när panelen är i fokus (fokuserad)
wizard-tabs-completed-bg-color
Bakgrundsfärg när panelens slutförandeuttryck returnerar true
wizard-tabs-completed-font-color
Teckenfärg när panelens slutförandeuttryck returnerar true
wizard-tabs-stepped-bg-color
Bakgrundsfärg när panelen har fokus en gång men slutförandeuttrycket returnerar false
wizard-tabs-stepped-font-color
Teckenfärg när panelen har fokuserats en gång men slutförandeuttrycket returnerar false
wizard-tabs-border-color
Färg för guiden
wizard-tabs-font-size
Teckensnittsstorlek för guiden
wizard-tabs-padding
Utfyllnad för guiden
wizard-tabs-border-thickness
Kantstorlek för guiden
wizard-nav-bullet-border
Kantfärg för guideens navigerarpunkt (prefixera bildtexten/etiketten)
wizard-progress-bg-color
Bakgrundsfärg i guidenavigerarens förloppsindikator
wizard-progress-color
Fyllningsfärg för förloppsindikatorn
Dragspelsnavigatörer
accordion-tabs-padding
Utfyllnad för dragspel

Panelformat panel-styling

En panel innehåller ett valfritt verktygsfält och dess innehåll.

CSS, klass
guidePanelNode
Variabel
Beskrivning
panel-background-color
Bakgrundsfärg för panelen
panel-font-size
Teckensnittsstorlek för paneltexten
panel-font-color
Teckenfärg för paneltexten
panel-padding
Utfyllnad på panelen
panel-description-font-size
Teckensnittsstorlek för panelbeskrivningen
panel-description-padding
Utfyllnad av panelens beskrivning
panel-help-bg-color
Bakgrundsfärg för panelens hjälp
panel-help-border-indicator-color
Indikatorkantsfärg för panelhjälpen

Panelnoden är uppdelad i navigatorer och innehåll. Där ``är ingen separat formatkomponent för innehållet. Variablerna som beskrivs tillämpas på navigatorn och innehållet.

Den översta panelen (RootPanel) har inte den här klassen.

Mobilformat mobile-styling

Sidhuvudsfält header-bar

Dessa variabler påverkar den rubrikrad som är synlig på en mobil enhet eller små skärmar som innehåller panelrubriker och navigeringsknappar för nästa och bakre.

CSS, klass
guide-header-bar
Variabel
Beskrivning
headerbar-background-color
Bakgrundsfärg för rubrikfältet
headerbar-font-color
Teckensnittsfärg för texten i rubrikfältet
headerbar-padding
Utfyllnad för rubrikfält

Rullningsindikator scroll-indicator

Dessa variabler påverkar rullningsindikatorn, som är en orange pil som visas på en mobil enhet eller små skärmar. En rullningsindikator anger att det finns innehåll utanför den synliga delen av skärmen. Du kan rulla nedåt för att se den. När du klickar på slutet av innehållet försvinner pilen.

CSS, klass
mobileScrollIndicator
Variabel
Beskrivning
scrollIndicatorBottom
Rullningsindikatorns fasta position nedifrån
scrollIndicatorRight
Rullningsindikatorns fasta position från höger
scrollIndicatorWidth
Bredd på rullningsvisare
scrollIndicatorHeight
Höjd på rullningsindikator

Mobile fixed toolbar layout-specific variables mobile-fixed-toolbar-layout-specific-variables

Variablerna i följande tabell påverkar den fasta verktygsfältslayouten för mobila enheter.

CSS, klass
mobileToolbar
Variabel
Beskrivning
mobileToolbarBottom
Verktygsfältets position, på den mobila enheten, från nederkanten är fast
mobileToolbarTop
Verktygsfältets position, på den mobila enheten, från överkanten är fast
mobileToolbarLeft
Verktygsfältets fasta position på den mobila enheten från vänster
mobileToolbarRight
Verktygsfältets fasta position på den mobila enheten från höger
mobileButtonIconTopMargin
Placeringen för verktygsfältets knappikon, uppifrån, har åtgärdats
mobileButtonIconWidth
Bredd på verktygsfältets knappikon på den mobila enheten
mobileButtonIconHeight
Höjd på verktygsfältets knappikon på den mobila enheten
mobilefixedtoolbarbgcolor
Bakgrundsfärg i verktygsfältet på den mobila enheten

Temaspecifik variabel theme-specific-variable

The Enkel registrering tema på /etc/clientlibs/fd/af/guithema/simpleRegistrering och kategorin guide.theme.simpleEnrollment innehåller också några variabler. Om du vill skapa ett tema som förbättrar enkel registrering kan du använda följande"extra variabler":

Variabel
Beskrivning
button-focus-bg-color
Bakgrundsfärg för knapp i fokus
button-hover-bg-color
Bakgrundsfärg för knapp vid hovring
button-radius
Knappradie
navigation-button-bg-color
Bakgrundsfärg för navigeringsknappar (bakåt/nästa)
navigation-button-bg-hover-color
Bakgrundsfärg för navigeringsknappar (bakåt/nästa) vid hovring
initial-nav-color
Bakgrundsfärg för guidenavigatörer och motsvarande förloppsindikator, när den först återges.
active-nav-color
Bakgrundsfärg för aktuell/aktiv guidenavigator och motsvarande förloppsindikator
visited-nav-color
Bakgrundsfärg för guidenavigatörer och motsvarande förloppsindikator, som har besökts.
tabs-bifercating-border-color
Kantfärgsbifurcera behållare till navigatorer och paneler
tabs-navigator-separator-color
Nedre kantfärg som separerar tabbar för tabbar till vänster (tabbnavigering).
tabs-child-nav-bg-color
Bakgrundsfärg för navigatorns kapslade/underordnade/underordnade navigatorer
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2