j-Suggestion

jComponent 20 · jcomponent@20 component Example loaded with jComponent 20

supports 3 orientations left, center and right
singleton
works with Bootstrap Grid System
works with touches
supports dark mode

Methods:

Method: component.show(orientation, targetElement, [items/function(search, next)], clickCallback)

orientation {String} can be left, center or right
targetElement {Selector/jQuery/Element} a target where the component will be visible
items {Array} optional and must have this structure: [{ name: String, value: String, icon: String }] otherwise will be items read from the target's data-options attribute.
callback(selectedItem) {Function} is triggered when the user clicks on the item

Method: component.hide()

Attributes:

targetElement can contain data-options="Name 1|ti-building|Value 1;Name 2|ti-github|Value 2;" attribute with all items of the context menu.

Configuration:

placeholder - a placeholder for the search input

Server-side searching:

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

If the value isn't defined then the component uses name as value.

Global events:

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

Use it with <ui-component name="suggestion">. When the component is not loaded yet, jComponent downloads it on first use from the address in DEF.fallback (the Componentator CDN by default). Author: Peter Širka. Source: the Componentator components repository, MIT license.

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>