Spec-Zone.ru › Symfony 3.0

LazyChoiceList

class LazyChoiceList implements ChoiceListInterface

Список выбора, загружающий значения выборов лениво.

Выборы извлекаются с помощью экземпляра {@link ChoiceLoaderInterface}. Если вызываются только {@link getChoicesForValues()} или {@link getValuesForChoices()}, список выбора загружается частично для повышения производительности.

После вызова {@link getChoices()} или {@link getValues()} список загружается полностью.

Методы

__construct(ChoiceLoaderInterface $loader, callable $value = null)

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

массив getChoices()

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

массив строк getValues()

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

массив строк getStructuredValues()

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

массив целых чисел/строк getOriginalKeys()

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

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

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

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

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

Подробности

__construct(ChoiceLoaderInterface $loader, callable $value = null)

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

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

Параметры

ChoiceLoaderInterface $loader Загрузчик выборов
вызываемый объект $value Вызываемый объект, генерирующий значения выборов

массив 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'),
)

Возвращаемое значение

массив строк Значения выборов

массив целых чисел/строк getOriginalKeys()

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

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

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

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

Возвращаемое значение

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

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

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

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

Параметры

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

Возвращаемое значение

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

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

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

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

Параметры

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

Возвращаемое значение

массив строк Массив значений выборов

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

Spec-Zone.ru

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