* @class * * ### Overview * * The `ui5-select` component is used to create a drop-down list. * * ### Usage * * There are two main usages of the `ui5-select>`. * * - With Option (`ui5-option`) web component: * * The available options of the Select are defined by using the Option component
| 153 | * @since 0.8.0 |
| 154 | */ |
| 155 | @customElement({ |
| 156 | tag: "ui5-select", |
| 157 | languageAware: true, |
| 158 | formAssociated: true, |
| 159 | renderer: jsxRenderer, |
| 160 | template: SelectTemplate, |
| 161 | styles: [ |
| 162 | selectCss, |
| 163 | ResponsivePopoverCommonCss, |
| 164 | ValueStateMessageCss, |
| 165 | SelectPopoverCss, |
| 166 | ], |
| 167 | dependencies: [ |
| 168 | Label, |
| 169 | ResponsivePopover, |
| 170 | Popover, |
| 171 | List, |
| 172 | Icon, |
| 173 | Button, |
| 174 | ], |
| 175 | }) |
| 176 | /** |
| 177 | * Fired when the selected option changes. |
| 178 | * @param {IOption} selectedOption the selected option. |
| 179 | * @public |
| 180 | */ |
| 181 | @event("change", { |
| 182 | bubbles: true, |
| 183 | cancelable: true, |
| 184 | }) |
| 185 | /** |
| 186 | * Fired when the user navigates through the options, but the selection is not finalized, |
| 187 | * or when pressing the ESC key to revert the current selection. |
| 188 | * @param {IOption} selectedOption the selected option. |
| 189 | * @public |
| 190 | * @since 1.17.0 |
| 191 | */ |
| 192 | @event("live-change", { |
| 193 | bubbles: true, |
| 194 | }) |
| 195 | /** |
| 196 | * Fired after the component's dropdown menu opens. |
| 197 | * @public |
| 198 | */ |
| 199 | @event("open") |
| 200 | |
| 201 | /** |
| 202 | * Fired after the component's dropdown menu closes. |
| 203 | * @public |
| 204 | */ |
| 205 | @event("close") |
| 206 | |
| 207 | /** |
| 208 | * Fired to make Angular two way data binding work properly. |
| 209 | * @private |
| 210 | */ |
| 211 | @event("selected-item-changed", { |
| 212 | bubbles: true, |
nothing calls this directly
no test coverage detected