Styling und Themes
Innerhalb des Produkts TF5310 sind eine Reihe von CSS-Variablen definiert, die ein einheitliches Erscheinungsbild der CNC-spezifischen Controls ermöglichen. Das Erscheinungsbild orientiert sich an den vordefinierten Themes "Base" und "Base-Dark" aus der TwinCAT HMI Produktfamilie. Die CNC-spezifischen Controls sind für diese beiden Themes ausgelegt. Dazu werden bestehende CSS-Variablen (z. B. Standardfarben) beider Themes verwendet.
Die einzelnen CSS-Variablen in TF5310 sind intern in CSS-Klassen zusammengefasst. Über die CSS-Klassen werden die CSS-Variablen an die Controls vererbt.
Anpassen des Erscheinungsbilds im Theme
Das Erscheinungsbild der einzelnen Controls können Sie im Theme über die in den nachfolgenden Abschnitten beschriebenen CSS-Variablen global anpassen. Dazu gehen Sie wie folgt vor:
- Öffnen Sie die .css-Datei des Themes, für das Sie die CSS-Variablen anpassen möchten. Beim Theme "Base" ist dies beispielsweise die Datei "BaseStyle.css".
- Navigieren Sie in der Datei zur CSS-Pseudoklasse ":root"
- Fügen Sie hier die entsprechenden CSS-Variablen ein und weisen Sie diesen die gewünschten Werte zu.
Beispiel:
:root {
--CNC-HMI-Button-Background: #424242;
--tchmi-cnc-background-color-1: rgba(66,66,66,1);
}Die Controls nutzen Standardwerte für die einzelnen CSS-Variablen, wenn Sie im Theme keinen Wert vorgeben. Mit den Standardwerten entspricht das Erscheinungsbild dem Theme "Base".
Standardfarben
TF5310 nutzt Standardfarben aus den Themes "Base" und "Base-Dark", wobei jeder Standardfarbe eine Alias-Variable zugewiesen ist. Bei einem Wechsel zwischen den beiden Themes wird die jeweilige Standardfarbe in eine Alias-Variable übertragen, die anschließend in den einzelnen Controls eingesetzt wird. Über die Alias-Variablen können Sie daher das Erscheinungsbild global anpassen. In der nachfolgenden Tabelle sind die verwendeten Standardfarben aus den Themes "Base" und "Base-Dark" sowie ihre allgemeine Verwendung aufgeführt.
Alias-Variable | Theme "Base" | Theme "Base-Dark" | Verwendung |
|---|---|---|---|
--tchmi-cnc-background-color-1
| --tchmi-background-color-1 | --tchmi-background-color-1 | Haupthintergrund (Seiten, Dialoge)
|
--tchmi-cnc-background-color-2 | --tchmi-background-color-2 | --tchmi-background-color-2 | Sekundärer Hintergrund (Navigation, Sidebar, Schaltflächen) |
--tchmi-cnc-background-color-3 | --tchmi-background-color-3 | --tchmi-background-color-3 | Tertiärer Hintergrund (Header, Footer, Tabellenkopf) |
--tchmi-cnc-background-color-4 | --tchmi-background-color-4 | --tchmi-background-color-4 | Eingabefelder |
--tchmi-cnc-foreground-color-1 | --tchmi-foreground-color-1 | --tchmi-foreground-color-3 | Normaler Text, Icons |
--tchmi-cnc-foreground-color-2 | --tchmi-foreground-color-2 | --tchmi-foreground-color-1 | Hervorgehobener Text (aktive Elemente) |
--tchmi-cnc-foreground-color-3 | --tchmi-foreground-color-3 | --tchmi-foreground-color-3 | Reduzierter / schwächerer Text, Rahmen |
--tchmi-cnc-foreground-color-4 | --tchmi-foreground-color-4 | --tchmi-foreground-color-4 | Weiterer Vordergrund |
--tchmi-cnc-foreground-color-5 | --tchmi-foreground-color-5 | --tchmi-foreground-color-5 | Sehr schwacher Vordergrund (gedrückte Schaltflächen, Deaktiviert) |
--tchmi-cnc-foreground-color-6 | - | --tchmi-foreground-color-2 | Rahmenfarbe (nur für "Base Dark") |
--tchmi-cnc-highlight-color-1 | --tchmi-highlight-color-1 | --tchmi-highlight-color-1 | Primäre Akzentfarbe (aktiv, ausgewählt) |
--tchmi-cnc-highlight-color-2 | --tchmi-highlight-color-2 | --tchmi-highlight-color-2 | Sekundäre Akzentfarbe (Hover) |
--tchmi-cnc-shadow-color-1 | --tchmi-shadow-color-1 | --tchmi-shadow-color-1 | Schatten |
--tchmi-cnc-shadow-color-2 | --tchmi-shadow-color-2 | --tchmi-shadow-color-2 | Trennlinien, Splitter |
--tchmi-cnc-error-color | --tchmi-error-color | --tchmi-error-color | Fehlerfarbe |
--tchmi-cnc-warning-color | --tchmi-warning-color | --tchmi-warning-color | Warnfarbe |
Layoutmaße
Die grundlegenden Abmessungen der einzelnen Controls können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-FixedInputControls-width | Standardbreite | 50px |
--CNC-HMI-FixedInputControls-height | Standardhöhe | 50px |
--CNC-HMI-FixedMidInputControls-width | Breite für mittelgroße Controls | 35px |
--CNC-HMI-FixedMidInputControls-height | Höhe für mittelgroße Controls | 35px |
--CNC-HMI-FixedSmallInputControls-width | Breite für kleine Controls | 30px |
--CNC-HMI-FixedSmallInputControls-height | Höhe für kleine Controls | 30px |
--CNC-HMI-Padding | Globaler Innenabstand | 5px |
--CNC-HMI-Checkbox-width | Breite von Checkbox-Controls | 60px |
--CNC-HMI-Table-Row-Height | Zeilenhöhe in Tabellen | --CNC-HMI-FixedMidInputControls-height |
--CNC-HMI-Table-Header-Height | Höhe von Tabellenköpfen | --CNC-HMI-FixedMidInputControls-height |
--CNC-HMI-Table-Header-Line-Thickness | Linienstärke Tabellenkopf | 2px |
--CNC-HMI-Table-Line-Thickness | Linienstärke Tabellenzellen | 1px |
Schriften
Die verwendeten Schriftarten und Schriftgrößen können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Font | Schriftart | RobotoCondensed |
--CNC-HMI-HeadlineFontSize | Überschriften | 26px |
--CNC-HMI-TitleFontSize | Titel | 24px |
--CNC-HMI-SubTitleFontSize | Untertitel | 20px |
--CNC-HMI-BodyFontSize | Fließtext, Eigenschaftsfenster | 18px |
--CNC-HMI-LabelFontSize | Labels, Schaltflächenbeschriftungen | 14px |
--CNC-CycleSelectionTextSize | Schriftgröße in der Zyklenauswahl | --CNC-HMI-BodyFontSize |
Farben
Texte
Die Farbe von Texten können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-NormalFontColor | Standardtext | --tchmi-cnc-foreground-color-1 |
--CNC-HMI-HighlightFontColor | Hervorgehobener Text | --tchmi-cnc-foreground-color-2 |
--CNC-HMI-LightFontColor | Schwächerer Text | --tchmi-cnc-foreground-color-3 |
--CNC-HMI-DisabledFontColor | Deaktivierte Elemente | --tchmi-cnc-foreground-color-5 |
--CNC-HMI-WarnFontColor | Warnmeldungstext | --tchmi-cnc-foreground-color-1 |
--CNC-HMI-AlarmFontColor | Alarmmeldungstext | --tchmi-cnc-error-color |
--tchmi-icons-color | Farbe für SVG-Icons | --tchmi-cnc-foreground-color-1 |
Schaltflächen
Die Farbe von Schaltflächen können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Button-Background | Standardhintergrund | --tchmi-cnc-background-color-2 |
--CNC-HMI-Button-Background-active | Aktiver Zustand | --tchmi-cnc-highlight-color-1 |
--CNC-HMI-Button-Background-disabled | Deaktivierter Zustand | --tchmi-cnc-background-color-3 |
--CNC-HMI-Button-Background-error | Fehlerzustand | --tchmi-cnc-error-color |
--CNC-HMI-Button-Background-pressed | Gedrückter Zustand | --tchmi-cnc-foreground-color-5 (Theme "Base") --tchmi-cnc-background-color-4 (Theme "Base-Dark") |
--CNC-HMI-Button-Border | Rahmen | --tchmi-cnc-foreground-color-3 (Theme "Base") Black (Theme "Base-Dark") |
--CNC-HMI-Hover-Color | Hover-Zustand | --tchmi-cnc-highlight-color-2 |
Eingabefelder
Die Farbe von Eingabefeldern können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Input-Background | Standardhintergrund | --tchmi-cnc-background-color-4 |
--CNC-HMI-Input-Background-active | Fokussiertes Eingabefeld | --tchmi-cnc-highlight-color-1 |
--CNC-HMI-Input-Background-error | Fehlerhafte Eingabe | --tchmi-cnc-error-color |
--CNC-HMI-Input-Background-warning | Fehlende Eingabe | --tchmi-cnc-warning-color |
--CNC-HMI-Input-disabled | Gesperrtes Eingabefeld | --tchmi-cnc-background-color-3 |
Hintergründe von Layouts
Die Farbe von Hintergründen in Layouts können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Main-Background | Hauptinhaltshintergrund | --tchmi-cnc-background-color-1 |
--CNC-HMI-Header-Background | Kopfzeilen, Dialoge | --tchmi-cnc-background-color-3 |
--CNC-HMI-Footer-Background | Fußzeilen | --tchmi-cnc-background-color-3 |
--CNC-HMI-Navigation-Background | Navigationsleisten | --tchmi-cnc-background-color-2 |
--CNC-HMI-Navigation-HighlightFontColor | Aktiver Navigationseintrag | --tchmi-cnc-highlight-color-1 |
--CNC-HMI-Sidebar-Background | Seitenleisten | --tchmi-cnc-background-color-2 |
--CNC-HMI-Dialog-Background | Dialoghintergrund | --tchmi-cnc-background-color-1 |
--CNC-HMI-Dialog-Header-and-Border | Dialogkopf und Rahmen | --tchmi-cnc-foreground-color-3 |
--CNC-HMI-Splitter-Background | Trennlinien zwischen Layoutbereichen | --tchmi-cnc-shadow-color-2 |
--CNC-HMI-Standard-Border | Rahmen | --tchmi-cnc-background-color-2 (Theme "Base") --tchmi-cnc-foreground-color-6 (Theme "Base-Dark") |
--CNC-HMI-ToolTip-Background | Tooltip-Hintergrund | --CNC-HMI-Button-Border |
--CNC-HMI-ToolTip-Highlight | Hervorgehobener Tooltip-Text | --tchmi-cnc-highlight-color-1 |
Tabellen
Die Farbe von Tabellen können Sie über die nachfolgenden CSS-Variablen steuern.
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Table-Background | Tabellenhintergrund | --tchmi-cnc-background-color-1 |
--CNC-HMI-Table-Header-Background | Hintergrund Tabellenkopf | --tchmi-cnc-background-color-3 |
--CNC-HMI-Selected-Background | Ausgewählte Tabellenzeile | --tchmi-cnc-highlight-color-1 |
Weitere CSS-Variablen
Variablenname | Bedeutung | Standardwert |
|---|---|---|
--CNC-HMI-Checkbox-Background | Hintergrund von Kontrollkästchen | --tchmi-cnc-background-color-2 |
--CNC-HMI-Checkbox-Background_active | Aktives Kontrollkästchen | --tchmi-cnc-highlight-color-1 |
--CNC-HMI-Checkbox-Dot-Background | Markierung im Kontrollkästchen | --tchmi-cnc-foreground-color-2 (Theme "Base") --tchmi-cnc-foreground-color-3 (Theme "Base-Dark) |
--CNC-HMI-Combobox-active | Geöffnete Combobox | --tchmi-cnc-background-color-3 |
--CNC-HMI-Tab-Header-Item-active | Aktiver Tab-Header | --tchmi-cnc-background-color-2 |
--CNC-HMI-Tab-Header-Span-Background | Inaktiver Tab-Header | --tchmi-cnc-background-color-3 |