debian-mirror-gitlab/doc/user/project/autocomplete_characters.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

57 lines
2.2 KiB
Markdown
Raw Normal View History

2020-10-24 23:57:45 +05:30
---
stage: Create
group: Source Code
2021-02-22 17:27:13 +05:30
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
2020-10-24 23:57:45 +05:30
type: reference
2021-03-11 19:13:27 +05:30
description: "Autocomplete characters in Markdown fields."
2020-10-24 23:57:45 +05:30
---
2021-03-11 19:13:27 +05:30
# Autocomplete characters **(FREE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36705) in GitLab 13.9: you can search using the full name in user autocomplete.
2019-09-30 21:07:59 +05:30
The autocomplete characters provide a quick way of entering field values into
Markdown fields. When you start typing a word in a Markdown field with one of
the following characters, GitLab progressively autocompletes against a set of
matching values. The string matching is not case sensitive.
2021-04-17 20:07:23 +05:30
| Character | Autocompletes | Relevant matches shown |
| :-------- | :------------ | :---- |
| `~` | Labels | 20 |
| `%` | Milestones | 5 |
| `@` | Users and groups | 10 |
| `#` | Issues | 5 |
| `!` | Merge requests | 5 |
| `&` | Epics | 5 |
| `$` | Snippets | 5 |
| `:` | Emoji | 5 |
| `/` | Quick Actions | 100 |
When you select an item from the list, the value is entered in the field.
The more characters you enter, the more precise the matches are.
2019-09-30 21:07:59 +05:30
Autocomplete characters are useful when combined with [Quick Actions](quick_actions.md).
2021-04-17 20:07:23 +05:30
## User autocomplete
2019-09-30 21:07:59 +05:30
Assume your GitLab instance includes the following users:
2021-01-03 14:25:43 +05:30
<!-- vale gitlab.Spelling = NO -->
2019-09-30 21:07:59 +05:30
| Username | Name |
| :-------------- | :--- |
| alessandra | Rosy Grant |
| lawrence.white | Kelsey Kerluke |
| leanna | Rosemarie Rogahn |
| logan_gutkowski | Lee Wuckert |
| shelba | Josefine Haley |
2021-01-03 14:25:43 +05:30
<!-- vale gitlab.Spelling = YES -->
2021-04-17 20:07:23 +05:30
User autocompletion sorts by the users whose username or name start with your query first.
For example, typing `@lea` shows `leanna` first and typing `@ros` shows `Rosemarie Rogahn` and `Rosy Grant` first.
Any usernames or names that include your query are shown afterwards in the autocomplete menu.
2021-03-11 19:13:27 +05:30
You can also search across the full name to find a user.
2021-04-17 20:07:23 +05:30
To find `Rosy Grant`, even if their username is for example `alessandra`, you can type their full name without spaces like `@rosygrant`.