Wiki-Quellcode von CSS Einstellungen

Version 344.1 von MACH ProForms GmbH am 01.10.2021

version	line-number	content
315.1	1	Jeder Mandant hat die Möglichkeit eigene CSS-Anweisungen (Cascading Style Sheets) oder JavaScript in der Assistentenbauoberfläche 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.
1.1	2
234.1	3	> {{icon name="far fa-info-circle" size="3"/}} *Hinweis:*
114.1	4	> 1. Nur Benutzer die das [[Benutzerrecht\|Main.07_Einstellungen-Fachadministration.02_Benutzer.01_Benutzerrollen]] „Layout verwalten“ besitzen, steht diese Funktion zur Verfügung.
	5	> 2. Weiterhin ist das eingestellte CSS für alle Assistenten gültig. Somit wird für alle Assistenten ein einheitliches CI Corporate Identity ermöglicht. Das CSS zieht nicht für PDF-Formulare.
1.1	6
	7	![[Ansicht der Eingabemaske um ein CSS zu hinterlegen\|@CSSEingabemaske.jpg]]
	8
	9	## Rubrik „CSS“
	10
234.1	11	> {{icon name="far fa-info-circle" size="3"/}} *Hinweis:*
145.1	12	> Sofern Sie kundespezifische Änderungen im CSS- oder JavaScript-Bereich vornehmen, kann dies die Barrierefreiheit der Anwendung beeinträchtigen.
1.1	13
	14	### Externes CSS (URL)
	15
	16	In der Eingabemaske „Organisations-Konfiguration“ besteht die Möglichkeit, in dem Eingabefeld ein externes CSS über eine URL zu hinterlegen.
	17
	18	### Internes CSS
	19
320.1	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:
1.1	21
320.1	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
	25	- data-panel-identifier
	26	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.
	27
	28	- data-component-identifier
	29	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
	30
	31	Beispiel Attribute
	32
	33	[data-component-identifier="Textfeld (einzeilig)"] input{
	34	border-color: orange !important;
	35	}
	36
	37
1.1	38	#### Beispiel einer CSS Einstellung
	39
	40	1. Beispiel:
	41	Im nachfolgenden Beispiel wurde mittels des CSS eingestellt, dass die Pflichtangaben mittels einem roten Quadrat ausgewiesen werden.
	42
	43	![[Beispiel eines CSS im Assistenten\|@CSSBeispiel.jpg]]
	44
	45	2. Beispiel:
	46	Mit dem nachfolgenden CSS-Beispiel werden die Platzierung der Schaltflächen „Abbruch“ und „Weiter“ vertauscht.
	47
	48	```javascript
	49	@media(min-width: 60em){
	50	.fs-submitgroup
	51
	52	{ float: right; padding: 0 0 0 10px; }
	53	}
	54	.fs-exitButton, .fs-exitNoScriptButton
	55
	56	{ float:none ! important; }
	57	```
	58
114.1	59	3. Beispiel:
	60	Mit dem nachfolgenden CSS-Beispiel wird das Styling der gelben Infobutton verändert.
	61
	62	```javascript
	63	.fs-hintLink img {
	64	height: 16px;
	65	width: 16px;
	66	-moz-box-sizing: border-box;
	67	box-sizing: border-box;
	68	background: url(https://media.tenor.com/images/96f515cc7dd36da47b5d0c62e86dfca3/tenor.gif) no-repeat;
	69	background-size: 16px 16px;
	70	padding-left: 16px;
	71	}
	72	```
	73
1.1	74	## Rubrik „CSS-Generator“
	75
	76	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.
	77
	78	![[Ansicht des CSS Generators\|@CSSGenerator.jpg]]
	79
	80	## Rubrik „JavaScript“
	81
315.1	82	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]].
	83
234.1	84	> {{icon name="far fa-info-circle" size="3"/}} *Hinweis:*
114.1	85	> 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]].
1.1	86
	87	### Externe Bibliotheken
	88
	89	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.
	90
	91	### Generierte Platzhalter
	92
	93	Ü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.
	94
	95	### Internes JavaScript
	96
	97	In dem Editor kann das kundenspezifische JavaScript eingefügt werden. Dieses wird zur Laufzeit des Assistenten ausgeführt.
	98
234.1	99	> {{icon name="far fa-info-circle" size="3"/}} *Hinweis:*
114.1	100	> Das konfigurierte JavaScript ist mandantenweit hinterlegt und wird somit in jedem Assistenten auf jedem Panel ausgeführt.
1.1	101
	102	![[Ansicht des JavaScript Bereichs\|@CSSJavaScript_befüllt.jpg]]
	103
	104
	105