非推奨

Nvim :help ページは、ソースから tree-sitter-vimdoc パーサーを使用して生成されています。

Nvim

以下にリストされている項目は非推奨です。これらは将来削除される予定です。新しいスクリプトでは使用しないでください。また、古いスクリプトは更新する必要があります。

非推奨の機能

0.11 で非推奨 deprecated-0.11

API

nvim_subscribe() プラグインは独自の「マルチキャスト」チャネルリストを管理する必要があります。

nvim_unsubscribe() プラグインは独自の「マルチキャスト」チャネルリストを管理する必要があります。

LUA

vim.region() 代わりに getregionpos() を使用してください。

vim.highlight vim.hl に名前が変更されました。

vim.validate(opts: table) form 1 を使用してください。vim.validate() を参照してください。

診断

vim.diagnostic.goto_next() 代わりに vim.diagnostic.jump() を {count=1, float=true} と共に使用してください。

vim.diagnostic.goto_prev() 代わりに vim.diagnostic.jump() を {count=-1, float=true} と共に使用してください。

vim.diagnostic.get_next_pos() 代わりに vim.diagnostic.get_next() の戻り値から "lnum" と "col" フィールドを使用してください。

vim.diagnostic.get_prev_pos() 代わりに vim.diagnostic.get_prev() の戻り値から "lnum" と "col" フィールドを使用してください。

さまざまな関数で使用されている "win_id" パラメーターは、"winid" winid に代わって非推奨になりました。

vim.diagnostic.JumpOpts の "cursor_position" パラメーターは "pos" に名前が変更されました。

TREESITTER

TSNode:child_containing_descendant() 代わりに TSNode:child_with_descendant() を使用してください。子孫自体を返すことができることを除いて同じです。

LSP

vim.lsp.util.jump_to_location 代わりに vim.lsp.util.show_document() を {focus=true} と共に使用してください。

vim.lsp.buf.execute_command 代わりに Client:exec_cmd() を使用してください。

vim.lsp.buf.completion 代わりに vim.lsp.completion.trigger() を使用してください。

vim.lsp.buf_request_all ハンドラの result パラメーター内の error キーは err に名前が変更されました。

vim.lsp.with() 設定を同等の関数 `invim.lsp.buf.*` に渡してください。

vim.lsp.handlers クライアントからサーバーへのレスポンスハンドラはサポートされなくなりました。サーバーからクライアントへのリクエスト/通知ハンドラのみがサポートされています。

vim.lsp.handlers.signature_help() 代わりに vim.lsp.buf.signature_help() を使用してください。

0.10 で非推奨 deprecated-0.10

API

nvim_buf_get_option() 代わりに nvim_get_option_value() を使用してください。

nvim_buf_set_option() 代わりに nvim_set_option_value() を使用してください。

nvim_call_atomic() 代わりに nvim_exec_lua() を使用してください。

nvim_get_option() 代わりに nvim_get_option_value() を使用してください。

nvim_set_option() 代わりに nvim_set_option_value() を使用してください。

nvim_win_get_option() 代わりに nvim_get_option_value() を使用してください。

nvim_win_set_option() 代わりに nvim_set_option_value() を使用してください。

健全性チェック

health#report_error vim.health.report_error() 代わりに vim.health.error() を使用してください。

health#report_info vim.health.report_info() 代わりに vim.health.info() を使用してください。

health#report_ok vim.health.report_ok() 代わりに vim.health.ok() を使用してください。

health#report_start vim.health.report_start() 代わりに vim.health.start() を使用してください。

health#report_warn vim.health.report_warn() 代わりに vim.health.warn() を使用してください。

診断

diagnostic-signs を :sign-define または sign_define() を使用して設定することは非推奨です。代わりに vim.diagnostic.config() の "signs" キーを使用してください。

vim.diagnostic 関数

vim.diagnostic.disable() vim.diagnostic.enable() を使用してください

vim.diagnostic.is_disabled() vim.diagnostic.is_enabled() を使用してください

