Änderungen von Dokument CSS-Einstellungen für Assistenten / JavaScript

Zusammenfassung

• Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Titel

...	...	@@ -1,1 +1,1 @@
1		-CSS Einstellungen für Assistenten / JavaScipt
	1	+CSS-Einstellungen für Assistenten / JavaScript

Inhalt

...	...	@@ -1,78 +1,58 @@
1		-Mit CSS-Anweisungen (Cascading Style Sheets) können Sie die visuelle Gestaltung Ihrer veröffentlichten Assistenten verändern. Damit gGleichen Sie die Assistenten optisch nahtlos an Ihre Website und Ihre gewohnte Corporate Identity an.
2		-Die Einstellungen werden zentral verwaltet und sind für alle Assistenten gültig.
	1	+**Inhaltsverzeichnis:**
3	3
4		-oder JavaScript im Formulareditor zu hinterlegen. Hierzu steht die Schaltfläche „Administration“ in der [[Hauptwerkzeugleiste|Main.05_Assistenten.01_Hauptwerkzeugleiste]] zur Verfügung. Nach der Betätigung öffnet sich die Eingabemaske „Organisations-Konfiguration“ in der die CSS-Anweisungen oder das JavaScript mittels verschiedenen Möglichkeiten hinterlegt werden kann.
	3	+{{toc start="2"/}}
