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:

  1. Ö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".
  2. Navigieren Sie in der Datei zur CSS-Pseudoklasse ":root"
  3. 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