ChoiceListInterface устаревший
интерфейс ChoiceListInterface
устаревший
Содержит варианты, которые можно выбрать в поле формы.
Каждый вариант имеет три разных свойства:
- Вариант: Вариант, который должен быть возвращен приложению полем выбора. Может быть любым скалярным значением или объектом, но не массивом.
- Метка: Текст, представляющий вариант, который отображается пользователю.
- Значение: Уникальное идентифицирующее значение, которое может содержать любые символы, но не массивы или объекты. Это значение отображается в атрибуте HTML «value».
Методы
| массив | getChoices() Возвращает список вариантов. | |
| массив | getValues() Возвращает значения для вариантов. | |
| массив | getPreferredViews() Возвращает представления выбранных вариантов в виде вложенного массива, где ключами верхнего уровня являются группы вариантов. | |
| массив | getRemainingViews() Возвращает представления вариантов, которые не являются предпочтительными, в виде вложенного массива, где ключами верхнего уровня являются группы вариантов. | |
| массив | getChoicesForValues(массив $values) Возвращает варианты, соответствующие заданным значениям. | |
| массив | getValuesForChoices(массив $choices) Возвращает значения, соответствующие заданным вариантам. | |
| массив | getIndicesForChoices(массив $choices) устаревший Возвращает индексы, соответствующие заданным вариантам. | |
| массив | getIndicesForValues(массив $values) устаревший Возвращает индексы, соответствующие заданным значениям. |
Подробности
массив getChoices()
Возвращает список вариантов.
Возвращаемое значение
| массив | Варианты со своими индексами в качестве ключей |
массив getValues()
Возвращает значения для вариантов.
Возвращаемое значение
| массив | Значения с соответствующими индексами выбора в качестве ключей |
массив getPreferredViews()
Возвращает представления выбранных вариантов в виде вложенного массива, где ключами верхнего уровня являются группы вариантов.
Пример:
Возвращаемое значение
| массив | Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на самых низких уровнях и названиями групп вариантов в качестве ключей на более высоких уровнях |
массив getRemainingViews()
Возвращает представления вариантов, которые не являются предпочтительными, в виде вложенного массива, где ключами верхнего уровня являются группы вариантов.
Пример:
Возвращаемое значение
| массив | Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на самых низких уровнях и названиями групп вариантов в качестве ключей на более высоких уровнях |
См. также
| getPreferredValues() |
массив getChoicesForValues(массив $values)
Возвращает варианты, соответствующие заданным значениям.
Варианты могут иметь любой тип данных.
Варианты должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.
Параметры
| массив | $values | Массив значений вариантов. Отсутствующие значения в этом массиве игнорируются |
Возвращаемое значение
| массив | Массив вариантов с возрастающими целочисленными ключами от 0 |
массив getValuesForChoices(массив $choices)
Возвращает значения, соответствующие заданным вариантам.
Значения должны быть строками.
Значения должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.
Параметры
| массив | $choices | Массив вариантов. Отсутствующие варианты в этом массиве игнорируются |
Возвращаемое значение
| массив | Массив значений вариантов с возрастающими целочисленными ключами от 0 |
массив getIndicesForChoices(массив $choices) устаревший
устаревший
Возвращает индексы, соответствующие заданным вариантам.
Индексы должны быть положительными целыми числами или строками, принимаемыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.
Индекс "placeholder" зарезервирован внутри.
Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.
Параметры
| массив | $choices | Массив вариантов. Отсутствующие варианты в этом массиве игнорируются |
Возвращаемое значение
| массив | Массив индексов с возрастающими целочисленными ключами от 0 |
массив getIndicesForValues(массив $values) устаревший
устаревший
Возвращает индексы, соответствующие заданным значениям.
Индексы должны быть положительными целыми числами или строками, принимаемыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.
Индекс "placeholder" зарезервирован внутри.
Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.
Параметры
| массив | $values | Массив значений вариантов. Отсутствующие значения в этом массиве игнорируются |
Возвращаемое значение
| массив | Массив индексов с возрастающими целочисленными ключами от 0 |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Form/Extension/Core/ChoiceList/ChoiceListInterface.html
