UNPKG

carbon-components-angular

Version:
1,268 lines (1,153 loc) 114 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" > Select</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/select/select.component.ts</code> </p> <p class="comment"> <h3>Description</h3> </p> <p class="comment"> <p><code>cds-select</code> provides a styled <code>select</code> component. Get started with importing the module:</p> <b>Example :</b><div><pre class="line-numbers"><code class="language-typescript">import { SelectModule } from &#39;carbon-components-angular&#39;;</code></pre></div><b>Example :</b><div><pre class="line-numbers"><code class="language-html">&lt;cds-select [(ngModel)]=&quot;model&quot;&gt; &lt;option value=&quot;default&quot; disabled selected hidden&gt;Choose an option&lt;/option&gt; &lt;option value=&quot;option1&quot;&gt;Option 1&lt;/option&gt; &lt;option value=&quot;option2&quot;&gt;Option 2&lt;/option&gt; &lt;option value=&quot;option3&quot;&gt;Option 3&lt;/option&gt; &lt;/cds-select&gt; ``` [See demo](../../?path=/story/components-select--basic)</code></pre></div> </p> <p class="comment"> <h3>Implements</h3> </p> <p class="comment"> <code>ControlValueAccessor</code> <code>AfterViewInit</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/Select.html" target="_self" >{ provide: NG_VALUE_ACCESSOR, useExisting: Select, multi: true }</a></code> </td> </tr> <tr> <td class="col-md-3">selector</td> <td class="col-md-9"><code>cds-select, ibm-select</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 [ngClass]&#x3D;&quot;{ &#x27;cds--form-item&#x27;: !skeleton, &#x27;cds--select--fluid&#x27;: fluid &amp;&amp; !skeleton }&quot;&gt; &lt;ng-container *ngIf&#x3D;&quot;skeleton &amp;&amp; !fluid&quot;&gt; &lt;div *ngIf&#x3D;&quot;label&quot; class&#x3D;&quot;cds--label cds--skeleton&quot;&gt;&lt;/div&gt; &lt;div class&#x3D;&quot;cds--select cds--skeleton&quot;&gt;&lt;/div&gt; &lt;/ng-container&gt; &lt;ng-container *ngIf&#x3D;&quot;skeleton &amp;&amp; fluid&quot;&gt; &lt;div class&#x3D;&quot;cds--list-box__wrapper--fluid&quot;&gt; &lt;div class&#x3D;&quot;cds--list-box cds--skeleton&quot;&gt; &lt;div class&#x3D;&quot;cds--list-box__label&quot;&gt;&lt;/div&gt; &lt;div class&#x3D;&quot;cds--list-box__field&quot;&gt;&lt;/div&gt; &lt;/div&gt; &lt;/div&gt; &lt;/ng-container&gt; &lt;div *ngIf&#x3D;&quot;!skeleton&quot; class&#x3D;&quot;cds--select&quot; [ngClass]&#x3D;&quot;{ &#x27;cds--select--inline&#x27;: display &#x3D;&#x3D;&#x3D; &#x27;inline&#x27;, &#x27;cds--select--light&#x27;: theme &#x3D;&#x3D;&#x3D; &#x27;light&#x27;, &#x27;cds--select--invalid&#x27;: invalid, &#x27;cds--select--warning&#x27;: warn, &#x27;cds--select--disabled&#x27;: disabled, &#x27;cds--select--readonly&#x27;: readonly, &#x27;cds--select--fluid--invalid&#x27;: fluid &amp;&amp; invalid, &#x27;cds--select--fluid--focus&#x27;: fluid &amp;&amp; focused }&quot;&gt; &lt;label *ngIf&#x3D;&quot;label&quot; [for]&#x3D;&quot;id&quot; class&#x3D;&quot;cds--label&quot; [ngClass]&#x3D;&quot;{&#x27;cds--label--disabled&#x27;: disabled}&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 *ngIf&#x3D;&quot;display &#x3D;&#x3D;&#x3D; &#x27;inline&#x27;; else noInline&quot; class&#x3D;&quot;cds--select-input--inline__wrapper&quot;&gt; &lt;ng-container *ngTemplateOutlet&#x3D;&quot;noInline&quot;&gt;&lt;/ng-container&gt; &lt;/div&gt; &lt;div *ngIf&#x3D;&quot;helperText &amp;&amp; !invalid &amp;&amp; !warn &amp;&amp; !skeleton &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&gt; &lt;/div&gt; &lt;!-- select element: dynamically projected based on &#x27;display&#x27; variant --&gt; &lt;ng-template #noInline&gt; &lt;div class&#x3D;&quot;cds--select-input__wrapper&quot; [attr.data-invalid]&#x3D;&quot;(invalid ? true : null)&quot;&gt; &lt;select #select [attr.id]&#x3D;&quot;id&quot; [attr.aria-label]&#x3D;&quot;ariaLabel&quot; [disabled]&#x3D;&quot;disabled&quot; (change)&#x3D;&quot;onChange($event)&quot; [attr.aria-invalid]&#x3D;&quot;invalid ? &#x27;true&#x27; : null&quot; [attr.aria-readonly]&#x3D;&quot;readonly ? &#x27;true&#x27; : null&quot; class&#x3D;&quot;cds--select-input&quot; [ngClass]&#x3D;&quot;{ &#x27;cds--select-input--sm&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;sm&#x27;, &#x27;cds--select-input--md&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;md&#x27;, &#x27;cds--select-input--lg&#x27;: size &#x3D;&#x3D;&#x3D; &#x27;lg&#x27; }&quot; (mousedown)&#x3D;&quot;onMouseDown($event)&quot; (keydown)&#x3D;&quot;onKeyDown($event)&quot; (focus)&#x3D;&quot;fluid ? handleFocus($event) : null&quot; (blur)&#x3D;&quot;fluid ? handleFocus($event) : null&quot;&gt; &lt;ng-content&gt;&lt;/ng-content&gt; &lt;/select&gt; &lt;svg focusable&#x3D;&quot;false&quot; preserveAspectRatio&#x3D;&quot;xMidYMid meet&quot; style&#x3D;&quot;will-change: transform;&quot; xmlns&#x3D;&quot;http://www.w3.org/2000/svg&quot; class&#x3D;&quot;cds--select__arrow&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;M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z&quot;&gt;&lt;/path&gt; &lt;/svg&gt; &lt;svg *ngIf&#x3D;&quot;invalid&quot; cdsIcon&#x3D;&quot;warning--filled&quot; size&#x3D;&quot;16&quot; class&#x3D;&quot;cds--select__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--select__invalid-icon cds--select__invalid-icon--warning&quot;&gt; &lt;/svg&gt; &lt;ng-container *ngIf&#x3D;&quot;fluid&quot;&gt; &lt;hr class&#x3D;&quot;cds--select__divider&quot; /&gt; &lt;div *ngIf&#x3D;&quot;invalid &amp;&amp; invalidText&quot; role&#x3D;&quot;alert&quot; class&#x3D;&quot;cds--form-requirement&quot; aria-live&#x3D;&quot;polite&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;/ng-container&gt; &lt;/div&gt; &lt;ng-container *ngIf&#x3D;&quot;!fluid&quot;&gt; &lt;div *ngIf&#x3D;&quot;invalid &amp;&amp; invalidText&quot; role&#x3D;&quot;alert&quot; class&#x3D;&quot;cds--form-requirement&quot; aria-live&#x3D;&quot;polite&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;/ng-container&gt; &lt;/ng-template&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="#_value" >_value</a> </li> <li> <a href="#focused" >focused</a> </li> <li> <span class="modifier">Protected</span> <a href="#onChangeHandler" >onChangeHandler</a> </li> <li> <span class="modifier">Protected</span> <a href="#onTouchedHandler" >onTouchedHandler</a> </li> <li> <span class="modifier"></span> <a href="#select" >select</a> </li> <li> <span class="modifier">Static</span> <a href="#selectCount" >selectCount</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> <span class="modifier"></span> <a href="#focusOut" >focusOut</a> </li> <li> <a href="#handleFocus" >handleFocus</a> </li> <li> <span class="modifier">Public</span> <a href="#isTemplate" >isTemplate</a> </li> <li> <a href="#ngAfterViewInit" >ngAfterViewInit</a> </li> <li> <a href="#onChange" >onChange</a> </li> <li> <a href="#onKeyDown" >onKeyDown</a> </li> <li> <a href="#onMouseDown" >onMouseDown</a> </li> <li> <a href="#registerOnChange" >registerOnChange</a> </li> <li> <a href="#registerOnTouched" >registerOnTouched</a> </li> <li> <a href="#setDisabledState" >setDisabledState</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="#ariaLabel" >ariaLabel</a> </li> <li> <a href="#disabled" >disabled</a> </li> <li> <a href="#display" >display</a> </li> <li> <a href="#fluid" >fluid</a> </li> <li> <a href="#helperText" >helperText</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="#label" >label</a> </li> <li> <a href="#readonly" >readonly</a> </li> <li> <a href="#size" >size</a> </li> <li> <a href="#skeleton" >skeleton</a> </li> <li> <a href="#theme" class="deprecated-name">theme</a> </li> <li> <a href="#value" >value</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="#valueChange" >valueChange</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="#focusout" >focusout</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="#value" >value</a> </li> </ul> </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="ariaLabel"></a> <b>ariaLabel</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-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="240" class="link-to-prism">src/select/select.component.ts:240</a></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="221" class="link-to-prism">src/select/select.component.ts:221</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to true to disable component.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="display"></a> <b>display</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>&quot;inline&quot; | &quot;default&quot;</code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>&quot;default&quot;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="189" class="link-to-prism">src/select/select.component.ts:189</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p><code>inline</code> or <code>default</code> select displays</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="245" class="link-to-prism">src/select/select.component.ts:245</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="197" class="link-to-prism">src/select/select.component.ts:197</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Optional helper text that appears under the label.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="id"></a> <b>id</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>&#x60;select-${Select.selectCount++}&#x60;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="213" class="link-to-prism">src/select/select.component.ts:213</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Sets the unique ID. Defaults to <code>select-${total count of selects instantiated}</code></p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="invalid"></a> <b>invalid</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="229" class="link-to-prism">src/select/select.component.ts:229</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to <code>true</code> for an invalid select component.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="invalidText"></a> <b>invalidText</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="201" class="link-to-prism">src/select/select.component.ts:201</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Sets the invalid text.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="label"></a> <b>label</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="193" class="link-to-prism">src/select/select.component.ts:193</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Label for the select. Appears above the input.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="readonly"></a> <b>readonly</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="233" class="link-to-prism">src/select/select.component.ts:233</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to <code>true</code> for readonly state.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="size"></a> <b>size</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>&quot;sm&quot; | &quot;md&quot; | &quot;lg&quot;</code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>&quot;md&quot;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="217" class="link-to-prism">src/select/select.component.ts:217</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Number input field render size</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="skeleton"></a> <b>skeleton</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="225" class="link-to-prism">src/select/select.component.ts:225</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to true for a loading select.</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="theme"></a> <b>theme</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>&quot;light&quot; | &quot;dark&quot;</code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>&quot;dark&quot;</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="239" class="link-to-prism">src/select/select.component.ts:239</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="value"></a> <b>value</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code><a href="https://www.typescriptlang.org/docs/handbook/basic-types.html" target="_blank" >any</a></code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="170" class="link-to-prism">src/select/select.component.ts:170</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="warn"></a> <b>warn</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="205" class="link-to-prism">src/select/select.component.ts:205</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Set to <code>true</code> to show a warning (contents set by warningText)</p> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="warnText"></a> <b>warnText</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="209" class="link-to-prism">src/select/select.component.ts:209</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Sets the warning text</p> </div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-outputs"> <h3 id="outputs">Outputs</h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="valueChange"></a> <b>valueChange</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>EventEmitter</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/select/select.component.ts:247</a></div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-methods"> <h3>HostListeners</h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="focusout"></a> <span class="name"> <span ><b>focusout</b></span> <a href="#focusout"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>focusout()</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="308" class="link-to-prism">src/select/select.component.ts:308</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Listens for the host blurring, and notifies the model</p> </div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-methods"> <h3 id="methods"> Methods </h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="focusOut"></a> <span class="name"> <span class="modifier"></span> <span ><b>focusOut</b></span> <a href="#focusOut"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <span class="modifier-icon icon ion-ios-reset"></span> <code>focusOut()</code> </td> </tr> <tr> <td class="col-md-4"> <b>Decorators : </b> <br /> <code>@HostListener(&#x27;focusout&#x27;)<br /></code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="308" class="link-to-prism">src/select/select.component.ts:308</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"><p>Listens for the host blurring, and notifies the model</p> </div> <div class="io-description"> <b>Returns : </b> <code><a href="https://www.typescriptlang.org/docs/handbook/basic-types.html" target="_blank" >void</a></code> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="handleFocus"></a> <span class="name"> <span ><b>handleFocus</b></span> <a href="#handleFocus"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>handleFocus(event: FocusEvent)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="336" class="link-to-prism">src/select/select.component.ts:336</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>event</td> <td> <code>FocusEvent</code> </td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code><a href="https://www.typescriptlang.org/docs/handbook/basic-types.html" target="_blank" >void</a></code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="isTemplate"></a> <span class="name"> <span class="modifier">Public</span> <span ><b>isTemplate</b></span> <a href="#isTemplate"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <span class="modifier-icon icon ion-ios-reset"></span> <code>isTemplate(value)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="312" class="link-to-prism">src/select/select.component.ts:312</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>value</td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ngAfterViewInit"></a> <span class="name"> <span ><b>ngAfterViewInit</b></span> <a href="#ngAfterViewInit"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ngAfterViewInit()</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="255" class="link-to-prism">src/select/select.component.ts:255</a></div>