neckarpixel / contao-nprangeslider-bundle
Contao 5 backend widget: range slider with live value display and labeled scale (inputType 'rangeSlider').
Package info
github.com/neckarpixel/contao-nprangeslider-bundle
Type:contao-bundle
pkg:composer/neckarpixel/contao-nprangeslider-bundle
Requires
- php: ^8.1
- contao/core-bundle: ^5.0
Requires (Dev)
- contao/manager-plugin: ^2.0
- friendsofphp/php-cs-fixer: ^3.0
- phpunit/phpunit: ^9.5
- symfony/phpunit-bridge: ^5.4 || ^6.0
Suggests
None
Provides
None
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
Replaces
None
This package is auto-updated.
Last update: 2026-09-18 11:04:14 UTC
README
Standalone Contao-5-Backend-Widget: ein <input type="range"> mit
sichtbarer Skala und Live-Wertanzeige, nutzbar als eigener inputType
in jeder DCA-Definition — unabhängig von anderen Bundles.
Eigenschaften
- Neuer Backend-Feldtyp
rangeSlider($GLOBALS['BE_FFL']['rangeSlider']) - Live-Wertanzeige neben dem Slider (
<output>, aktualisiert per JS während des Ziehens, nicht erst nach dem Loslassen) - Fest positionierte, textuelle Skalenbeschriftung unter dem Slider
(funktioniert zuverlässig in allen Browsern — anders als
<datalist>, das beitype="range"nur browserabhängige Tick-Marks zeigt, keinen Text, und von Safari dort gar nicht unterstützt wird) - CSS/JS werden ausschließlich im Contao-Backend geladen, nie im Frontend
- Keine Abhängigkeiten zu anderen Neckarpixel/Np-Bundles
Installation
composer require neckarpixel/contao-nprangeslider-bundle
Danach in Contao Manager die Datenbank aktualisieren (Bundle wird automatisch über die Contao-Manager-Plugin-Erkennung registriert).
Verwendung
In einer beliebigen DCA-Datei (z. B. tl_content.php):
$GLOBALS['TL_DCA']['tl_content']['fields']['myField'] = [ 'label' => &$GLOBALS['TL_LANG']['tl_content']['myField'], 'inputType' => 'rangeSlider', 'eval' => [ 'min' => 0, 'max' => 12, 'step' => 1, 'marks' => [ ['value' => 0, 'label' => 'Aus'], ['value' => 6, 'label' => 'Mitte'], ['value' => 12, 'label' => 'Max'], ], ], 'sql' => "int(10) NOT NULL default '0'", ];
eval-Optionen
| Option | Typ | Beschreibung |
|---|---|---|
min |
int | Minimalwert des Sliders |
max |
int | Maximalwert des Sliders |
step |
int | Schrittweite |
marks |
array | Liste von ['value' => int, 'label' => string] für die Skalenbeschriftung unter dem Slider |
Kompatibilität
- Contao
^5.0 - PHP
^8.1
Lizenz
LGPL-3.0-or-later — siehe LICENSE und COPYING.LESSER.