# j-ListBox

> j-ListBox: NEW dark mode; Works with Bootstrap

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: en
Content-SHA256: 25ccccc15a7a4d7d78222d4f25585f2056b354d28ffb983c30cc06b65a49b012
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

- __NEW__ dark mode
- Works with Bootstrap

__Configuration__:

- `required` {Boolean} enables `required` (default: __false__)
- `items` {String} static items `key1|value1, key2 with value, key3|value`
- `type` {String} can be `number` (converts `String` values to `Number`)
- `datasource` {String} path to data-source (must be array)
- `text` {String} determines a property name for text (in data-source), default: `name`
- `value` {String} determines a property name for value (in data-source) default: `id`
- `empty` {String} adds an empty field
- `disabled` {Boolean} disables this component
- `search` {String} enables search box with this value as a placeholder
- `height` {Number/String} height (default: `200`), `string` can contain `parent`, `window` or `.parent_selector`
- `multiple` {Boolean} `true` expects `Array` in `path` (default: `false`)
- `exec` {String} a link to function which is executed when the user click on the item

Use it with `<ui-component name="listbox">`. 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.

```html example.html
<div style="width:400px">
	<ui-component name="listbox" path="items" config="search:Search;required:true;items:Blue|1,Red|2,Green|3,Purple|4,Orange|5,Rose|6,Gray|7,Black|8;type:number"></ui-component>
</div>

<script>
	var items = 3;
</script>
```