Zuletzt geändert von MACH formsolutions am 15.10.2025

Von Version 434.1
bearbeitet von MACH formsolutions
am 15.10.2025
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 318.1
bearbeitet von MACH formsolutions
am 09.07.2021
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -CSS-Einstellungen für Assistenten / JavaScript
1 +CSS Einstellungen
Syntax
... ... @@ -1,1 +1,1 @@
1 -XWiki 2.1
1 +Markdown 1.2
Inhalt
... ... @@ -1,69 +1,89 @@
1 -**Inhaltsverzeichnis:**
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.
2 2  
3 -{{toc start="2"/}}
3 +> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***
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.
4 4  
5 -== CSS-Einstellungen für Assistenten ==
7 +![[Ansicht der Eingabemaske um ein CSS zu hinterlegen|@CSSEingabemaske.jpg]]
6 6  
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 +## Rubrik „CSS“
9 9  
10 -(% class="box warningmessage" %)
11 -(((
12 -Änderungen im CSS-Bereich können die Barrierefreiheit der Anwendung beeinträchtigen.
13 -)))
11 +> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***
12 +> Sofern Sie kundespezifische Änderungen im CSS- oder JavaScript-Bereich vornehmen, kann dies die Barrierefreiheit der Anwendung beeinträchtigen.
14 14  
14 +### Externes CSS (URL)
15 15  
16 -=== Organisations-Konfiguration aufrufen ===
16 +In der Eingabemaske „Organisations-Konfiguration besteht die Möglichkeit, in dem Eingabefeld ein externes CSS über eine URL zu hinterlegen.
17 17  
18 -**Voraussetzung:** Benutzerrecht **Layout verwalten**
18 +### Internes CSS
19 19  
20 -Klicken Sie im Formulareditor in der [[Hauptwerkzeugleiste>>doc:Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome]] die Schaltfläche Administration an.[[image:Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome@HauptwerkzeugleisteCSS.jpg||alt="Schaltfläche Administration"]]
20 +Weiterhin besteht die Möglichkeit, direkt in dem Eingabefeldinternes CSS“ den Quellcode der CSS-Anweisungen zu hinterlegen.
21 21  
22 -{{icon name="far fa-arrow-right"/}}Der Dialog **Organisations-Konfiguration** öffnet sich.
22 +#### Beispiel einer CSS Einstellung
23 23  
24 +1. Beispiel:
25 +Im nachfolgenden Beispiel wurde mittels des CSS eingestellt, dass die Pflichtangaben mittels einem roten Quadrat ausgewiesen werden.
24 24  
25 -=== Reiter "CSS" ===
27 + ![[Beispiel eines CSS im Assistenten|@CSSBeispiel.jpg]]
26 26  
27 -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**).
29 +2. Beispiel:
30 +Mit dem nachfolgenden CSS-Beispiel werden die Platzierung der Schaltflächen „Abbruch“ und „Weiter“ vertauscht.
28 28  
29 -Im Feld **externes CSS (URL)** kann die Internetadresse einer CSS-Datei eingetragen werden, auf die der Formularserver Zugriff hat.
30 -Beim Feld **internes CSS** können alle gängigen CSS-Regeln verwendet werden.
32 + ```javascript
33 + @media(min-width: 60em){
34 + .fs-submitgroup
31 31  
32 -Über **Attribute** können spezifische Assistenten, Panels oder Komponenten ausgewählt werden.
36 + { float: right; padding: 0 0 0 10px; }
37 + }
38 + .fs-exitButton, .fs-exitNoScriptButton
33 33  
34 -|=Attribut|=Beschreibung|=Beispiel
35 -|data-assistant-identifier|Wert ist die Artikelnummer(((
36 -Elternknoten für die Attribute "{{code language="none"}}data-panel-identifier{{/code}}" und "{{code language="none"}}data-component-identifier{{/code}}"
37 -)))|[data-assistant-identifier="KFAS_123456"] h2 { color: orange !important; }
38 -|data-panel-identifier|Wert ist die technische Bezeichnung des Panels(((
39 -Elternknoten für das Attribut "{{code language="none"}}data-component-identifer{{/code}}"
40 -)))|[data-panel-identifier="Beispielpanel_1"] h2 { color: yellow !important; }
41 -|data-component-identifier|Wert ist die technische Bezeichnung der Komponente(((
42 -Unterhalb des Attributs "{{code language="none"}}data-panel-identifier{{/code}}" können mehrere Attribute "{{code language="none"}}data-component-identifier{{/code}}" vorkommen. Verschachtelte Komponenten werden mit Punkten zwischen den technischen Bezeichnungen getrennt als Wert dargestellt. Beispiel: //Objektgruppenname.Komponentenname//
43 -)))|[data-component-identifier="Textfeld (einzeilig)"] input{ border-color: orange !important; }
40 + { float:none ! important; }
41 + ```
44 44  
43 +3. Beispiel:
44 +Mit dem nachfolgenden CSS-Beispiel wird das Styling der gelben Infobutton verändert.
45 45  
46 + ```javascript
47 + .fs-hintLink img {
48 + height: 16px;
49 + width: 16px;
50 + -moz-box-sizing: border-box;
51 + box-sizing: border-box;
52 + background: url(https://media.tenor.com/images/96f515cc7dd36da47b5d0c62e86dfca3/tenor.gif) no-repeat;
53 + background-size: 16px 16px;
54 + padding-left: 16px;
55 + }
56 + ```
46 46  
47 -=== Reiter "CSS-Generator" ===
58 +## Rubrik CSS-Generator
48 48  
49 -Mithilfe grafischer Werkzeuge nnen Sie hier grundlegende Einstellungen r die Assistentensicht festlegen. Der generierte Code kann anschließend manuell bearbeitet und weiter angepasst werden.
60 +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 50  
51 -**Nutzung des CSS-Generators:**
62 +![[Ansicht des CSS Generators|@CSSGenerator.jpg]]
52 52  
53 -1. Hintergrundfarbe und/oder Schriftfarbe mithilfe der Farbwähler festlegen
54 -1. Schriftart(en)/Schriftfamilie(n) auswählen und mit den Pfeiltasten in den rechten Bereich verschieben
55 -1. Schaltfläche **Generieren** anklicken
64 +## Rubrik „JavaScript“
56 56  
57 -{{icon name="far fa-arrow-right"/}}Der CSS-Code ist im Abschnitt **CSS** > **internes CSS** eingetragen.
66 +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]].
58 58  
68 +> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***
69 +> 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]].
59 59  
60 -== JavaScript-Einstellungen ==
71 +### Externe Bibliotheken
61 61  
62 -(% class="box warningmessage" %)
63 -(((
64 -Änderungen im JavaScript-Bereich können die Barrierefreiheit der Anwendung beeinträchtigen.
65 -)))
73 +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.
66 66  
67 -Im Reiter **JavaScript** der Organisations-Konfiguration kann JavaScript konfiguriert werden, das mandantenweit in allen Assistenten und Panels ausgeführt wird.
75 +### Generierte Platzhalter
68 68  
69 -Weitere Informationen zu JavaScript in MACH formsolutions: [[Artikel JavaScript-Konfiguration>>Main.05_Assistenten.04_Assistentenbauoberfläche.15_JavaScript]]
77 +Ü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.
78 +
79 +### Internes JavaScript
80 +
81 +In dem Editor kann das kundenspezifische JavaScript eingefügt werden. Dieses wird zur Laufzeit des Assistenten ausgeführt.
82 +
83 +> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***
84 +> Das konfigurierte JavaScript ist mandantenweit hinterlegt und wird somit in jedem Assistenten auf jedem Panel ausgeführt.
85 +
86 +![[Ansicht des JavaScript Bereichs|@CSSJavaScript_befüllt.jpg]]
87 +
88 +
89 +
CSSEingabemaske.jpg
Größe
... ... @@ -1,1 +1,1 @@
1 -235.9 KB
1 +127.8 KB
Inhalt