ObjectChoiceList ^{устаревшее}

__construct(array|Traversable $choices, string $labelPath = null, array $preferredChoices = array(), string $groupPath = null, string $valuePath = null, PropertyAccessorInterface $propertyAccessor = null)

Создаёт новый список выбора объектов.

Параметры

array|Traversable	$choices	Массив вариантов. Варианты также могут быть заданы в виде иерархии неограниченной глубины. Иерархии создаются путём создания вложенных массивов. Заголовок под-иерархии может храниться в ключе массива, указывающем на вложенный массив. Верхний уровень иерархии также может быть \Traversable.
string	$labelPath	Путь к свойству, используемому для меток выбора. Значение получается путём вызова геттера объекта. Если путь равен NULL, вместо этого используется метод __toString() объекта.
array	$preferredChoices	Плоский массив вариантов, которые должны быть представлены пользователю в приоритетном порядке.
string	$groupPath	Путь к свойству, используемому для группировки вариантов. Разрешено только если варианты заданы как плоский массив.
string	$valuePath	Путь к свойству, используемому для значений вариантов. Если не указано, вместо этого генерируются целые числа.
PropertyAccessorInterface	$propertyAccessor	Граф отражения для чтения путей свойств.

array getChoices()

Возвращает список вариантов.

Значение результата

array

Варианты с их индексами в качестве ключей

array getValues()

Возвращает значения для вариантов.

Значение результата

array

Значения с соответствующими индексами вариантов в качестве ключей

array getPreferredViews()

Возвращает представления выбранных вариантов в виде вложенного массива с группами вариантов в качестве ключей верхнего уровня.

Пример:

array( 'Группа 1' => array( 10 => Объект ChoiceView, 20 => Объект ChoiceView, ), 'Группа 2' => array( 30 => Объект ChoiceView, ), )

Значение результата

array

Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на нижних уровнях и именами групп выбора в качестве ключей на верхних уровнях

array getRemainingViews()

Возвращает представления вариантов, которые не являются предпочтительными, в виде вложенного массива с группами вариантов в качестве ключей верхнего уровня.

Пример:

array( 'Группа 1' => array( 10 => Объект ChoiceView, 20 => Объект ChoiceView, ), 'Группа 2' => array( 30 => Объект ChoiceView, ), )

Значение результата

array

Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на нижних уровнях и именами групп выбора в качестве ключей на верхних уровнях

array getChoicesForValues(array $values)

Возвращает варианты, соответствующие заданным значениям.

Варианты могут иметь любой тип данных.

Варианты должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.

Параметры

array

$values

Массив значений вариантов. Несуществующие значения в этом массиве игнорируются

Значение результата

array

Массив вариантов с возрастающими, нумерованными с 0 индексами

array getValuesForChoices(array $choices)

Возвращает значения, соответствующие заданным вариантам.

Значения должны быть строками.

Значения должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.

Параметры

array

$choices

Массив вариантов. Несуществующие варианты в этом массиве игнорируются

Значение результата

array

Массив значений вариантов с возрастающими, нумерованными с 0 индексами

array getIndicesForChoices(array $choices) ^{устаревшее}

^{устаревшее}

since версия 2.4, будет удалено в 3.0.

Возвращает индексы, соответствующие заданным вариантам.

Индексы должны быть положительными целыми числами или строками, принятыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.

Индекс "заполнитель" зарезервирован внутри.

Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.

Параметры

array

$choices

Массив вариантов. Несуществующие варианты в этом массиве игнорируются

Значение результата

array

Массив индексов с возрастающими, нумерованными с 0 индексами

array getIndicesForValues(array $values) ^{устаревшее}

^{устаревшее}

since версия 2.4, будет удалено в 3.0.

Возвращает индексы, соответствующие заданным значениям.

Индексы должны быть положительными целыми числами или строками, принятыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.

Индекс "заполнитель" зарезервирован внутри.

Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.

Параметры

array

$values

Массив значений вариантов. Несуществующие значения в этом массиве игнорируются

Значение результата

array

Массив индексов с возрастающими, нумерованными с 0 индексами