# Combobox Extensions

```js script
import { html } from 'lit-html';
import './md-combobox/md-combobox.js';
import './gh-combobox/gh-combobox.js';
import './wa-combobox/wa-combobox.js';
import './google-combobox/google-combobox.js';

export default {
  title: 'Forms/Combobox/Extensions',
};
```

Below several extensions can be found. They illustrate that complex UI components can be created
easily from an extended Lion component, just by:

- **configuring**: setting properties or providing conditions via methods
- **enhancing**: adding extra html/styles/logic without changing behavior of the extended element
- **overriding**: replace html/styles/logic of the extended element with your own

## Material Design

```js preview-story
export const MaterialDesign = () => html`
  <md-combobox name="combo" label="Default">
    <md-option .choiceValue=${'Apple'}>Apple</md-option>
    <md-option .choiceValue=${'Artichoke'}>Artichoke</md-option>
    <md-option .choiceValue=${'Asparagus'}>Asparagus</md-option>
    <md-option .choiceValue=${'Banana'}>Banana</md-option>
    <md-option .choiceValue=${'Beets'}>Beets</md-option>
  </md-combobox>
`;
```

## Github

```js preview-story
export const Github = () => html`
  <gh-combobox name="combo" label="Switch branches/tags">
    <gh-option href="https://www.github.com" .choiceValue=${'master'} default>master</gh-option>
    <gh-option .choiceValue=${'develop'}>develop</gh-option>
    <gh-option .choiceValue=${'release'}>release</gh-option>
    <gh-option .choiceValue=${'feat/abc'}>feat/abc</gh-option>
    <gh-option .choiceValue=${'feat/xyz123'}>feat/xyz123</gh-option>
  </gh-combobox>
`;
```

## Whatsapp

```js preview-story
export const Whatsapp = () => html`
  <wa-combobox name="combo" label="Filter chats">
    <wa-option
      title="Barack Obama"
      text="Yup, let's try that for now👍"
      time="15:02"
      is-user-text
      is-user-text-read
      image="https://pbs.twimg.com/profile_images/822547732376207360/5g0FC8XX_400x400.jpg"
      .choiceValue=${'Barack Obama'}
    ></wa-option>
    <wa-option
      title="Donald Trump"
      text="Take care!"
      time="14:59"
      is-user-text
      image="https://pbs.twimg.com/profile_images/874276197357596672/kUuht00m_400x400.jpg"
      .choiceValue=${'Donald Trump'}
    ></wa-option>
    <wa-option
      title="Joe Biden"
      text="Hehe😅. You too, man, you too..."
      time="yesterday"
      image="https://pbs.twimg.com/profile_images/1308769664240160770/AfgzWVE7_400x400.jpg"
      .choiceValue=${'Joe Biden'}
    ></wa-option>
    <wa-option
      title="George W. Bush"
      time="friday"
      text="You bet I will. Let's catch up soon!"
      image="https://pbs.twimg.com/profile_images/828483922266877954/ljYUWUCu_400x400.jpg"
      .choiceValue=${'George W. Bush'}
    ></wa-option>
    <wa-option
      title="Bill Clinton"
      time="thursday"
      text="Dude...😂 😂 😂"
      image="https://pbs.twimg.com/profile_images/1239440892664086529/iY0Z83Dr_400x400.jpg"
      .choiceValue=${'Bill Clinton'}
    ></wa-option>
  </wa-combobox>
`;
```

**Whatsapp example shows:**

- advanced styling
- how to match/highlight text on multiple rows of the option (not just choiceValue)
- how to animate options

## Google Search

```js preview-story
export const GoogleSearch = () => {
  const appleLogoUrl = new URL('./google-combobox/assets/appleLogo.png', import.meta.url).href;
  return html`
    <google-combobox name="combo" label="Google Search">
      <google-option
        href="https://www.google.com/search?query=apple"
        target="_blank"
        rel="noopener noreferrer"
        .choiceValue=${'Apple'}
        .imageUrl=${appleLogoUrl}
        >Apple</google-option
      >
      <google-option
        href="https://www.google.com/search?query=Artichoke"
        target="_blank"
        rel="noopener noreferrer"
        .choiceValue=${'Artichoke'}
        >Artichoke</google-option
      >
      <google-option
        href="https://www.google.com/search?query=Asparagus"
        target="_blank"
        rel="noopener noreferrer"
        .choiceValue=${'Asparagus'}
        >Asparagus</google-option
      >
      <google-option
        href="https://www.google.com/search?query=Banana"
        target="_blank"
        rel="noopener noreferrer"
        .choiceValue=${'Banana'}
        >Banana</google-option
      >
      <google-option
        href="https://www.google.com/search?query=Beets"
        target="_blank"
        rel="noopener noreferrer"
        .choiceValue=${'Beets'}
        >Beets</google-option
      >
    </google-combobox>
    <div style="height:200px;"></div>
  `;
};
```

**Google Search example shows:**

- advanced styling
- how to use options that are links
- create exact user experience of Google Search, by:
  - using autocomplete 'list' as a fundament (we don't want inline completion in textbox)
  - enhancing `_showOverlayCondition`: open on focus
  - enhancing `_syncToTextboxCondition`: always sync to textbox when navigating by keyboard (this needs to be enabled, since it's not provided in the "autocomplete=list" preset)