pub struct CompletionItem {Show 18 fields
pub label: String,
pub label_details: Option<CompletionItemLabelDetails>,
pub kind: Option<CompletionItemKind>,
pub tags: Option<Vec<CompletionItemTag>>,
pub detail: Option<String>,
pub documentation: Option<Union2<String, MarkupContent>>,
pub preselect: Option<bool>,
pub sort_text: Option<String>,
pub filter_text: Option<String>,
pub insert_text: Option<String>,
pub insert_text_format: Option<InsertTextFormat>,
pub insert_text_mode: Option<InsertTextMode>,
pub text_edit: Option<Union2<TextEdit, InsertReplaceEdit>>,
pub text_edit_text: Option<String>,
pub additional_text_edits: Option<Vec<TextEdit>>,
pub commit_characters: Option<Vec<String>>,
pub command: Option<Command>,
pub data: Option<Value>,
}Expand description
A completion item represents a text snippet that is proposed to complete text that is being typed.
Fields§
§label: StringThe label of this completion item.
The label property is also by default the text that is inserted when selecting this completion.
If label details are provided the label itself should be an unqualified name of the completion item.
label_details: Option<CompletionItemLabelDetails>Additional details for the label
@since 3.17.0
kind: Option<CompletionItemKind>The kind of this completion item. Based of the kind an icon is chosen by the editor.
Tags for this completion item.
@since 3.15.0
detail: Option<String>A human-readable string with additional information about this item, like type or symbol information.
documentation: Option<Union2<String, MarkupContent>>A human-readable string that represents a doc-comment.
preselect: Option<bool>Select this item when showing.
Note that only one completion item can be selected and that the tool / client decides which item that is. The rule is that the first item of those that match best is selected.
sort_text: Option<String>A string that should be used when comparing this item
with other items. When falsy the {@link CompletionItem.label label}
is used.
filter_text: Option<String>A string that should be used when filtering a set of
completion items. When falsy the {@link CompletionItem.label label}
is used.
insert_text: Option<String>A string that should be inserted into a document when selecting
this completion. When falsy the {@link CompletionItem.label label}
is used.
The insertText is subject to interpretation by the client side.
Some tools might not take the string literally. For example
VS Code when code complete is requested in this example
con<cursor position> and a completion item with an insertText of
console is provided it will only insert sole. Therefore it is
recommended to use textEdit instead since it avoids additional client
side interpretation.
insert_text_format: Option<InsertTextFormat>The format of the insert text. The format applies to both the
insertText property and the newText property of a provided
textEdit. If omitted defaults to InsertTextFormat.PlainText.
Please note that the insertTextFormat doesn’t apply to
additionalTextEdits.
insert_text_mode: Option<InsertTextMode>How whitespace and indentation is handled during completion
item insertion. If not provided the clients default value depends on
the textDocument.completion.insertTextMode client capability.
@since 3.16.0
text_edit: Option<Union2<TextEdit, InsertReplaceEdit>>An {@link TextEdit edit} which is applied to a document when selecting this completion. When an edit is provided the value of {@link CompletionItem.insertText insertText} is ignored.
Most editors support two different operations when accepting a completion
item. One is to insert a completion text and the other is to replace an
existing text with a completion text. Since this can usually not be
predetermined by a server it can report both ranges. Clients need to
signal support for InsertReplaceEdits via the
textDocument.completion.insertReplaceSupport client capability
property.
Note 1: The text edit’s range as well as both ranges from an insert
replace edit must be a [single line] and they must contain the position
at which completion has been requested.
Note 2: If an InsertReplaceEdit is returned the edit’s insert range
must be a prefix of the edit’s replace range, that means it must be
contained and starting at the same position.
@since 3.16.0 additional type InsertReplaceEdit
text_edit_text: Option<String>The edit text used if the completion item is part of a CompletionList and CompletionList defines an item default for the text edit range.
Clients will only honor this property if they opt into completion list
item defaults using the capability completionList.itemDefaults.
If not provided and a list’s default range is provided the label property is used as a text.
@since 3.17.0
additional_text_edits: Option<Vec<TextEdit>>An optional array of additional {@link TextEdit text edits} that are applied when selecting this completion. Edits must not overlap (including the same insert position) with the main {@link CompletionItem.textEdit edit} nor with themselves.
Additional text edits should be used to change text unrelated to the current cursor position (for example adding an import statement at the top of the file if the completion item will insert an unqualified type).
commit_characters: Option<Vec<String>>An optional set of characters that when pressed while this completion is active will accept it first and
then type that character. Note that all commit characters should have length=1 and that superfluous
characters will be ignored.
command: Option<Command>An optional {@link Command command} that is executed after inserting this completion. Note that additional modifications to the current document should be described with the {@link CompletionItem.additionalTextEdits additionalTextEdits}-property.
data: Option<Value>A data entry field that is preserved on a completion item between a {@link CompletionRequest} and a {@link CompletionResolveRequest}.
Trait Implementations§
Source§impl Clone for CompletionItem
impl Clone for CompletionItem
Source§fn clone(&self) -> CompletionItem
fn clone(&self) -> CompletionItem
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more