mirror of
https://github.com/primer/css.git
synced 2024-12-25 23:23:47 +03:00
71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
---
|
|
title: Autocomplete
|
|
path: components/autocomplete
|
|
status: Stable
|
|
source: 'https://github.com/primer/css/tree/main/src/autocomplete'
|
|
bundle: autocomplete
|
|
---
|
|
|
|
## Autocomplete
|
|
|
|
A list of items used to show autocompleted results. Use the [`<auto-complete>`](https://github.com/github/auto-complete-element) element to add functionality.
|
|
|
|
```html live
|
|
<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.
|
|
|
|
```html live
|
|
<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>`](https://github.com/github/text-expander-element) element to add functionality.
|
|
|
|
```html live
|
|
<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>
|
|
```
|