MultiTextWizard: Unterschied zwischen den Versionen

Version vom 1. September 2010, 09:36 Uhr

Auszeichnungen zum Kategorisieren von Elementen.

MultiTextWizard (Mehrere Textfelder pro Zeile)

MultiTextWizard ist ein Contao Widget zur Eingabe von mehren Textfeldern pro Zeile innerhalb eines Backend-Formulars. Die Anzahl der Textfelder pro Zeile und ein optionales Array mit den Spaltenüberschriften können als Parameter für dieses Widget verwendet werden.

Ausgabe einer MultitextWizard-Eingabe mit zwei Spalten im Contao Backend

Einbinden von MultiTextWizard in Backend-Formulare ab Version 1.1.0 (empfohlen)

Die Einbindung von MultiTextWizard ist denkbar einfach. Über einen einzigen eval-Parameter kann die Multitext-Matrix mit Überschriften und Überprüfungen eingegeben werden.

'fields' => array
(
  'authors' => array
  (
    'label'     => &$GLOBALS['TL_LANG']['tl_literature']['authors'],
    'inputType' => 'multitextWizard',
    'eval'      => array
      (
        'style'=>'width:100%;',
        'columns' => array
          (
            array
            (
              'name' => 'firstname', // optional
              'label' => &$GLOBALS['TL_LANG']['tl_literature']['firstname'],
              'mandatory' => false, // optional
            ),
            array
            (
              'name' => 'lastname',  // optional
              'label' => &$GLOBALS['TL_LANG']['tl_literature']['lastname'],
              'mandatory' => true, // optional
              'rgxp' => 'alpha', // optional
            )
          )
       )
  ),

d.h. es können pro Spalte ein optionaler Bezeichner (name), eine Spaltenüberschrift (label), eine optionale Angabe als Pflichtfeld (mandatory) und ein optionaler regulärer Ausdruck zur Überprüfung des Inhaltes (rgxp) angegeben werden. Falls die optionalen Angaben mandatory und rgxp herkömmlich im eval-Array des DCA-Containers definiert sind, werden diese für alle Spalten übernommen. Eine Definition im columns Array überschreibt die globalen Einstellungen des DCA-Containers.

Einbinden von MultiTextWizard in Backend-Formulare vor Version 1.1.0

Die Einbindung von MultiTextWizard ist denkbar einfach. Die Anzahl der verfügbaren Spalten lässt sich über den Parameter columns angeben. Optional kann über den Parameter labels ein Array mit columns Elementen angegeben werden, dessen Inhalte dann als Spaltenüberschriften interpretiert und ausgegeben werden.

Das folgende Beispiel illustriert die Einbindung von MultiTextWizard innerhalb eines field-Arrays in einem Contao Datacontainer:

'fields' => array
(
  'authors' => array
  (
    'label'     => &$GLOBALS['TL_LANG']['tl_literature']['authors'],
    'inputType' => 'multitextWizard',
    'eval'      => array
      (
        'mandatory' => false, 
        'doNotSaveEmpty'=>true, 
        'style'=>'width:142px;', 
        'columns' => 2, 
        'labels' => array
          (
            &$GLOBALS['TL_LANG']['tl_literature']['firstname'], 
            &$GLOBALS['TL_LANG']['tl_literature']['lastname']
          )
       )
  ),

--Hschottm 09:59, 1. Sep. 2010 (CEST)