Skupiny a záložky

Skupiny organizují pole formuláře do vizuálních bloků. Každá skupina se zobrazí jako samostatná sekce s hlavičkou a sadou polí. Skupiny lze volitelně zobrazit jako záložky.

Konfigurace skupiny

Skupiny se definují v poli Groups v JSON konfiguraci formuláře.

Vlastnost	Popis	Výchozí
Id	Jedinečný identifikátor skupiny. Pokud je zadán, skupina je přístupná přes Group API.	hodnota Name
Name	Zobrazovaný název skupiny v UI. [Povinné]	—
Hidden	Skryje skupinu včetně všech jejích polí.	false
Collapsed	Zobrazí skupinu ve sbaleném stavu. Uživatel může skupinu rozbalit kliknutím na hlavičku.	false
Columns	Definice sloupců pro vícesloupcové rozložení.	—
Fields	Pole přiřazená do skupiny. [Povinné]	—

Příklad: Skupina s poli

{
  "Groups": [
    {
      "Id": "G_Basic",
      "Name": "Základní údaje",
      "Fields": [
        { "InternalName": "Title" },
        { "InternalName": "Status" },
        { "InternalName": "Created" }
      ]
    },
    {
      "Id": "G_Details",
      "Name": "Detaily",
      "Collapsed": true,
      "Fields": [
        { "InternalName": "Description", "FullWidth": true },
        { "InternalName": "Category" }
      ]
    }
  ]
}

Sloupce (Columns)

Skupiny mohou rozdělit pole do více sloupců pomocí vlastnosti Columns. Každý sloupec má Id a Name. Pole se do sloupců přiřazují pomocí vlastnosti TargetColumn na poli.

{
  "Groups": [
    {
      "Name": "Dodavatel",
      "Columns": [
        { "Id": "Left", "Name": "Levý sloupec" },
        { "Id": "Right", "Name": "Pravý sloupec" }
      ],
      "Fields": [
        { "InternalName": "SupplierName", "TargetColumn": "Left" },
        { "InternalName": "SupplierICO", "TargetColumn": "Left" },
        { "InternalName": "ContactPerson", "TargetColumn": "Right" },
        { "InternalName": "ContactEmail", "TargetColumn": "Right" }
      ]
    }
  ]
}

Zobrazení jako záložky

Vlastnost DisplayGroupsAsTabs v kořeni konfigurace formuláře přepne zobrazení skupin na záložky (tabs). Každá skupina se zobrazí jako samostatná záložka — přepínání mezi záložkami probíhá kliknutím na hlavičku záložky.

{
  "DisplayGroupsAsTabs": true,
  "Groups": [
    {
      "Name": "Základní údaje",
      "Fields": [
        { "InternalName": "Title" },
        { "InternalName": "Status" }
      ]
    },
    {
      "Name": "Přílohy",
      "Fields": [
        { "InternalName": "Attachments", "FullWidth": true }
      ]
    }
  ]
}