Класс yii\jui\AutoComplete
| Наследование | yii\jui\AutoComplete » yii\jui\InputWidget » yii\jui\Widget » yii\base\Widget » yii\base\Component » yii\base\Object |
|---|---|
| Реализует | yii\base\Configurable, yii\base\ViewContextInterface |
| Доступно с версии | 2.0 |
| Исходный код | https://github.com/yiisoft/yii2-jui/blob/master/AutoComplete.php |
AutoComplete отображает виджет автозаполнения jQuery UI.
Например:
echo AutoComplete::widget([
'model' => $model,
'attribute' => 'country',
'clientOptions' => [
'source' => ['USA', 'RUS'],
],
]);
В следующем примере будет использоваться свойство name:
echo AutoComplete::widget([
'name' => 'country',
'clientOptions' => [
'source' => ['USA', 'RUS'],
],
]);
Вы также можете использовать этот виджет в \yii\jui\yii\widgets\ActiveForm с помощью метода \yii\jui\yii\widgets\ActiveField::widget(), например, так:
<?= $form->field($model, 'from_date')->widget(\yii\jui\AutoComplete::classname(), [
'clientOptions' => [
'source' => ['USA', 'RUS'],
],
]) ?>
См. также http://api.jqueryui.com/autocomplete/.
Публичные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $attribute | string | Атрибут модели, с которым связан этот виджет. | yii\jui\InputWidget |
| $autoIdPrefix | string | Префикс для автоматически сгенерированных идентификаторов виджетов. | yii\base\Widget |
| $behaviors | yii\base\Behavior[] | Список присоединенных к этому компоненту поведений. | yii\base\Component |
| $clientEvents | array | Обработчики событий для базового виджета jQuery UI. | yii\jui\Widget |
| $clientOptions | array | Параметры для базового виджета jQuery UI. | yii\jui\Widget |
| $counter | integer | Счетчик, используемый для генерации $id виджетов. | yii\base\Widget |
| $id | string | Идентификатор виджета. | yii\base\Widget |
| $model | yii\base\Model | Модель данных, с которой связан этот виджет. | yii\jui\InputWidget |
| $name | string | Имя входного поля. | yii\jui\InputWidget |
| $options | array | Атрибуты HTML для тега контейнера виджета. | yii\jui\Widget |
| $stack | yii\base\Widget[] | Виджеты, которые в настоящее время отображаются (не завершены). | yii\base\Widget |
| $value | string | Значение входного поля. | yii\jui\InputWidget |
| $view | yii\web\View | Объект представления, который можно использовать для отображения представлений или файлов представлений. | yii\base\Widget |
| $viewPath | string | Директория, содержащая файлы представлений для этого виджета. | yii\base\Widget |
Защищенные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $clientEventMap | array | Имена событий, сопоставленные с тем, что должно быть указано в `. | yii\jui\Widget |
Публичные методы
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает именованный метод, который не является методом класса. | yii\base\Object |
| __clone() | Этот метод вызывается после создания объекта путём клонирования существующего. | yii\base\Component |
| __construct() | Конструктор. | yii\base\Object |
| __get() | Возвращает значение свойства объекта. | yii\base\Object |
| __isset() | Проверяет, установлено ли свойство, т.е. определено и не равно null. | yii\base\Object |
| __set() | Устанавливает значение свойства объекта. | yii\base\Object |
| __unset() | Устанавливает свойство объекта в значение null. | yii\base\Object |
| afterRun() | Этот метод вызывается сразу после выполнения виджета. | yii\base\Widget |
| attachBehavior() | Присоединяет поведение к этому компоненту. | yii\base\Component |
| attachBehaviors() | Присоединяет список поведений к компоненту. | yii\base\Component |
| beforeRun() | Этот метод вызывается непосредственно перед выполнением виджета. | yii\base\Widget |
| begin() | Начало работы виджета. | yii\base\Widget |
| behaviors() | Возвращает список поведений, по которым должен действовать этот компонент. | yii\base\Component |
| canGetProperty() | Возвращает значение, указывающее, можно ли прочитать свойство. | yii\base\Object |
| canSetProperty() | Возвращает значение, указывающее, можно ли установить свойство. | yii\base\Object |
| className() | Возвращает полное квалифицированное имя этого класса. | yii\base\Object |
| detachBehavior() | Отсоединяет поведение от компонента. | yii\base\Component |
| detachBehaviors() | Отсоединяет все поведения от компонента. | yii\base\Component |
| end() | Окончание работы виджета. | yii\base\Widget |
| ensureBehaviors() | Убеждается, что поведения, объявленные в behaviors(), присоединены к этому компоненту. | yii\base\Component |
| getBehavior() | Возвращает объект именованного поведения. | yii\base\Component |
| getBehaviors() | Возвращает все присоединённые к этому компоненту поведения. | yii\base\Component |
| getId() | Возвращает идентификатор виджета. | yii\base\Widget |
| getView() | Возвращает объект представления, который можно использовать для отображения представлений или файлов представлений. | yii\base\Widget |
| getViewPath() | Возвращает директорию, содержащую файлы представлений для этого виджета. | yii\base\Widget |
| hasEventHandlers() | Возвращает значение, указывающее, есть ли обработчик, присоединённый к указанному событию. | yii\base\Component |
| hasMethod() | Возвращает значение, указывающее, определён ли метод. | yii\base\Object |
| hasProperty() | Возвращает значение, указывающее, определено ли свойство. | yii\base\Object |
| init() | Инициализирует объект. | yii\base\Widget |
| off() | Отсоединяет существующий обработчик событий от этого компонента. | yii\base\Component |
| on() | Присоединяет обработчик событий к событию. | yii\base\Component |
| render() | Отображает представление. | yii\base\Widget |
| renderFile() | Отображает файл представления. | yii\base\Widget |
| renderWidget() | Отображает виджет AutoComplete. | yii\jui\AutoComplete |
| run() | Выполняет виджет. | yii\jui\AutoComplete |
| setId() | Устанавливает идентификатор виджета. | yii\base\Widget |
| setView() | Устанавливает объект представления, который будет использоваться этим виджетом. | yii\base\Widget |
| trigger() | Вызывает событие. | yii\base\Component |
| widget() | Создаёт экземпляр виджета и запускает его. | yii\base\Widget |
Защищённые методы
| Метод | Описание | Определено в |
|---|---|---|
| hasModel() | yii\jui\InputWidget | |
| registerClientEvents() | Регистрирует события конкретного виджета jQuery UI. | yii\jui\Widget |
| registerClientOptions() | Регистрирует параметры конкретного виджета jQuery UI. | yii\jui\Widget |
| registerWidget() | Регистрирует пакет ресурсов конкретного виджета jQuery UI, инициализирует его параметрами клиента и регистрирует связанные события | yii\jui\Widget |
События
| Событие | Тип | Описание | Определено в |
|---|---|---|---|
| EVENT_AFTER_RUN | yii\base\WidgetEvent | Событие, генерируемое сразу после выполнения виджета. (доступно начиная с версии 2.0.11) | yii\base\Widget |
| EVENT_BEFORE_RUN | yii\base\WidgetEvent | Событие, генерируемое непосредственно перед выполнением виджета. (доступно начиная с версии 2.0.11) | yii\base\Widget |
| EVENT_INIT | yii\base\Event | Событие, которое срабатывает при инициализации виджета с помощью init(). (доступно начиная с версии 2.0.11) | yii\base\Widget |
Подробности методов
renderWidget() метод public
Отображает виджет AutoComplete.
| public string renderWidget ( ) | ||
|---|---|---|
| возвращает | string |
Результат отрисовки. |
run() метод public
Выполняет виджет.
| public string run ( ) | ||
|---|---|---|
| возвращает | string |
Результат выполнения виджета для вывода. |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-jui-autocomplete.html