# j-Suggestion

> Ако стойността не е определена, тогава компонентът използва името като стойност.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: bg
Content-SHA256: 8d444180518bff18876f84cd382f49d1a831a6146d32ef24aff54a2dc89b1115
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

- Поддържа 3 ориентации `left`, `center` и `right`
- Синглът
- Работи с Bootstrap
- Работи с допир
- Поддържат тъмния режим


__Методи__:

Методът: `component.show(orientation, targetElement, [items/function(search, next)], clickCallback)`

- `orientation {String}` може да бъде `left`, `center` или `right`
- `targetElement {Selector/jQuery/Element}` е цел, където компонентът ще бъде видим
- `items {Array}` е факултативен и трябва да има тази структура: В противен случай `[{ name: String, value: String, icon: String }]` ще бъде прочетена от атрибута на целевия `data-options`.
- `callback(selectedItem) {Function}` се освобождава, когато потребителят кликне върху елемента

Методът: `component.hide()`

__Атрибути__:
- `targetElement` може да съдържа атрибут на `data-options="Name 1|ti-building|Value 1;Name 2|ti-github|Value 2;"` с всички елементи в контекстния меню.

__Конфигуриране__:
- `placeholder` - място за вход на търсенето

__Търсене на сървър__:

```javascript
SETTER('suggestion', 'show', element, function(search, next) {
	next([{ name: 'Item 1' }, { name: 'Item 2' }]);
}, function(selected) {
	console.log(selected);
});
```

Ако `value` не е дефиниран, тогава компонентът използва `name` като `value`.

__Глобални събития__:

```javascript
ON('suggestion', function(visible, component, target) {
	console.log('Suggestion is', visible ? 'visible' : 'hidden');
});
```

Използвайте го с `<ui-component name="suggestion">`Когато компонентът все още не е зареден, jComponent Изтегляне на първия адрес в `DEF.fallback` (След това Componentator Източник: Питър Шерка Componentator Съставни съставки, лиценз на MIT.

```html example.html
<style>
	body { background-color: #F0F0F0; }
</style>

<ui-component name="suggestion" config="placeholder:Search ..."></ui-component>

<div class="container">
	<a href="javascript:void(0)">Suggest</a>
</div>

<script>
	$(document).on('click', 'a', function() {
		SETTER('suggestion/show', 'left', this, [{ name: 'Total.js' }, { name: 'Express.js' }, { name: 'Meteor.js' }, { name: 'Koa.js' }, { name: 'ASP.NET' }, { name: 'PHP' }, { name: 'Python' }, { name: 'Node.js' }], function(value) {
			console.log('CLICK', value);
		});
	});
</script>
```