---

Ⅰ. 插件描述

Simple text-based forms for vim

Ⅱ. 基本信息

创建日期：  2010-04-08 使用用户：  2 Github星：  14 插件作者：  Tom Link

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'tomtom/vimform'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'tomtom/vimform'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'tomtom/vimform'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/tomtom/vimform_vim

Ⅳ. 文档说明

Example: >

let form = vimform#New()
let form.name = "Test Form"
let form.fields = [
            \ ['Name'],
            \ ['Address',  {'join': "\n"}],
            \ ['Planet',   {'value': 'Earth'}],
            \ ['Phone',    {'validate': '%s =~ ''^[0-9()+-]*$''',
            \               'message': 'Must be a phone number'}],
            \ ['E-Mail',   {'validate': '%s =~ ''^\([a-zA-Z.]\+@[a-zA-Z]\+\.[a-zA-Z.]\+\)\?$''',
            \               'message': 'Must be an e-mail'}],
            \ ['Private',  {'value': 0, 'type': 'checkbox'}],
            \ ['Business', {'value': 1, 'type': 'checkbox'}],
            \ ]
function! form.Do_Submit() dict "{{{3
    echom "Test: ". self.name
    for [field, value] in items(self.values)
        echom "Field" field value
    endfor
endf

call form.Split()

This will create a form, which looks like this: >

<<&Submit>> <<&Cancel>>
     Name: 
  Address: 
   Planet: Earth
    Phone: 
   E-Mail: 
  Private: [ ]
 Business: [X]

Check out further examples on:
http://github.com/tomtom/vimform_vim/tree/master/test/

The following field types are currently supported:

- text fields
- check boxes
- single choice/drop-down lists

                                                *vimform-keys*

The following key maps can be used to navigate through forms:

<c-cr> "Press" a button. If the cursor, is not over a button,

            the form will be submitted, i.e. the Do_Submit() method 
            is called.

<c-w>c Abandon/close/cancel the form.

<f5> Redraw the form.

<tab> Jump to the next field (this will also save the current

            field's value so that it doesn't get lost when redrawing 
            a form)

<s-tab> Jump to the previous field

<c-x><c-o>
<c-space> Invoke the completion menu if a completion function is

            defined for the current field.

`[LETTER] Accelerator keys are prefixed with an ampersand (&).

            Those letters are defined as |mark|s. Jump to a button 
            with |`|.

<LeftMouse>
<space>
<cr> If the cursor is located over a checkbox, toggle that

            check box. If the cursor is over a drop-down list, open the 
            list.

a
i Switch to insert mode.

<c-n> <c-p> <c-y> <c-e>

            Navigate drop-down lists. See also |ins-completion|.

---

Install~

In order to install the vba, open the vba file in VIM and type: >

:so %

See :help vimball for details.

Also available via git: http://github.com/tomtom/vimform_vim/

License: GPLv3 or later
Install: See http://github.com/tomtom/vimtlib/blob/master/INSTALL.TXT
See http://github.com/tomtom for related plugins.