KK TT Attribute
VS Code Extension fuer IntelliSense, Validierung, Hover-Dokumentation und Snippets
fuer TeachTalk HMI-Attribute ({...}) in .tts, .ttp und .ttd Dateien.
Features
IntelliSense / Autocomplete
Kontextabhaengige Vorschlaege innerhalb von Attribut-Bloecken {...}:
- Attribut-Namen nach
{ oder | — alle 63 TT-Quellcode-Attribute
- Werte nach
= — Boolean (TRUE/FALSE), Integer-Bereiche, Enum-Werte
- Bereits gesetzte Attribute werden automatisch herausgefiltert
- Kontexterkennung: Variable, Routine oder Header — nur passende Attribute werden vorgeschlagen
- Benutzerdefinierte Attribute ueber Workspace-/User-Settings erweiterbar
Snippet-Vorlagen
Haeufige Attribut-Kombinationen als Snippets mit Tab-Stops:
| Prefix |
Beschreibung |
tt-attr-param |
Standard-Parameter (Parameter_Var + Change_Level + TabSelection) |
tt-attr-equipment |
Equipment-Header (Equipment_Variable + Icon + Name aenderbar) |
tt-attr-param-pos |
Parameter mit Sortierung (Parameter_Var + Position) |
tt-attr-io |
I/O-Variable (Change_Level + Parameter + Expression) |
tt-attr-routine |
Routine sichtbar (GraphicalUseable + Icon) |
tt-attr-variant |
Varianten-Routine (EngelVariant + Editable + Icon) |
tt-attr-readonly |
Readonly-Parameter (Change_Level + nicht zuweisbar) |
tt-attr-setup |
Nur-Setup-Parameter (RequiredOPMode=1 + Change_Level) |
tt-attr-hidden |
Versteckt (GraphicalUseable=FALSE) |
Syntax-Highlighting
Farbige Hervorhebung der Attribut-Bloecke:
- Attribut-Namen in Orange/Terracotta
- Operatoren (
=, |) in Grau
- Boolean-Werte (
TRUE/FALSE) in Blau
- Strings in Orange
- Zahlen in Gruen
Hover-Dokumentation
Beim Hover ueber Attribut-Namen wird angezeigt:
- Kategorie und Datentyp
- Beschreibung (deutsch)
- Gueltige Werte und Bereiche
- Vererbungsverhalten
- Warnhinweise und Anti-Patterns
Diagnostics / Validierung
Echtzeit-Validierung mit Fehler- und Warnmeldungen:
| Regel |
Severity |
| Unbekannter Attribut-Name (mit "Meinten Sie...?" Vorschlag) |
Error |
| Boolean-Attribut mit falschem Werttyp |
Error |
| Integer-Wert ausserhalb gueltigem Bereich |
Warning |
| Duplikat im selben Attribut-Block |
Warning |
Code Actions / Quick Fixes
- Vorschlag des naechsten Matches bei unbekannten Attributen
- Attribut hinzufuegen ueber Attribut-Picker
Unterstuetzte Dateitypen
| Extension |
Sprache |
.tts |
TeachTalk Source |
.ttp |
TeachTalk Program |
.ttd |
TeachTalk Definition |
Installation
Aus VSIX-Datei
code --install-extension kk-tt-attribute-0.0.2.vsix
Oder in VS Code: Extensions > ... > Install from VSIX...
Aus Quellcode bauen
npm install
node build_and_package.mjs
Dies erstellt die VSIX-Datei und ein vollstaendiges ZIP-Archiv.
Konfiguration
Benutzerdefinierte Attribute
Eigene Attribute koennen in den VS Code Settings definiert werden,
damit sie nicht als Fehler gemeldet werden:
{
"ttAttribute.customAttributes": [
{
"name": "MeinAttribut",
"type": "string",
"description": "Beschreibung des Attributs"
}
]
}
Unterstuetzte Typen: boolean, integer, string
Die Einstellung kann pro Workspace oder global definiert werden.
Voraussetzungen
Lizenz
MIT License — siehe LICENSE-Datei im Projektordner
