Field tablemulticombo

Version: Pro.

Why this type

Several values from the same source as tablecombo: a MODX class and optionsSource. In the inspector this is a searchable list, not a grid. The data stores valueField values only, not the rows. Without optionsSource the list is empty.

When to use

• Multi-brand filter ids
• Several category row keys from a table
• Curated id list without a relation modal

Tips

Objects with pagetitle → multirelation. Static list → multiselect.

Similar types

• tablecombo for a single table id
• multicombo for an xPDO class list

Schema

{
  "name": "templates",
  "type": "tablemulticombo",
  "label": "Templates",
  "optionsSource": {
    "class": "modTemplate",
    "valueField": "id",
    "labelField": "templatename",
    "limit": 50
  },
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Array of valueField values.

Section data

Key templates in the section data: array of values:

{
  "templates": [3, 5]
}

Chunk example

modx

{foreach $templates as $id}
  <span>{$id}</span>
{/foreach}

fenom

{foreach $templates as $id}
  <span>{$id}</span>
{/foreach}

Common properties

For fields with name that are stored in the section data:

Key	Type	Role	CMP
tab	string	Group subtitle in the inspector	yes
width	25–100	Field width as % of the row (flex)	yes
description	string	Hint under the label	yes
default	any	Initial value for a new section	yes
active	bool	false hides the field in the inspector	yes
required	bool	Required on publish (draft still saves)	yes

See fields overview.

See also

• Field types reference
• Fields overview
• Pro in manager