cposture / vim-textobj-argument

This plugin adds text object support for separated arguments enclosed by brackets.

Introduction

This plugin adds text object support for separated arguments enclosed by brackets.

Installation

You can install it using your favorite plugin manager. Here's an example using vim-plug

Plug 'kana/vim-textobj-user'
Plug 'cposture/vim-textobj-argument'

Dependent on another plugin kana/vim-textobj-user, a Vim plugin to create your own text objects without pain

Examples

function(a, /*comment*/ b, c)

• With the cursor on the character 'b', typing daa, would get function(a, c), typing dia would get function(a, /*comment*/ , c)
• Counts are supported. With the cursor on the character 'a' or before it for example character 'f', typing d2aa or 2daa would get function(c)
• Move to start of next argument, with the cursor on the character 'a', typing ]a, the cursor will move to the 'b' parameter.

Configuration

Customize the separator, which is , by default, in regular expression format, refer to :help pattern:

let g:argument_separator = ','

Customize the left bracket, which is ([ by default, in regular expression format, refer to :help pattern:

let g:argument_left_bracket = '[([]'

Customize the right bracket, which is )] by default, in regular expression format, refer to :help pattern:

let g:argument_right_bracket = '[)]]'

Customize motion mappings, default mappings are described in the following section "Motion commands":

let g:argument_mapping_select_around = 'aa'
let g:argument_mapping_select_inside = 'ia'
let g:argument_mapping_move_previous = '[a'
let g:argument_mapping_move_start = '[A'
let g:argument_mapping_move_next = ']a'
let g:argument_mapping_move_end = ']A'

Motion commands

Motion commands on text objects are a powerful feature of Vim.

aa - select 'around' argument with separator and comment

ia - select ‘inside’ argument without separator and comment

[a - move to start of previous argument

]a - move to start of next argument

[A - move to first argument

]A - move to last argument

Inspiration

• vim-angry
• vim-textobj-sentence