従来の署名: vim.diagnostic.enable(buf:number, namespace:number)

LSP

vim.lsp.util.get_progress_messages() 代わりに vim.lsp.status() を使用してください。

vim.lsp.get_active_clients() 代わりに vim.lsp.get_clients() を使用してください。

vim.lsp.for_each_buffer_client() 代わりに vim.lsp.get_clients() を使用してください。

vim.lsp.util.trim_empty_lines() 代わりに vim.split() を `trimempty` と共に使用してください。

vim.lsp.util.try_trim_markdown_code_blocks()

vim.lsp.util.set_lines()

vim.lsp.util.extract_completion_items()

vim.lsp.util.parse_snippet()

vim.lsp.util.text_document_completion_list_to_complete_items()

vim.lsp.util.lookup_section() 代わりに vim.tbl_get() を使用してください

local keys = vim.split(section, '.', { plain = true })
local  vim.tbl_get(table, unpack(keys))

LUA

vim.loop 代わりに vim.uv を使用してください。

vim.tbl_add_reverse_lookup()

vim.tbl_flatten() 代わりに Iter:flatten() を使用してください。

vim.tbl_islist() 代わりに vim.islist() を使用してください。

オプション

"term_background" UI オプション ui-ext-options は非推奨となり、設定されなくなりました。背景色の検出は、TUI ではなく、Nvim コアによって Lua で実行されるようになりました。

TREESITTER

LanguageTree:for_each_child() 代わりに LanguageTree:children() (非再帰的) を使用してください。

0.9 で非推奨 deprecated-0.9

API

nvim_get_hl_by_name() 代わりに nvim_get_hl() を使用してください。

nvim_get_hl_by_id() 代わりに nvim_get_hl() を使用してください。

TREESITTER

vim.treesitter.language.require_language() 代わりに vim.treesitter.language.add() を使用してください。

vim.treesitter.get_node_at_pos() 代わりに vim.treesitter.get_node() を使用してください。

vim.treesitter.get_node_at_cursor() 代わりに vim.treesitter.get_node() と TSNode:type() を使用してください。

以下のトップレベル Treesitter 関数は移動されました

vim.treesitter.inspect_language() -> vim.treesitter.language.inspect()

vim.treesitter.get_query_files() -> vim.treesitter.query.get_files()

vim.treesitter.set_query() -> vim.treesitter.query.set()

vim.treesitter.query.set_query() -> vim.treesitter.query.set()

vim.treesitter.get_query() -> vim.treesitter.query.get()

vim.treesitter.query.get_query() -> vim.treesitter.query.get()

vim.treesitter.parse_query() -> vim.treesitter.query.parse()

vim.treesitter.query.parse_query() -> vim.treesitter.query.parse()

vim.treesitter.add_predicate() -> vim.treesitter.query.add_predicate()

vim.treesitter.add_directive() -> vim.treesitter.query.add_directive()

vim.treesitter.list_predicates() -> vim.treesitter.query.list_predicates()

vim.treesitter.list_directives() -> vim.treesitter.query.list_directives()

vim.treesitter.query.get_range() -> vim.treesitter.get_range()

vim.treesitter.query.get_node_text() -> vim.treesitter.get_node_text()

LUA

nvim_exec() nvim_exec2() を代わりに使用してください。

vim.pretty_print() vim.print() を代わりに使用してください。

バージョン 0.8 以前で非推奨

API

nvim_buf_clear_highlight() nvim_buf_clear_namespace() を代わりに使用してください。

nvim_buf_set_virtual_text() nvim_buf_set_extmark() を代わりに使用してください。

nvim_command_output() nvim_exec2() を代わりに使用してください。

nvim_execute_lua() nvim_exec_lua() を代わりに使用してください。

nvim_get_option_info() nvim_get_option_info2() を代わりに使用してください。

コマンド

:rv :rviminfo 非推奨 :rshada コマンドのエイリアスです。

:wv :wviminfo 非推奨 :wshada コマンドのエイリアスです。

