UNPKG

carbon-components-angular

Version:
1,171 lines (1,091 loc) 248 kB
<!doctype html> <html class="no-js" lang=""> <head> <meta charset="utf-8"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <title>carbon-components-angular documentation</title> <meta name="description" content=""> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" type="image/x-icon" href="../images/favicon.ico"> <link rel="stylesheet" href="../styles/style.css"> <link rel="stylesheet" href="../styles/dark.css"> <style> footer.carbon { position: absolute; bottom: 0; width: 100%; z-index: 9999; } #root > div { /* * Subtracting the height of the footer to prevent * overlaying the footer ontop of content */ height: calc(100vh - 48px); } </style> </head> <body> <script> // Blocking script to avoid flickering dark mode // Dark mode toggle button var useDark = window.matchMedia('(prefers-color-scheme: dark)'); var darkModeState = useDark.matches; var $darkModeToggleSwitchers = document.querySelectorAll('.dark-mode-switch input'); var $darkModeToggles = document.querySelectorAll('.dark-mode-switch'); var darkModeStateLocal = localStorage.getItem('compodoc_darkmode-state'); function checkToggle(check) { for (var i = 0; i < $darkModeToggleSwitchers.length; i++) { $darkModeToggleSwitchers[i].checked = check; } } function toggleDarkMode(state) { if (window.localStorage) { localStorage.setItem('compodoc_darkmode-state', state); } checkToggle(state); const hasClass = document.body.classList.contains('dark'); if (state) { for (var i = 0; i < $darkModeToggles.length; i++) { $darkModeToggles[i].classList.add('dark'); } if (!hasClass) { document.body.classList.add('dark'); } } else { for (var i = 0; i < $darkModeToggles.length; i++) { $darkModeToggles[i].classList.remove('dark'); } if (hasClass) { document.body.classList.remove('dark'); } } } useDark.addEventListener('change', function (evt) { toggleDarkMode(evt.matches); }); if (darkModeStateLocal) { darkModeState = darkModeStateLocal === 'true'; } toggleDarkMode(darkModeState); </script> <div class="navbar navbar-default navbar-fixed-top d-md-none p-0"> <div class="d-flex"> <a href="../" class="navbar-brand">carbon-components-angular documentation</a> <button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button> </div> </div> <div class="xs-menu menu" id="mobile-menu"> <div id="book-search-input" role="search"><input type="text" placeholder="Type to search"></div> <compodoc-menu></compodoc-menu> </div> <div class="container-fluid main"> <div class="row main"> <div class="d-none d-md-block menu"> <compodoc-menu mode="normal"></compodoc-menu> </div> <!-- START CONTENT --> <div class="content component"> <div class="content-data"> <ol class="breadcrumb"> <li class="breadcrumb-item">Components</li> <li class="breadcrumb-item" > ComboBox</li> </ol> <ul class="nav nav-tabs" role="tablist"> <li class="nav-item"> <a href="#info" class="nav-link active" role="tab" id="info-tab" data-bs-toggle="tab" data-link="info">Info</a> </li> <li class="nav-item"> <a href="#source" class="nav-link" role="tab" id="source-tab" data-bs-toggle="tab" data-link="source">Source</a> </li> <li class="nav-item"> <a href="#tree" class="nav-link" role="tab" id="tree-tab" data-bs-toggle="tab" data-link="dom-tree">DOM Tree</a> </li> </ul> <div class="tab-content"> <div class="tab-pane fade active in" id="info"><p class="comment"> <h3>File</h3> </p> <p class="comment"> <code>src/combobox/combobox.component.ts</code> </p> <p class="comment"> <h3>Description</h3> </p> <p class="comment"> <p>Get started with importing the module:</p> <b>Example :</b><div><pre class="line-numbers"><code class="language-typescript">import { ComboBoxModule } from &#39;carbon-components-angular&#39;;</code></pre></div><p>ComboBoxes are similar to dropdowns, except a combobox provides an input field for users to search items and (optionally) add their own. Multi-select comboboxes also provide &quot;pills&quot; of selected items.</p> <p><a href="../../?path=/story/components-combobox--basic">See demo</a></p> </p> <p class="comment"> <h3>Implements</h3> </p> <p class="comment"> <code>OnChanges</code> <code>AfterViewInit</code> <code>AfterContentInit</code> <code>OnDestroy</code> </p> <section data-compodoc="block-metadata"> <h3>Metadata</h3> <table class="table table-sm table-hover metadata"> <tbody> <tr> <td class="col-md-3">providers</td> <td class="col-md-9"> <code><a href="../components/ComboBox.html" target="_self" >{ provide: NG_VALUE_ACCESSOR, useExisting: ComboBox, multi: true }</a></code> </td> </tr> <tr> <td class="col-md-3">selector</td> <td class="col-md-9"><code>cds-combo-box, ibm-combo-box</code></td> </tr> <tr> <td class="col-md-3">template</td> <td class="col-md-9"><pre class="line-numbers"><code class="language-html">&lt;div class&#x3D;&quot;cds--list-box__wrapper&quot; [ngClass]&#x3D;&quot;{ &#x27;cds--list-box__wrapper--fluid&#x27;: fluid, &#x27;cds--list-box__wrapper--fluid--invalid&#x27;: fluid &amp;&amp; invalid, &#x27;cds--list-box__wrapper--fluid--focus&#x27;: fluid &amp;&amp; _isFocused }&quot;&gt; &lt;label *ngIf&#x3D;&quot;label&quot; [for]&#x3D;&quot;id&quot; [id]&#x3D;&quot;labelId&quot; class&#x3D;&quot;cds--label&quot; [ngClass]&#x3D;&quot;{ &#x27;cds--label--disabled&#x27;: disabled, &#x27;cds--visually-hidden&#x27;: hideLabel }&quot;&gt; &lt;ng-container *ngIf&#x3D;&quot;!isTemplate(label)&quot;&gt;{{label}}&lt;/ng-container&gt; &lt;ng-template *ngIf&#x3D;&quot;isTemplate(label)&quot; [ngTemplateOutlet]&#x3D;&quot;label&quot;&gt;&lt;/ng-template&gt; &lt;/label&gt; &lt;div #listbox [ngClass]&#x3D;&quot;{ &#x27;cds--multi-select cds--multi-select--filterable&#x27;: type &#x3D;&#x3D;&#x3D; &#x27;multi&#x27;, &#x27;cds--list-box--light&#x27;: theme &#x3D;&#x3D;&#x3D; &#x27;light&#x27;, &#x27;cds--list-box--expanded&#x27;: open, &#x27;cds--list-box--sm&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;sm&#x27;, &#x27;cds--list-box--md&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;md&#x27;, &#x27;cds--list-box--lg&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;lg&#x27;, &#x27;cds--list-box--disabled&#x27;: disabled, &#x27;cds--combo-box--readonly&#x27;: readonly, &#x27;cds--combo-box--warning cds--list-box--warning&#x27;: warn, &#x27;cds--list-box--invalid&#x27;: invalid }&quot; class&#x3D;&quot;cds--list-box cds--combo-box&quot; [attr.data-invalid]&#x3D;&quot;(invalid ? true : null)&quot;&gt; &lt;div class&#x3D;&quot;cds--list-box__field&quot; (click)&#x3D;&quot;toggleDropdown()&quot; (blur)&#x3D;&quot;onBlur()&quot;&gt; &lt;div *ngIf&#x3D;&quot;type &#x3D;&#x3D;&#x3D; &#x27;multi&#x27; &amp;&amp; pills.length &gt; 0&quot; class&#x3D;&quot;cds--tag cds--tag--filter cds--tag--high-contrast&quot; [ngClass]&#x3D;&quot;{&#x27;cds--tag--disabled&#x27;: disabled || readonly}&quot;&gt; &lt;span class&#x3D;&quot;cds--tag__label&quot;&gt;{{ pills.length }}&lt;/span&gt; &lt;button type&#x3D;&quot;button&quot; (click)&#x3D;&quot;clearSelected($event)&quot; (blur)&#x3D;&quot;onBlur()&quot; (keydown.enter)&#x3D;&quot;clearSelected($event)&quot; class&#x3D;&quot;cds--tag__close-icon&quot; tabindex&#x3D;&quot;0&quot; [title]&#x3D;&quot;clearSelectionsTitle&quot; [disabled]&#x3D;&quot;disabled || readonly&quot; [attr.aria-label]&#x3D;&quot;clearSelectionAria&quot;&gt; &lt;svg focusable&#x3D;&quot;false&quot; preserveAspectRatio&#x3D;&quot;xMidYMid meet&quot; style&#x3D;&quot;will-change: transform;&quot; role&#x3D;&quot;img&quot; xmlns&#x3D;&quot;http://www.w3.org/2000/svg&quot; width&#x3D;&quot;16&quot; height&#x3D;&quot;16&quot; viewBox&#x3D;&quot;0 0 16 16&quot; aria-hidden&#x3D;&quot;true&quot;&gt; &lt;path d&#x3D;&quot;M12 4.7l-.7-.7L8 7.3 4.7 4l-.7.7L7.3 8 4 11.3l.7.7L8 8.7l3.3 3.3.7-.7L8.7 8z&quot;&gt;&lt;/path&gt; &lt;/svg&gt; &lt;/button&gt; &lt;/div&gt; &lt;input #input type&#x3D;&quot;text&quot; autocomplete&#x3D;&quot;off&quot; role&#x3D;&quot;combobox&quot; [disabled]&#x3D;&quot;disabled&quot; [readOnly]&#x3D;&quot;readonly&quot; (input)&#x3D;&quot;onSearch($event.target.value)&quot; (focus)&#x3D;&quot;fluid ? handleFocus($event) : null&quot; (blur)&#x3D;&quot;fluid ? handleFocus($event) : onBlur()&quot; (keydown.enter)&#x3D;&quot;onSubmit($event)&quot; [value]&#x3D;&quot;selectedValue&quot; class&#x3D;&quot;cds--text-input&quot; [ngClass]&#x3D;&quot;{&#x27;cds--text-input--empty&#x27;: !showClearButton}&quot; tabindex&#x3D;&quot;0&quot; [id]&#x3D;&quot;id&quot; [attr.aria-labelledby]&#x3D;&quot;labelId&quot; [attr.aria-expanded]&#x3D;&quot;open&quot; aria-haspopup&#x3D;&quot;listbox&quot; [attr.maxlength]&#x3D;&quot;maxLength&quot; [attr.aria-controls]&#x3D;&quot;open ? view?.listId : null&quot; [attr.aria-autocomplete]&#x3D;&quot;autocomplete&quot; [placeholder]&#x3D;&quot;placeholder&quot;/&gt; &lt;svg *ngIf&#x3D;&quot;invalid&quot; cdsIcon&#x3D;&quot;warning--filled&quot; size&#x3D;&quot;16&quot; class&#x3D;&quot;cds--list-box__invalid-icon&quot;&gt; &lt;/svg&gt; &lt;svg *ngIf&#x3D;&quot;!invalid &amp;&amp; warn&quot; cdsIcon&#x3D;&quot;warning--alt--filled&quot; size&#x3D;&quot;16&quot; class&#x3D;&quot;cds--list-box__invalid-icon cds--list-box__invalid-icon--warning&quot;&gt; &lt;/svg&gt; &lt;div *ngIf&#x3D;&quot;showClearButton&quot; role&#x3D;&quot;button&quot; class&#x3D;&quot;cds--list-box__selection&quot; tabindex&#x3D;&quot;0&quot; [attr.aria-label]&#x3D;&quot;clearSelectionAria&quot; [title]&#x3D;&quot;clearSelectionTitle&quot; (keyup.enter)&#x3D;&quot;clearInput($event)&quot; (click)&#x3D;&quot;clearInput($event)&quot; (blur)&#x3D;&quot;onBlur()&quot;&gt; &lt;svg cdsIcon&#x3D;&quot;close&quot; size&#x3D;&quot;16&quot;&gt;&lt;/svg&gt; &lt;/div&gt; &lt;button type&#x3D;&quot;button&quot; role&#x3D;&quot;button&quot; class&#x3D;&quot;cds--list-box__menu-icon&quot; tabindex&#x3D;&quot;-1&quot; [title]&#x3D;&quot;open ? closeMenuAria : openMenuAria&quot; [attr.aria-label]&#x3D;&quot;open ? closeMenuAria : openMenuAria&quot; [ngClass]&#x3D;&quot;{&#x27;cds--list-box__menu-icon--open&#x27;: open}&quot;&gt; &lt;svg cdsIcon&#x3D;&quot;chevron--down&quot; size&#x3D;&quot;16&quot;&gt;&lt;/svg&gt; &lt;/button&gt; &lt;/div&gt; &lt;div #dropdownMenu [ngClass]&#x3D;&quot;{ &#x27;cds--list-box--up&#x27;: this.dropUp !&#x3D;&#x3D; null &amp;&amp; this.dropUp !&#x3D;&#x3D; undefined ? dropUp : _dropUp }&quot;&gt; &lt;ng-content *ngIf&#x3D;&quot;open&quot;&gt;&lt;/ng-content&gt; &lt;/div&gt; &lt;/div&gt; &lt;hr *ngIf&#x3D;&quot;fluid&quot; class&#x3D;&quot;cds--list-box__divider&quot; /&gt; &lt;div *ngIf&#x3D;&quot;helperText &amp;&amp; !invalid &amp;&amp; !warn &amp;&amp; !fluid&quot; class&#x3D;&quot;cds--form__helper-text&quot; [ngClass]&#x3D;&quot;{&#x27;cds--form__helper-text--disabled&#x27;: disabled}&quot;&gt; &lt;ng-container *ngIf&#x3D;&quot;!isTemplate(helperText)&quot;&gt;{{helperText}}&lt;/ng-container&gt; &lt;ng-template *ngIf&#x3D;&quot;isTemplate(helperText)&quot; [ngTemplateOutlet]&#x3D;&quot;helperText&quot;&gt;&lt;/ng-template&gt; &lt;/div&gt; &lt;div *ngIf&#x3D;&quot;invalid&quot; class&#x3D;&quot;cds--form-requirement&quot;&gt; &lt;ng-container *ngIf&#x3D;&quot;!isTemplate(invalidText)&quot;&gt;{{ invalidText }}&lt;/ng-container&gt; &lt;ng-template *ngIf&#x3D;&quot;isTemplate(invalidText)&quot; [ngTemplateOutlet]&#x3D;&quot;invalidText&quot;&gt;&lt;/ng-template&gt; &lt;/div&gt; &lt;div *ngIf&#x3D;&quot;!invalid &amp;&amp; warn&quot; class&#x3D;&quot;cds--form-requirement&quot;&gt; &lt;ng-container *ngIf&#x3D;&quot;!isTemplate(warnText)&quot;&gt;{{warnText}}&lt;/ng-container&gt; &lt;ng-template *ngIf&#x3D;&quot;isTemplate(warnText)&quot; [ngTemplateOutlet]&#x3D;&quot;warnText&quot;&gt;&lt;/ng-template&gt; &lt;/div&gt; &lt;/div&gt; </code></pre></td> </tr> </tbody> </table> </section> <section data-compodoc="block-index"> <h3 id="index">Index</h3> <table class="table table-sm table-bordered index-table"> <tbody> <tr> <td class="col-md-4"> <h6><b>Properties</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <span class="modifier">Protected</span> <a href="#_clearSelectionAria" >_clearSelectionAria</a> </li> <li> <span class="modifier">Protected</span> <a href="#_clearSelectionsAria" >_clearSelectionsAria</a> </li> <li> <span class="modifier">Protected</span> <a href="#_clearSelectionsTitle" >_clearSelectionsTitle</a> </li> <li> <span class="modifier">Protected</span> <a href="#_clearSelectionTitle" >_clearSelectionTitle</a> </li> <li> <span class="modifier">Protected</span> <a href="#_closeMenuAria" >_closeMenuAria</a> </li> <li> <a href="#_dropUp" >_dropUp</a> </li> <li> <span class="modifier">Protected</span> <a href="#_isFocused" >_isFocused</a> </li> <li> <span class="modifier">Protected</span> <a href="#_openMenuAria" >_openMenuAria</a> </li> <li> <span class="modifier">Protected</span> <a href="#_placeholder" >_placeholder</a> </li> <li> <span class="modifier">Static</span> <a href="#comboBoxCount" >comboBoxCount</a> </li> <li> <span class="modifier"></span> <a href="#dropdownMenu" >dropdownMenu</a> </li> <li> <span class="modifier"></span> <a href="#hostClass" >hostClass</a> </li> <li> <span class="modifier"></span> <a href="#input" >input</a> </li> <li> <a href="#keyboardNav" >keyboardNav</a> </li> <li> <span class="modifier"></span> <a href="#listbox" >listbox</a> </li> <li> <span class="modifier">Protected</span> <a href="#noop" >noop</a> </li> <li> <span class="modifier">Protected</span> <a href="#onTouchedCallback" >onTouchedCallback</a> </li> <li> <span class="modifier">Public</span> <a href="#open" >open</a> </li> <li> <a href="#outsideClick" >outsideClick</a> </li> <li> <span class="modifier">Public</span> <a href="#pills" >pills</a> </li> <li> <span class="modifier">Protected</span> <a href="#propagateChangeCallback" >propagateChangeCallback</a> </li> <li> <span class="modifier">Public</span> <a href="#selectedValue" >selectedValue</a> </li> <li> <span class="modifier">Public</span> <a href="#showClearButton" >showClearButton</a> </li> <li> <span class="modifier"></span> <a href="#view" >view</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Methods</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#_appendToBody" >_appendToBody</a> </li> <li> <a href="#_appendToDropdown" >_appendToDropdown</a> </li> <li> <a href="#_keyboardNav" >_keyboardNav</a> </li> <li> <a href="#_noop" >_noop</a> </li> <li> <a href="#_outsideClick" >_outsideClick</a> </li> <li> <a href="#_shouldDropUp" >_shouldDropUp</a> </li> <li> <span class="modifier">Protected</span> <a href="#checkForReorder" >checkForReorder</a> </li> <li> <a href="#clearInput" >clearInput</a> </li> <li> <span class="modifier">Public</span> <a href="#clearSelected" >clearSelected</a> </li> <li> <span class="modifier">Public</span> <a href="#closeDropdown" >closeDropdown</a> </li> <li> <a href="#handleFocus" >handleFocus</a> </li> <li> <span class="modifier"></span> <a href="#hostkeys" >hostkeys</a> </li> <li> <span class="modifier">Public</span> <a href="#isTemplate" >isTemplate</a> </li> <li> <a href="#ngAfterContentInit" >ngAfterContentInit</a> </li> <li> <a href="#ngAfterViewInit" >ngAfterViewInit</a> </li> <li> <a href="#ngOnChanges" >ngOnChanges</a> </li> <li> <a href="#ngOnDestroy" >ngOnDestroy</a> </li> <li> <a href="#onBlur" >onBlur</a> </li> <li> <span class="modifier">Public</span> <a href="#onSearch" >onSearch</a> </li> <li> <span class="modifier">Public</span> <a href="#onSubmit" >onSubmit</a> </li> <li> <span class="modifier">Public</span> <a href="#openDropdown" >openDropdown</a> </li> <li> <a href="#registerOnChange" >registerOnChange</a> </li> <li> <a href="#registerOnTouched" >registerOnTouched</a> </li> <li> <a href="#setDisabledState" >setDisabledState</a> </li> <li> <span class="modifier">Public</span> <a href="#toggleDropdown" >toggleDropdown</a> </li> <li> <span class="modifier">Public</span> <a href="#updatePills" >updatePills</a> </li> <li> <span class="modifier">Protected</span> <a href="#updateSelected" >updateSelected</a> </li> <li> <a href="#writeValue" >writeValue</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Inputs</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#appendInline" >appendInline</a> </li> <li> <a href="#autocomplete" >autocomplete</a> </li> <li> <a href="#clearSelectionAria" >clearSelectionAria</a> </li> <li> <a href="#clearSelectionsAria" >clearSelectionsAria</a> </li> <li> <a href="#clearSelectionsTitle" >clearSelectionsTitle</a> </li> <li> <a href="#clearSelectionTitle" >clearSelectionTitle</a> </li> <li> <a href="#closeMenuAria" >closeMenuAria</a> </li> <li> <a href="#disabled" >disabled</a> </li> <li> <a href="#dropUp" >dropUp</a> </li> <li> <a href="#fluid" >fluid</a> </li> <li> <a href="#helperText" >helperText</a> </li> <li> <a href="#hideLabel" >hideLabel</a> </li> <li> <a href="#id" >id</a> </li> <li> <a href="#invalid" >invalid</a> </li> <li> <a href="#invalidText" >invalidText</a> </li> <li> <a href="#items" >items</a> </li> <li> <a href="#itemValueKey" >itemValueKey</a> </li> <li> <a href="#label" >label</a> </li> <li> <a href="#labelId" >labelId</a> </li> <li> <a href="#maxLength" >maxLength</a> </li> <li> <a href="#openMenuAria" >openMenuAria</a> </li> <li> <a href="#placeholder" >placeholder</a> </li> <li> <a href="#readonly" >readonly</a> </li> <li> <a href="#selectionFeedback" >selectionFeedback</a> </li> <li> <a href="#size" >size</a> </li> <li> <a href="#theme" class="deprecated-name">theme</a> </li> <li> <a href="#type" >type</a> </li> <li> <a href="#warn" >warn</a> </li> <li> <a href="#warnText" >warnText</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Outputs</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#clear" >clear</a> </li> <li> <a href="#close" >close</a> </li> <li> <a href="#search" >search</a> </li> <li> <a href="#selected" >selected</a> </li> <li> <a href="#submit" >submit</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>HostBindings</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#class.cds--list-box__wrapper" >class.cds--list-box__wrapper</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>HostListeners</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#keydown" >keydown</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Accessors</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#placeholder" >placeholder</a> </li> <li> <a href="#openMenuAria" >openMenuAria</a> </li> <li> <a href="#closeMenuAria" >closeMenuAria</a> </li> <li> <a href="#clearSelectionsTitle" >clearSelectionsTitle</a> </li> <li> <a href="#clearSelectionsAria" >clearSelectionsAria</a> </li> <li> <a href="#clearSelectionTitle" >clearSelectionTitle</a> </li> <li> <a href="#clearSelectionAria" >clearSelectionAria</a> </li> </ul> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-constructor"> <h3 id="constructor">Constructor</h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <code>constructor(elementRef: ElementRef, dropdownService: <a href="../injectables/DropdownService.html" target="_self">DropdownService</a>, i18n: <a href="../injectables/I18n.html" target="_self">I18n</a>)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="471" class="link-to-prism">src/combobox/combobox.component.ts:471</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Creates an instance of ComboBox.</p> </div> <div> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>elementRef</td> <td> <code>ElementRef</code> </td> <td> No </td> </tr> <tr> <td>dropdownService</td> <td> <code><a href="../injectables/DropdownService.html" target="_self" >DropdownService</a></code> </td> <td> No </td> </tr> <tr> <td>i18n</td> <td> <code><a href="../injectables/I18n.html" target="_self" >I18n</a></code> </td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-inputs"> <h3 id="inputs">Inputs</h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="appendInline"></a> <b>appendInline</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>null</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="331" class="link-to-prism">src/combobox/combobox.component.ts:331</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>set to <code>true</code> to place the dropdown view inline with the component</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="autocomplete"></a> <b>autocomplete</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/string" target="_blank" >string</a></code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>&quot;list&quot;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="367" class="link-to-prism">src/combobox/combobox.component.ts:367</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Specify aria-autocomplete attribute of text input. &quot;list&quot;, is the expected value for a combobox that invokes a drop-down list</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="clearSelectionAria"></a> <b>clearSelectionAria</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | Observable</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="267" class="link-to-prism">src/combobox/combobox.component.ts:267</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Value to display for accessibility purposes on the clear the selected item icon, when single is selected</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="clearSelectionsAria"></a> <b>clearSelectionsAria</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | Observable</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="247" class="link-to-prism">src/combobox/combobox.component.ts:247</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Value to display for accessibility purposes to clear selections, when multi is selected</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="clearSelectionsTitle"></a> <b>clearSelectionsTitle</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | Observable</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="237" class="link-to-prism">src/combobox/combobox.component.ts:237</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Value to display on the clear selections icon, when multi is selected</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="clearSelectionTitle"></a> <b>clearSelectionTitle</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | Observable</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="257" class="link-to-prism">src/combobox/combobox.component.ts:257</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Value to display on the clear the selected item icon, when single is selected</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="closeMenuAria"></a> <b>closeMenuAria</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | Observable</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="227" class="link-to-prism">src/combobox/combobox.component.ts:227</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Value to display for accessibility purposes on the combobox control menu when opened</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="disabled"></a> <b>disabled</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>false</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="375" class="link-to-prism">src/combobox/combobox.component.ts:375</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to <code>true</code> to disable combobox.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="dropUp"></a> <b>dropUp</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="371" class="link-to-prism">src/combobox/combobox.component.ts:371</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Overrides the automatic dropUp.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="fluid"></a> <b>fluid</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>false</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="383" class="link-to-prism">src/combobox/combobox.component.ts:383</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Experimental: enable fluid state</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="helperText"></a> <b>helperText</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>string | TemplateRef&lt;any&gt;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="327" class="link-to-prism">src/combobox/combobox.component.ts:327</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Sets the optional helper text.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="hideLabel"></a> <b>hideLabel</b> </td> </tr> <tr> <td class="co