[3.3] Toggle Control (Schalter-Stil zentral festlegen)

[LukeWCS]

Release 1.0.2 online.

Reines Optimier-Update, keine funktionellen Änderungen.

[LukeWCS]

Release 1.1.0

Unterstützung für phpBB 3.2 wurde aufgegeben.

[LukeWCS]

Version 1.1.1 online.

Voraussetzungen haben sich geändert, Details im Changelog.

[LukeWCS]

Hallo

Udo und ich haben uns am Wochenende bei einer Kanne Kaffee zusammengesetzt um die Überarbeitung der Kirk-Toggles auf Basis des Themas Nested CSS (verschachteltes CSS) zu besprechen. Des weiteren haben wir uns überlegt, wie wir unsere jeweiligen Varianten des CSS Codes kombinieren können, damit wir nur noch 1 CSS pflegen müssen und keine 2 mehr. Wir haben 2 primäre Unterschiede:

• Udo hat das Farbschema Grün/Rot, während ich Blau/Grau habe. Das Schema hatte ich damals von Thorsten (IMC) Übernommen und nur minimal geändert, damit beide Farben etwas deutlicher ausgeprägt sind.
• Udo verwendet beim Slider eine Animation, die mir nicht so zusagt. Bei meiner Variante ist das quasi schlichter gestaltet. Bei der Farb-Animation gibt es ebenfalls Abweichungen, aber die sind im Prinzip minimal.

Unsere Änderungen:

1. Umstellung der Notation auf Nested CSS. Das hat mehrere Vorteile:
   1. Das CSS besteht insgesamt nicht mehr aus 6 separaten Komponenten (1 Autorenblock plus 5 Regelgruppen), sondern nur noch aus einem "Objekt", in das auch der Autorenblock integriert ist.
   2. Wenn bei einem Entwickler der Klassenname toggle nicht ins bestehende Konzept passt, müssen nicht mehr 7 Selektoren geändert werden, sondern nur noch 1.
   3. Nested CSS ist durch seine Objekt-orientierte Struktur übersichtlicher und auf Dauer besser wartbar. Erfordert allerdings auch eine Gewöhnung; jahrzehntelange Praxis kann man nicht mal eben abstreifen, ich auch nicht.
2. Um unsere beiden CSS Varianten kombinieren zu können, wurde der Code auf Basis des grössten gemeinsamen Nenners notiert und Abweichungen mit CSS Variablen anpassbar gestaltet. Im Auslieferzustand sind die Variablen von Udo deaktiviert, so dass sich das CSS bei TC und in der Anleitung wie gehabt verhält. Da wir das CSS auch optimiert und obsoletes entfernt haben, ist das neue CSS gerade mal 2 Zeilen grösser, also 52 Zeilen statt 50, jeweils inklusive Autorenblock.
3. Damit Entwickler schon direkt am Code erkennen können, um welchen Stand es sich da handelt, haben wir eine vereinfachte Versionsnummer eingeführt. Die alte Variante wird somit nachträglich als 1.0 deklariert und die neue als 2.0, da es jetzt gravierende Änderungen am Code gibt.
4. Der CSS Code wurde auch optimiert, so haben wir obsolete Vendor-prefixes entfernt, die nicht mehr nötig sind. Des Weiteren haben wir bestimmte, unnötig spezifische Eigenschaftsnamen durch andere ersetzt und auch Werte entschlackt. Ebenso haben wir bestimmte Farbwerte in Kurzschreibweise notiert.

Der alte CSS Code, also 1.0, ist in der Entwickler Anleitung noch in einer SpoilerBox verfügbar, wird aber nicht mehr gepflegt.

Da sich rein funktionell und optisch nichts zwischen 1.0 und 2.0 geändert hat, kann jeder, der die Kirk-Toogles schon nutzt, direkt auf 2.0 aktualisieren, ohne etwas ändern zu müssen. Sollte aber jemand individuelle Anpassungen bei 1.0 vorgenommen haben, muss er diese natürlich auch auf den 2.0 Code übertragen.

Info am Rande; die Kirk-Toggles sind inzwischen bei 32 Erweiterungen integriert.

Udo und Patrick


Entwickler Anleitung ist aktualisiert, TC 1.2.0 ist jetzt ebenfalls online.

[LukeWCS]

Hallo Kollegen

Ich arbeite an einer neuen Version von TC, mit der die Integration der TC Schnittstelle in eigene Erweiterungen einfacher wird.

1. Wegfall der Deklaration der lokalen Template Variable switch_type.

Diese Zeile wird dann nicht mehr benötigt:

Code: Alles auswählen

{% set switch_type = TOGGLECTRL_TYPE ?? 'toggle' %}

2. Wegfall der Zuweisung von switch_type als dritten Parameter bei switch() bei jedem Schalter.

Bisher:

Code: Alles auswählen

{{ _self.switch('name_des_formular_elements', TEMPLATE_VARIABLE_DES_FORMULAR_ELEMENTS, switch_type) }}

Neu:

Code: Alles auswählen

{{ _self.switch('name_des_formular_elements', TEMPLATE_VARIABLE_DES_FORMULAR_ELEMENTS) }}

3. Ersetzen des switch() Makros durch eine neue Variante.

Möglich wird das durch eine Überarbeitung des Makros in Kombination mit der Injektion einer echten globalen Template Variable. Das habe ich gestern erst in der Twig Doku entdeckt und damit experimentiert, ob und wie ich das in einer phpBB Umgebung nutzen könnte, was mir dann auch gelungen ist. Somit kümmert sich das neue Makro um die komplette Twig Steuerung und reduziert den Aufwand auf ein Minimum.

TC 1.3.0 wird abwärtskompatibel sein. Das heisst Erweiterungen die bereits eine TC Schnittstelle integriert haben, müssen nicht zwingend angepasst werden, da die bisherige Methode auch bei 1.3.0 weiterhin funktionieren wird. Erst wenn auf die neue Methode umgestellt wird, ist TC 1.3.0+ notwendig.

[chris1278]

Bin schon gespannt auf die erste Version.

[Dref]

Es wäre großartig, die Schalter für das UCP zu haben.

[LukeWCS]

TC unterstützt UCP, aber andere Schalter-Stile müssen von den jeweiligen Ext Entwicklern auch explizit im UCP eingebaut werden. TC ist nur eine Schnittstelle zum Auswählen.

[LukeWCS]

nAbend Kollegen

Udo und ich haben die neue Methode bereits im kleinen Rahmen getestet. Da 1.3.0 insgesamt zwar ein sehr kleines Update ist, aber dennoch eine gravierende Änderung beim Konzept darstellt, habe ich das noch nicht direkt als Release veröffentlicht.

Stattdessen steht jetzt die Beta 1.3.0-b2 zur Verfügung, damit ihr euch das mal vorab anschauen und testen könnt:

https://github.com/LukeWCS/toggle-contr ... /dev/1.3.0

Rückmeldungen gerne hier.

Vorab an dieser Stelle auch die neue Fassung der Anleitung:

[ spoiler entfernt ]

[Dref]

Ich habe eine Bemerkung zur Richtung des Schalters, warum haben wir ihn umgekehrt?
Bei allen Web-Anwendungen mit einem Schalter gleitet man von links nach rechts, um anzunehmen.