利用v-focus-next指令实现Form表单回车后聚焦下一个元素

简介

v-focus-next是一个Vue指令,使用该指令后,在表单的某个元素中输入回车符,可以自动聚焦到下一个表单元素,避免了用户通过鼠标来回选中表单元素,大大提升了表单填写的效率和用户体验。

《演示效果》

v-focus-next的使用非常简单。

只需要为某个Dom或Vue组件(如div、form、ElForm等)绑定v-focus-next指令,则该Dom下的所有input/textarea自动支持回车聚焦功能,无需任何其他配置。

支持以下特性:

  • 默认会将所有input/textarea加入回车聚焦功能,也可通过指定className等方式,将部分表单元素支持回车聚焦。
  • 支持首个表单元素自动聚焦
  • 支持任意普通Dom元素和Vue组件
  • 自动过滤掉disable的元素及type为hidden、radio、checkbox、file、submit、reset的元素
  • 支持vue2/3

使用

安装

npm install v-focus-next

项目中引入

通过use方式,引入该指令中间件。

Vue3示例:

                  let app = createApp(App)
                  app.use(vFocusNext)  //通过中间件方式引入指令
                  app.mount('#app')" title="" data-bs-original-title="复制" aria-label="复制"></button>
</div>
import { createApp } from 'vue'
import App from './App.vue'
import vFocusNext from "v-focus-next";

let app = createApp(App) app.use(vFocusNext) //通过中间件方式引入指令 app.mount('#app')

Vue2示例:

<button type="button" class="btn btn-dark far fa-copy rounded-0 sflex-center copyCode" data-toggle="tooltip" data-placement="top" data-clipboard-text="import Vue from 'vue' import App from './App.vue' import vFocusNext from "v-focus-next";

                  Vue.use(vFocusNext); //通过中间件方式引入指令
                  
                  new Vue({
                    render: h => h(App),
                    }).$mount('#app')
                    " title="" data-bs-original-title="复制" aria-label="复制"></button>
</div>
import Vue from 'vue'
import App from './App.vue'
import vFocusNext from "v-focus-next";

Vue.use(vFocusNext); //通过中间件方式引入指令

new Vue({ render: h => h(App), }).$mount('#app')

示例1

只需为某个父元素增加v-focus-next指令,则其中所有表单元素就拥有了回车聚焦功能。

 <div v-focus-next>
<input placeholder="输入回车自动聚焦下一行"/>
<input/>
<input/>
<input/>
<input/>
<textarea  />
</div>

Vue组件也是一样的,如为el-form添加v-focus-next指令。

<el-form v-focus-next >
<el-form-item label="名称">
<el-input v-model="form.name" id="name" />
</el-form-item>
<el-form-item label="年龄">
<el-input v-model="form.age" id="age" disabled />
</el-form-item>
</el-form>

示例2:指定参与回车聚焦的元素

或许你不想所有表单元素都参与回车聚焦,比如只想让所有设置了class为'test'的元素参与回车聚焦,只需要设置 v-focus-next="'.test'",可设为querySelectorAll支持的参数形式。

<div v-focus-next="'.test'">
<input class="test"/>
<input />
<input class="test"/>
</div>

示例3:自动聚焦首个元素

只需设置v-focus-next.autoFocus即可。

<div v-focus-next.autoFocus>
<input />  //自动聚焦
<input />
<input />
</div>

欢迎试用点赞

欢迎大家用到自己的项目中,让表单一路Next。
源码: github.com/501351981/v…