5	5
6		-> {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
	5	+## CSS-Einstellungen für Assistenten
7	7
8		-1. Nur Benutzer die das [[Benutzerrecht|Main.07_Einstellungen-Fachadministration.02_Benutzer.01_Benutzerrollen]] „Layout verwalten“ besitzen, steht diese Funktion zur Verfügung.
	7	+Mit **CSS**-Anweisungen (Cascading Style Sheets) können Sie die visuelle Gestaltung Ihrer veröffentlichten Assistenten verändern. Damit gleichen Sie die Assistenten optisch nahtlos an Ihre Website und Ihre gewohnte Corporate Identity an.
	8	+Die Anpassungen werden zentral verwaltet und sind für alle Assistenten gültig, sowie im Bereich _Payment_ und _eID_.
9	9
10		-## Rubrik „CSS“
	10	+Änderungen im CSS-Bereich können die Barrierefreiheit der Anwendung beeinträchtigen.
11	11
12		-> {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Sofern Sie kundespezifische Änderungen im CSS- oder JavaScript-Bereich vornehmen, kann dies die Barrierefreiheit der Anwendung beeinträchtigen.
	12	+### Organisations-Konfiguration aufrufen
13	13
14		-### Externes CSS (URL)
	14	+**Voraussetzung:** Benutzerrecht **Layout verwalten**
15	15
16		-In der Eingabemaske „Organisations-Konfiguration“ besteht die Möglichkeit, in dem Eingabefeld ein externes CSS über eine URL zu hinterlegen.
	16	+Klicken Sie im Formulareditor in der [[Hauptwerkzeugleiste|doc:Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome]] die Schaltfläche Administration an.![[Schaltfläche Administration|Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome@HauptwerkzeugleisteCSS.jpg]]
17	17
18		-### Internes CSS
	18	+{{icon name="far fa-arrow-right"}}{{/icon}}Der Dialog **Organisations-Konfiguration** öffnet sich.
19	19
20		-Weiterhin besteht die Möglichkeit, direkt in dem Eingabefeld „internes CSS“ den Quellcode der CSS-Anweisungen zu hinterlegen. Im Editor können alle gängigen CSS Regeln verwendet werden. Zusätzlich stellen wir die Möglichkeit bereit den Assistenten, einzelne Panels oder einzelne Komponenten über entsprechende Attribute anzusprechen:
	20	+### Reiter "CSS"
21	21
22		-* **data-assistant-identifier**
23		-Dieses Attribut enthält als Wert die jeweilige Assistentennummer und kann dazu verwendet werden das CSS assistentenspezifisch zu gestalten. Das Attribut wird als Elternknoten für die Attribute "data-panel-identifier" und "data-component-identifier" dargestellt.
24		-* **data-panel-identifier**
25		-Dieses Attribut enthält als Wert die jeweilige technische Bezeichnung des Panels. Das Attribut wird als Elternknoten für das Attribut "data-component-identifer" dargestellt.
26		-* **data-component-identifier**
27		-Dieses Attribut enthält als Wert die jeweilige technische Bezeichnung der Komponente. Unterhalb des Attributs "data-panel-identifier" können mehrere Attribute "data-component-identifier" vorkommen. Verschachtelte Komponenten werden mit Punkten zwischen den technischen Bezeichnungen getrennt als Wert dargestellt. Beispiel: _Objektgruppenname.Komponentenname_
	22	+Verweisen Sie auf eine externe Quelle, aus der die CSS-Anweisungen geladen werden (**externes CSS**), oder tragen Sie Anweisungen/Code direkt in der Konfiguration ein (**internes CSS**).
28	28
29		-**Beispiel Attribute**
	24	+Im Feld **externes CSS (URL)** kann die Internetadresse einer CSS-Datei eingetragen werden, auf die der Formularserver Zugriff hat.
	25	+Beim Feld **internes CSS** können alle gängigen CSS-Regeln verwendet werden.
30	30
31		-[data-component-identifier="Textfeld (einzeilig)"] input{ border-color: orange !important; }
	27	+Über **Attribute** können spezifische Assistenten, Panels oder Komponenten ausgewählt werden.
32	32
33		-#### Beispiel einer CSS Einstellung
	29	+| Attribut | Beschreibung | Beispiel |
	30	+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
	31	+| data-assistant-identifier | Wert ist die Artikelnummer
	32	+Elternknoten für die Attribute "`data-panel-identifier`" und "`data-component-identifier`" | [data-assistant-identifier="KFAS_123456"] h2 { color: orange !important; } |
	33	+| data-panel-identifier | Wert ist die technische Bezeichnung des Panels
	34	+Elternknoten für das Attribut "`data-component-identifer`" | [data-panel-identifier="Beispielpanel_1"] h2 { color: yellow !important; } |
	35	+| data-component-identifier | Wert ist die technische Bezeichnung der Komponente
	36	+Unterhalb des Attributs "`data-panel-identifier`" können mehrere Attribute "`data-component-identifier`" vorkommen. Verschachtelte Komponenten werden mit Punkten zwischen den technischen Bezeichnungen getrennt als Wert dargestellt. Beispiel: _Objektgruppenname.Komponentenname_ | [data-component-identifier="Textfeld (einzeilig)"] input{ border-color: orange !important; } |
34	34
35		-1. Beispiel: Im nachfolgenden Beispiel wurde mittels des CSS eingestellt, dass die Pflichtangaben mittels einem roten Quadrat ausgewiesen werden.![[Beispiel eines CSS im Assistenten|@CSSBeispiel.jpg]]
36		-1. Beispiel: Mit dem nachfolgenden CSS-Beispiel werden die Platzierung der Schaltflächen „Abbruch“ und „Weiter“ vertauscht.`@media(min-width: 60em){ .fs-submitgroup
	38	+
37	37
38		-{ float: right; padding: 0 0 0 10px; } } .fs-exitButton, .fs-exitNoScriptButton
	40	+### Reiter "CSS-Generator"
39	39
40		-{ float:none ! important; }`
	42	+Mithilfe grafischer Werkzeuge können Sie hier grundlegende Einstellungen für die Assistentensicht festlegen. Der generierte Code kann anschließend manuell bearbeitet und weiter angepasst werden.
41	41
42		-1. Beispiel: Mit dem nachfolgenden CSS-Beispiel wird das Styling der gelben Infobutton verändert.`.fs-hintLink img {
43		-height: 16px;
44		-width: 16px;
45		--moz-box-sizing: border-box;
46		-box-sizing: border-box;
47		-background: url(https://media.tenor.com/images/96f515cc7dd36da47b5d0c62e86dfca3/tenor.gif) no-repeat;
48		-background-size: 16px 16px;
49		-padding-left: 16px;
50		- }`
	44	+**Nutzung des CSS-Generators:**
51	51
52		-## Rubrik „CSS-Generator“
	46	+1. Hintergrundfarbe und/oder Schriftfarbe mithilfe der Farbwähler festlegen
	47	+1. Schriftart(en)/Schriftfamilie(n) auswählen und mit den Pfeiltasten in den rechten Bereich verschieben
	48	+1. Schaltfläche **Generieren** anklicken
53	53
54		-Mittels des integrierten CSS-Generators hat der Benutzer die Möglichkeit, verschiedenste optische Anpassungen per GUI vorzunehmen. Für die Hintergrund- und Schriftfarbe wird ein Colorpicker zur Verfügung gestellt, mit welchem die entsprechenden Farben ausgewählt werden können. Des Weiteren können Schriftarten spezifiziert werden. Nach dem Generieren der vorgenommenen Einstellungen wird im Eingabefeld „internes CSS“ die entsprechenden CSS-Anweisungen eingefügt.
	50	+{{icon name="far fa-arrow-right"}}{{/icon}}Der CSS-Code ist im Abschnitt **CSS** > **internes CSS** eingetragen.
55	55
56		-![[Ansicht des CSS Generators|@CSSGenerator.jpg]]
	52	+## JavaScript-Einstellungen
57	57
58		-## Rubrik „JavaScript“
	54	+Änderungen im JavaScript-Bereich können die Barrierefreiheit der Anwendung beeinträchtigen.
59	59
60		-Im der Rubrik „JavaScript“ kann für den Mandanten Assistenten übgreifendes JavaScript hinterlegt werden. Weitere Informationen zu den Möglichkeiten JavaScript zu hinterlegen finden Sie [[hier|Main.05_Assistenten.04_Assistentenbauoberfläche.15_JavaScript]].
	56	+Im Reiter **JavaScript** der Organisations-Konfiguration kann JavaScript konfiguriert werden, das mandantenweit in allen Assistenten und Panels ausgeführt wird.
61	61
62		-> {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Diese Funktion funktioniert derzeit nur für die Bereiche Assistenten ausfüllen/einreichen, [[Payment|Main.07_Einstellungen-Fachadministration.03_Module.01_Payment]] und [[eID|Main.07_Einstellungen-Fachadministration.03_Module.05_eID]].
63		-
64		-### Externe Bibliotheken
65		-
66		-In der Rubrik JavaScript kann nach der Hinterlegung einer URL und der Prüfsumme über externe Bibliotheken JavaScript hinterlegt werden. Die Prüfsumme bietet die Möglichkeit die eingebundene Ressource auf ihre Korrektheit zu überprüfen. Bevor die Ressource in den Assistenten geladen wird, wird die Prüfsumme verifiziert. Wenn die Ressource gültig ist, wird diese geladen. Falls nicht, wird die Ressource vom Browser ignoriert. Wenn keine Prüfsumme angegeben wird, wird die Ressource trotzdem vom Browser geladen.
67		-
68		-### Generierte Platzhalter
69		-
70		-Über die Schaltflächen können Platzhalter in den Editor eingefügt werden. Diese Platzhalter werden zur Laufzeit des Assistenten dynamisch mit dem jeweiligen Wert ersetzt.
71		-
72		-### Internes JavaScript
73		-
74		-In dem Editor kann das kundenspezifische JavaScript eingefügt werden. Dieses wird zur Laufzeit des Assistenten ausgeführt.
75		-
76		-> {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Das konfigurierte JavaScript ist mandantenweit hinterlegt und wird somit in jedem Assistenten auf jedem Panel ausgeführt.
77		-
78		-![[Ansicht des JavaScript Bereichs|@CSSJavaScript_befüllt.jpg]]
	58	+Weitere Informationen zu JavaScript in MACH formsolutions finden Sie im Artikel [[JavaScript-Konfiguration|Main.05_Assistenten.04_Assistentenbauoberfläche.15_JavaScript]].