環境変数

$NVIM_LISTEN_ADDRESS

非推奨 の設定方法です。

サーバー名の設定には、--listen または serverstart() を使用してください。

サーバー名の取得には、v:servername を使用してください。

親Nvimの検出には、$NVIM を使用してください。

--listen が指定されている場合は無視されます。

"env" オプションで明示的に指定されていない限り、terminal と jobstart() によって設定が解除されます。例：

call jobstart(['foo'], { 'env': { 'NVIM_LISTEN_ADDRESS': v:servername  } })

イベント

BufCreate BufAdd を代わりに使用してください。

EncodingChanged 発行されません。 'encoding' は常に "utf-8" です。

FileEncoding 発行されません。 EncodingChanged と同等です。

GUIEnter 発行されません。 UIEnter を代わりに使用してください。

GUIFailed 発行されません。

キーコード

<MouseDown> <ScrollWheelUp> を代わりに使用してください。

<MouseUp> <ScrollWheelDown> を代わりに使用してください。

関数

buffer_exists() bufexists() の古い名前です。

buffer_name() bufname() の古い名前です。

buffer_number() bufnr() の古い名前です。

file_readable() filereadable() の古い名前です。

highlight_exists() hlexists() の古い名前です。

highlightID() hlID() の古い名前です。

inputdialog() input() を代わりに使用してください。

jobclose() chanclose() の古い名前です。

jobsend() chansend() の古い名前です。

last_buffer_nr() bufnr("$") の古い名前です。

rpcstart() {'rpc': v:true} を指定した jobstart() を代わりに使用してください。

rpcstop() ジョブを停止するには jobstop() を、ジョブを停止せずに RPC 通信を閉じるには chanclose(id, "rpc") を使用してください。ソケットを閉じるには chanclose(id) を使用してください。

ハイライト

hl-VertSplit hl-WinSeparator を代わりに使用してください。

LSP 診断

以下の各関数については、vim.diagnostic 内の対応する関数を代わりに使用してください（特に指定のない限り）。例えば、vim.lsp.diagnostic.get() の代わりに vim.diagnostic.get() を使用してください。

vim.lsp.diagnostic.clear() vim.diagnostic.hide() を代わりに使用してください。

vim.lsp.diagnostic.disable() vim.diagnostic.enable() を代わりに使用してください。 --> vim.diagnostic.disable() を代わりに使用してください。

vim.lsp.diagnostic.display() vim.diagnostic.show() を代わりに使用してください。

vim.lsp.diagnostic.enable() --> vim.diagnostic.enable() を使用してください。

vim.lsp.diagnostic.get() --> vim.diagnostic.get() を使用してください。

vim.lsp.diagnostic.get_all() vim.diagnostic.get() を代わりに使用してください。

vim.lsp.diagnostic.get_count() vim.diagnostic.count() を代わりに使用してください。

vim.lsp.diagnostic.get_line_diagnostics() vim.diagnostic.get() を代わりに使用してください。

vim.lsp.diagnostic.get_next() --> vim.diagnostic.goto_next() を使用してください。 (戻り値が異なります)

vim.lsp.diagnostic.get_next_pos() --> 代替なし。 vim.diagnostic.goto_next() と組み合わせて使用してください。

vim.lsp.diagnostic.get_prev() --> vim.diagnostic.goto_prev() を使用してください。(戻り値が異なります)

vim.lsp.diagnostic.get_prev_pos() --> 代替なし。 vim.diagnostic.goto_prev() と組み合わせて使用してください。

vim.lsp.diagnostic.get_virtual_text_chunks_for_line() 代替なし。仮想テキストをカスタマイズするには、vim.diagnostic.config() で提供されるオプションを使用してください。

vim.lsp.diagnostic.goto_next() --> vim.diagnostic.goto_next() を使用してください。

vim.lsp.diagnostic.goto_prev() --> vim.diagnostic.goto_prev() を使用してください。

vim.lsp.diagnostic.redraw() vim.diagnostic.show() を代わりに使用してください。

