67 |
68 | ```
69 | ```javascript
70 |
71 | class TestComponent {
72 | keyword = 'name';
73 | data = [
74 | {
75 | id: 1,
76 | name: 'Georgia'
77 | },
78 | {
79 | id: 2,
80 | name: 'Usa'
81 | },
82 | {
83 | id: 3,
84 | name: 'England'
85 | }
86 | ];
87 |
88 |
89 | selectEvent(item) {
90 | // do something with selected item
91 | }
92 |
93 | onChangeSearch(val: string) {
94 | // fetch remote data from here
95 | // And reassign the 'data' which is binded to 'data' property.
96 | }
97 |
98 | onFocused(e){
99 | // do something when input is focused
100 | }
101 | }
102 | ```
103 |
104 | ## API
105 | ### Inputs
106 | | Input | Type | Default | Required | Description |
107 | | ------------- | ------------- | ------------- | ------------- | ------------- |
108 | | [data] | `Array` | `null` | yes | Items array. It can be array of strings or array of objects. |
109 | | searchKeyword | `string` | `-` | yes | Variable name to filter data with. |
110 | | customFilter | `(items: any[], query: string) => any[]` | `undefined` | no | Custom filter function. You can use it to provide your own filtering function, as e.g. fuzzy-matching filtering, or to disable filtering at all (just pass `(items) => items` as a filter). Do not change the `items` argument given, return filtered list instead. |
111 | | selectedValueRender | `(value: any) => string` | `undefined` | no | Custom renderer function to render selected value inside input field. |
112 | | placeholder | `string` | `-` | no | HTML `` placeholder text. |
113 | | heading | `string` | `-` | no | Heading text of items list. If it is null then heading is hidden. |
114 | | initialValue | `any` | `_` | no | Initial/default selected value. |
115 | | focusFirst | `boolean` | `false` | no | Automatically focus the first matched item on the list. |
116 | | historyIdentifier | `string` | `_` | no | History identifier of history list. When valid history identifier is given, then component stores selected item to local storage of user's browser. If it is null then history is hidden. History list is visible if at least one history item is stored. History identifier must be unique. |
117 | | historyHeading | `string` | `Recently selected` | no | Heading text of history list. If it is null then history heading is hidden. |
118 | | historyListMaxNumber | `number` | `15` | no | Maximum number of items in the history list. |
119 | | notFoundText | `string` | `Not found` | no | Set custom text when filter returns empty result. |
120 | | isLoading | `boolean` | `false` | no | Set the loading state when data is being loaded, (e.g. async items loading) and show loading spinner. |
121 | | minQueryLength | `number` | `1` | no | The minimum number of characters the user must type before a search is performed. |
122 | | debounceTime | `number` | `_` | no | Delay time while typing. |
123 | | disabled | `boolean` | `false` | no | HTML `` disable/enable. |
124 |
125 | ### Outputs
126 | | Output | Description |
127 | | ------------- | ------------- |
128 | | (selected) | Event is emitted when an item from the list is selected. |
129 | | (inputChanged) | Event is emitted when an input is changed. |
130 | | (inputFocused) | Event is emitted when an input is focused. |
131 | | (inputCleared) | Event is emitted when an input is cleared. |
132 | | (opened) | Event is emitted when the autocomplete panel is opened. |
133 | | (closed) | Event is emitted when the autocomplete panel is closed. |
134 | | (scrolledToEnd) | Event is emitted when scrolled to the end of items. Can be used for loading more items in chunks. |
135 |
136 |
137 | ### Methods (controls)
138 | Name | Description |
139 | | ------------- | ------------- |
140 | | open | Opens the autocomplete panel |
141 | | close | Closes the autocomplete panel |
142 | | focus | Focuses the autocomplete input element |
143 | | clear | Clears the autocomplete input element |
144 |
145 | To access the control methods of the component you should use `@ViewChild` decorator.
146 | See the example below:
147 |
148 | ```html
149 |
150 | ```
151 |
152 | ```javascript
153 | class TestComponent {
154 | @ViewChild('auto') auto;
155 |
156 | openPanel(e): void {
157 | e.stopPropagation();
158 | this.auto.open();
159 | }
160 |
161 | closePanel(e): void {
162 | e.stopPropagation();
163 | this.auto.close();
164 | }
165 |
166 | focus(e): void {
167 | e.stopPropagation();
168 | this.auto.focus();
169 | }
170 | }
171 | ```
172 |
173 | ## Styles
174 | If you are not happy with default styles you can easily override them:
175 |
176 | ```html
177 |
67 |
68 | ```
69 | ```javascript
70 |
71 | class TestComponent {
72 | keyword = 'name';
73 | data = [
74 | {
75 | id: 1,
76 | name: 'Georgia'
77 | },
78 | {
79 | id: 2,
80 | name: 'Usa'
81 | },
82 | {
83 | id: 3,
84 | name: 'England'
85 | }
86 | ];
87 |
88 |
89 | selectEvent(item) {
90 | // do something with selected item
91 | }
92 |
93 | onChangeSearch(val: string) {
94 | // fetch remote data from here
95 | // And reassign the 'data' which is binded to 'data' property.
96 | }
97 |
98 | onFocused(e){
99 | // do something when input is focused
100 | }
101 | }
102 | ```
103 |
104 | ## API
105 | ### Inputs
106 | | Input | Type | Default | Required | Description |
107 | | ------------- | ------------- | ------------- | ------------- | ------------- |
108 | | [data] | `Array` | `null` | yes | Items array. It can be array of strings or array of objects. |
109 | | searchKeyword | `string` | `-` | yes | Variable name to filter data with. |
110 | | customFilter | `(items: any[], query: string) => any[]` | `undefined` | no | Custom filter function. You can use it to provide your own filtering function, as e.g. fuzzy-matching filtering, or to disable filtering at all (just pass `(items) => items` as a filter). Do not change the `items` argument given, return filtered list instead. |
111 | | selectedValueRender | `(value: any) => string` | `undefined` | no | Custom renderer function to render selected value inside input field. |
112 | | placeholder | `string` | `-` | no | HTML `` placeholder text. |
113 | | heading | `string` | `-` | no | Heading text of items list. If it is null then heading is hidden. |
114 | | initialValue | `any` | `_` | no | Initial/default selected value. |
115 | | focusFirst | `boolean` | `false` | no | Automatically focus the first matched item on the list. |
116 | | historyIdentifier | `string` | `_` | no | History identifier of history list. When valid history identifier is given, then component stores selected item to local storage of user's browser. If it is null then history is hidden. History list is visible if at least one history item is stored. History identifier must be unique. |
117 | | historyHeading | `string` | `Recently selected` | no | Heading text of history list. If it is null then history heading is hidden. |
118 | | historyListMaxNumber | `number` | `15` | no | Maximum number of items in the history list. |
119 | | notFoundText | `string` | `Not found` | no | Set custom text when filter returns empty result. |
120 | | isLoading | `boolean` | `false` | no | Set the loading state when data is being loaded, (e.g. async items loading) and show loading spinner. |
121 | | minQueryLength | `number` | `1` | no | The minimum number of characters the user must type before a search is performed. |
122 | | debounceTime | `number` | `_` | no | Delay time while typing. |
123 | | disabled | `boolean` | `false` | no | HTML `` disable/enable. |
124 |
125 | ### Outputs
126 | | Output | Description |
127 | | ------------- | ------------- |
128 | | (selected) | Event is emitted when an item from the list is selected. |
129 | | (inputChanged) | Event is emitted when an input is changed. |
130 | | (inputFocused) | Event is emitted when an input is focused. |
131 | | (inputCleared) | Event is emitted when an input is cleared. |
132 | | (opened) | Event is emitted when the autocomplete panel is opened. |
133 | | (closed) | Event is emitted when the autocomplete panel is closed. |
134 | | (scrolledToEnd) | Event is emitted when scrolled to the end of items. Can be used for loading more items in chunks. |
135 |
136 |
137 | ### Methods (controls)
138 | Name | Description |
139 | | ------------- | ------------- |
140 | | open | Opens the autocomplete panel |
141 | | close | Closes the autocomplete panel |
142 | | focus | Focuses the autocomplete input element |
143 | | clear | Clears the autocomplete input element |
144 |
145 | To access the control methods of the component you should use `@ViewChild` decorator.
146 | See the example below:
147 |
148 | ```html
149 |
150 | ```
151 |
152 | ```javascript
153 | class TestComponent {
154 | @ViewChild('auto') auto;
155 |
156 | openPanel(e): void {
157 | e.stopPropagation();
158 | this.auto.open();
159 | }
160 |
161 | closePanel(e): void {
162 | e.stopPropagation();
163 | this.auto.close();
164 | }
165 |
166 | focus(e): void {
167 | e.stopPropagation();
168 | this.auto.focus();
169 | }
170 | }
171 | ```
172 |
173 | ## Styles
174 | If you are not happy with default styles you can easily override them:
175 |
176 | ```html
177 |