Spec-Zone.ru › Symfony 3.2

ChoiceListInterface

интерфейс ChoiceListInterface

Список вариантов, которые можно выбрать в поле выбора.

Список вариантов присваивает уникальные строковые значения каждому из списка вариантов. Эти строковые значения отображаются в атрибутах "value" в HTML и отправляются обратно на сервер.

Допустимые типы данных для вариантов зависят от реализации. Значения всегда должны быть строками и (внутри списка) не должны содержать дубликатов.

Методы

массив getChoices()

Возвращает все выбираемые варианты.

строка[] getValues()

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

строка[] getStructuredValues()

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

int[]|строка[] getOriginalKeys()

Возвращает исходные ключи вариантов.

массив getChoicesForValues(массив $values)

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

строка[] getValuesForChoices(массив $choices)

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

Подробности

массив getChoices()

Возвращает все выбираемые варианты.

Значение

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

строка[] getValues()

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

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

Значение

строка[] Значения вариантов

строка[] getStructuredValues()

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

В отличие от {@link getValues()}, результат индексируется исходными ключами вариантов. Если исходный массив содержал вложенные массивы, эти вложенные массивы также представлены здесь:

$form->add('field', 'choice', array(
    'choices' => array(
        'Decided' => array('Yes' => true, 'No' => false),
        'Undecided' => array('Maybe' => null),
    ),
));

В этом примере, результат этого метода:

array(
    'Decided' => array('Yes' => '0', 'No' => '1'),
    'Undecided' => array('Maybe' => '2'),
)

Значение

строка[] Значения вариантов

int[]|строка[] getOriginalKeys()

Возвращает исходные ключи вариантов.

Исходные ключи — это ключи массива вариантов, которые были переданы в опцию "choice" типа выбора. Обратите внимание, что этот массив может содержать дубликаты, если опция "choice" содержала группы вариантов:

$form->add('field', 'choice', array(
    'choices' => array(
        'Decided' => array(true, false),
        'Undecided' => array(null),
    ),
));

В этом примере, исходный ключ 0 появляется дважды, один раз для true и один раз для null.

Значение

int[]|строка[] Исходные ключи выбора, индексированные соответствующими значениями выбора

массив getChoicesForValues(массив $values)

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

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

Параметры

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

Значение

массив Массив вариантов

строка[] getValuesForChoices(массив $choices)

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

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

Параметры

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

Значение

строка[] Массив значений вариантов

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/Form/ChoiceList/ChoiceListInterface.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API