SimpleChoiceList устаревший
class SimpleChoiceList extends ChoiceList
устаревший
Список выбора для вариантов типа строка или целое число.
Варианты и их соответствующие метки могут быть переданы в одном массиве. Поскольку варианты передаются как ключи массива, разрешены только варианты типа строка или целое число. Варианты также могут быть переданы как иерархия неограниченной глубины, создавая вложенные массивы. Заголовок под-иерархии может храниться в ключе массива, указывающем на вложенный массив.
$choiceList = new SimpleChoiceList(array(
'creditcard' => 'Credit card payment',
'cash' => 'Cash payment',
));
Методы
| __construct(array|Traversable $choices, array $preferredChoices = array()) Создает новый простой список выбора. | ||
| массив | getChoices() Возвращает список вариантов. | из ChoiceList |
| массив | getValues() Возвращает значения для вариантов. | из ChoiceList |
| массив | getPreferredViews() Возвращает представления выбранных вариантов в виде вложенного массива, где ключами верхнего уровня являются группы вариантов. | из ChoiceList |
| массив | getRemainingViews() Возвращает представления вариантов, которые не являются предпочтительными, в виде вложенного массива, где ключами верхнего уровня являются группы вариантов. | из ChoiceList |
| массив | getChoicesForValues(array $values) Возвращает варианты, соответствующие заданным значениям. | |
| массив | getValuesForChoices(array $choices) Возвращает значения, соответствующие заданным вариантам. | |
| массив | getIndicesForChoices(array $choices) устаревший Возвращает индексы, соответствующие заданным вариантам. | из ChoiceList |
| массив | getIndicesForValues(array $values) устаревший Возвращает индексы, соответствующие заданным значениям. | из ChoiceList |
Подробности
__construct(array|Traversable $choices, array $preferredChoices = array())
Создает новый простой список выбора.
Параметры
| array|Traversable | $choices | Массив вариантов. Варианты также могут быть переданы в виде иерархии неограниченной глубины. Иерархии создаются путем создания вложенных массивов. Заголовок под-иерархии может храниться в ключе массива, указывающем на вложенный массив. Самый верхний уровень иерархии также может быть объектом \Traversable. |
| массив | $preferredChoices | плоский массив вариантов, которые должны быть представлены пользователю в приоритетном порядке |
массив getChoices()
Возвращает список вариантов.
Значение возврата
| массив | Варианты со своими индексами в качестве ключей |
массив getValues()
Возвращает значения для вариантов.
Значение возврата
| массив | Значения с соответствующими индексами вариантов в качестве ключей |
массив getPreferredViews()
Возвращает представления выбранных вариантов в виде вложенного массива, где ключами верхнего уровня являются группы вариантов.
Пример:
Значение возврата
| массив | Вложенный массив, содержащий представления с соответствующими индексами вариантов в качестве ключей на нижних уровнях и названиями групп вариантов в качестве ключей на верхних уровнях |
массив getRemainingViews()
Возвращает представления вариантов, которые не являются предпочтительными, в виде вложенного массива, где ключами верхнего уровня являются группы вариантов.
Пример:
Значение возврата
| массив | Вложенный массив, содержащий представления с соответствующими индексами вариантов в качестве ключей на нижних уровнях и названиями групп вариантов в качестве ключей на верхних уровнях |
массив getChoicesForValues(array $values)
Возвращает варианты, соответствующие заданным значениям.
Варианты могут иметь любой тип данных.
Варианты должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.
Параметры
| массив | $values | Массив значений вариантов. Отсутствующие значения в этом массиве игнорируются |
Значение возврата
| массив | Массив вариантов с возрастающими численными ключами, начинающимися с 0 |
массив getValuesForChoices(array $choices)
Возвращает значения, соответствующие заданным вариантам.
Значения должны быть строками.
Значения должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.
Параметры
| массив | $choices | Массив вариантов. Отсутствующие варианты в этом массиве игнорируются |
Значение возврата
| массив | Массив значений вариантов с возрастающими численными ключами, начинающимися с 0 |
массив getIndicesForChoices(array $choices) устаревший
устаревший
Возвращает индексы, соответствующие заданным вариантам.
Индексы должны быть положительными целыми числами или строками, принимаемыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.
Индекс "заполнитель" зарезервирован внутри.
Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие варианты в заданном массиве.
Параметры
| массив | $choices | Массив вариантов. Отсутствующие варианты в этом массиве игнорируются |
Значение возврата
| массив | Массив индексов с возрастающими численными ключами, начинающимися с 0 |
массив getIndicesForValues(array $values) устаревший
устаревший
Возвращает индексы, соответствующие заданным значениям.
Индексы должны быть положительными целыми числами или строками, принимаемыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.
Индекс "заполнитель" зарезервирован внутри.
Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.
Параметры
| массив | $values | Массив значений вариантов. Отсутствующие значения в этом массиве игнорируются |
Значение возврата
| массив | Массив индексов с возрастающими численными ключами, начинающимися с 0 |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Form/Extension/Core/ChoiceList/SimpleChoiceList.html