vim.lsp.diagnostic.reset() --> vim.diagnostic.reset() を使用してください。

vim.lsp.diagnostic.save() vim.diagnostic.set() を代わりに使用してください。

vim.lsp.diagnostic.set_loclist() vim.diagnostic.setloclist() を代わりに使用してください。

vim.lsp.diagnostic.set_qflist() vim.diagnostic.setqflist() を代わりに使用してください。

vim.lsp.diagnostic.show_line_diagnostics() vim.diagnostic.open_float() を代わりに使用してください。

vim.lsp.diagnostic.show_position_diagnostics() vim.diagnostic.open_float() を代わりに使用してください。

以下は代替なしで非推奨です。これらの関数は内部的に移動され、API の一部として公開されなくなりました。代わりに、vim.diagnostic.config() と vim.diagnostic.show() を使用してください。

vim.lsp.diagnostic.set_signs()

vim.lsp.diagnostic.set_underline()

vim.lsp.diagnostic.set_virtual_text()

LSP 関数

vim.lsp.buf.server_ready() ユースケースに応じて、LspAttach を代わりに使用してください。「サーバーの準備完了」は LSP 仕様の一部ではないため、Nvim LSP クライアントは有意な実装を提供できません。「準備完了」は曖昧です。なぜなら

言語サーバーはワークスペースの分析を完了できますが、編集によって分析/ビルドが再トリガーされる可能性があります。

言語サーバーは変更の処理中でも一部のリクエストに対応できます。

vim.lsp.buf.range_code_action() range パラメーターを指定した vim.lsp.buf.code_action() を使用してください。

vim.lsp.util.diagnostics_to_items() vim.diagnostic.toqflist() を代わりに使用してください。

vim.lsp.util.set_qflist() setqflist() を代わりに使用してください。

vim.lsp.util.set_loclist() setloclist() を代わりに使用してください。

vim.lsp.buf_get_clients() {buffer=bufnr} を指定した vim.lsp.get_clients() を代わりに使用してください。

vim.lsp.buf.formatting() {async=true} を指定した vim.lsp.buf.format() を代わりに使用してください。

vim.lsp.buf.formatting_sync() {async=false} を指定した vim.lsp.buf.format() を代わりに使用してください。

vim.lsp.buf.range_formatting() vim.lsp.formatexpr() または vim.lsp.buf.format() を代わりに使用してください。

LUA

vim.register_keystroke_callback() vim.on_key() を代わりに使用してください。

ノーマルモードコマンド

]f [f "gf" と同じです。

オプション

cpo-< :menu-<special> :menu-special :map-<special> :map-special <> 表記は常に有効です。

'fe' Vim 6.0 より前は 'fenc' + 'enc' でした。現在は使用されていません。

'highlight' 'hl' ビルトインのハイライトグループの名前は変更できません。

'langnoremap' 非推奨 'nolangremap' のエイリアスです。

'sessionoptions' フラグ "unix"、 "slash" は無視され、常に有効です。

'vi'

'viewoptions' フラグ "unix"、 "slash" は無視され、常に有効です。

'viminfo' 非推奨 'shada' オプションのエイリアスです。

'viminfofile' 非推奨 'shadafile' オプションのエイリアスです。

'paste' 'nopaste' Just Paste It.™ 'paste' オプションは廃止されました。端末または GUI の貼り付け機能（CTRL-SHIFT-v、CMD-v（macOS）、ミドルクリックなど）を使用してテキストを貼り付けると、貼り付けは自動的に処理されます。「貼り付けモード」を有効にします

挿入モード、コマンドラインモードのマッピングを無効にします。

省略形を無効にします。

'autoindent' 'expandtab' 'revins' 'ruler' 'showmatch' 'smartindent' 'smarttab' 'softtabstop' 'textwidth' 'wrapmargin' をリセットします。

'formatoptions' を空として扱います。

以下のオプションの効果を無効にします

'cindent'

'indentexpr'

'lisp'