1
1
mirror of https://github.com/primer/css.git synced 2024-12-25 15:14:59 +03:00
css/docs/content/components/autocomplete.md

2.7 KiB

title path status source bundle
Autocomplete components/autocomplete Stable https://github.com/primer/css/tree/main/src/autocomplete autocomplete

Autocomplete

A list of items used to show autocompleted results. Use the <auto-complete> element to add functionality.

<div class="position-relative">
  <input class="form-control input-block" type="text" aria-label="Search" placeholder="Search">
  <ul class="autocomplete-results">
    <li class="autocomplete-item" aria-selected="true">Option 1</li>
    <li class="autocomplete-item">Option 2</li>
    <li class="autocomplete-item">Option 3</li>
  </ul>
</div>

<style>.frame-example {width:300px;height:160px;}</style>

Autocomplete items can contain additional content, like an .avatar. Or use utility classes to customize the text style.

<div class="position-relative">
  <input class="form-control input-block" type="text" aria-label="Search by user" placeholder="Search by user">
  <ul class="autocomplete-results">
    <li class="autocomplete-item" aria-selected="true">
      <img src="https://github.com/github.png" width="20" class="avatar mr-1" alt="">
      <span>GitHub Inc.</span>
      <span class="text-normal">@github</span>
    </li>
    <li class="autocomplete-item">
      <img src="https://github.com/hubot.png" width="20" class="avatar mr-1" alt="">
      <span>Hubot</span>
      <span class="text-normal">@hubot</span>
    </li>
    <li class="autocomplete-item">
      <img src="https://github.com/octocat.png" width="20" class="avatar mr-1" alt="">
      <span>Monalisa Octocat</span>
      <span class="text-normal">@octocat</span>
    </li>
  </ul>
</div>

<style>.frame-example {width:300px;height:160px;}</style>

Suggester

The .suggester component is meant for showing suggestions while typing in a larger text area. Use the <text-expander> element to add functionality.

<div class="form-group position-relative">
  <textarea class="form-control width-full" placeholder="Leave a comment" aria-label="Comment body">This is on top of #</textarea>
  <ul class="suggester suggester-container" role="listbox" style="top: 4px; left: 125px;">
    <li aria-selected="true"> <small>#924</small> <span>Markdown tables are inaccessible</span> </li>
    <li> <small>#980</small> <span>Use actual book emoji in Flexbox docs</span> </li>
    <li> <small>#979</small> <span>Add `.radio-group` component</span> </li>
    <li> <small>#925</small> <span>Release 14.0.0</span> </li>
    <li> <small>#978</small> <span>Add `.css-truncate-overflow`</span> </li>
  </ul>
</div>

<style>.frame-example {height:260px;}</style>