Skip to content

501351981/v-experience

Repository files navigation

v-focus-next

简介

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示例:

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示例:

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>

赞助和微信交流

如果该项目确实帮助到了您,欢迎赞助,以鼓励我将更多的休息时间,投入到该项目的优化中,也欢迎赞助后添加微信交流:_hit757_

赞助二维码

恳请各位大佬不吝点赞,开源不易,感谢支持~~

About

整理各种提升用户体验的Vue指令,支持Vue2和Vue3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published