v-model表单

1、v-model的基本使用

表单提交是开发中非常常见的功能，也是和用户交互的重要手段：

比如用户在登录、注册时需要提交账号密码；
比如用户在检索、创建、更新信息时，需要提交一些数据；

这些都要求我们可以在代码逻辑中获取到用户提交的数据，我们通常会使用v-model指令来完成：

v-model指令可以在表单 input、textarea以及select元素上创建双向数据绑定；
它会根据控件类型自动选取正确的方法来更新元素；
尽管有些神奇，但 v-model 本质上不过是语法糖，它负责监听用户的输入事件来更新数据，并在某种极端场景下进行一些特殊处理；

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <!-- 1.手动的实现了双向绑定 -->
        <!-- <input type="text" :value="message" @input="inputChange"> -->

        <!-- 2.v-model实现双向绑定 -->
        <!-- <input type="text" v-model="message"> -->

        <!-- 3.登录功能 -->
        <label for="account">
            账号:<input id="account" type="text" v-model="account">
        </label>
        <label for="password">
            密码:<input id="password" type="password" v-model="password">
        </label>

        <button @click="loginClick">登录</button>

        <h2>{{message}}</h2>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    message: "Hello Model",
                    account: "",
                    password: ""
                }
            },
            methods: {
                inputChange(event) {
                    this.message = event.target.value
                },
                loginClick() {
                    const account = this.account
                    const password = this.password

                    // url发送网络请求
                    console.log(account, password)
                }
            }
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

2、v-model的原理

官方有说到，v-model的原理其实是背后有两个操作：

v-bind绑定value属性的值；
v-on绑定input事件监听到函数中，函数会获取最新的值赋值到绑定的属性中；

事实上v-model更加复杂

3、v-model绑定textarea

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <textarea cols="30" rows="10" v-model="content"></textarea>

        <p>输入的内容: {{content}}</p>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    content: ""
                }
            },
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

4、v-model绑定checkbox

我们来看一下v-model绑定checkbox：单个勾选框和多个勾选框

单个勾选框：

v-model即为布尔值。
此时input的value属性并不影响v-model的值。

多个复选框：

当是多个复选框时，因为可以选中多个，所以对应的data中属性是一个数组。
当选中某一个时，就会将input的value添加到数组中。

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <!-- 1.checkbox单选框: 绑定到属性中的值是一个Boolean -->
        <label for="agree">
            <input id="agree" type="checkbox" v-model="isAgree"> 同意协议
        </label>
        <h2>单选框: {{isAgree}}</h2>
        <hr>

        <!-- 2.checkbox多选框: 绑定到属性中的值是一个Array -->
        <!-- 注意: 多选框当中, 必须明确的绑定一个value值 -->
        <div class="hobbies">
            <h2>请选择你的爱好:</h2>
            <label for="sing">
                <input id="sing" type="checkbox" v-model="hobbies" value="sing"> 唱
            </label>
            <label for="jump">
                <input id="jump" type="checkbox" v-model="hobbies" value="jump"> 跳
            </label>
            <label for="rap">
                <input id="rap" type="checkbox" v-model="hobbies" value="rap"> rap
            </label>
            <label for="basketball">
                <input id="basketball" type="checkbox" v-model="hobbies" value="basketball"> 篮球
            </label>
            <h2>爱好: {{hobbies}}</h2>
        </div>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    isAgree: false,
                    hobbies: []
                }
            },
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

5、v-model绑定radio

v-model绑定radio，用于选择其中一项；

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <div class="gender">
            <!-- 在radio中，v-model绑定相同的值实现互斥 -->
            <label for="male">
                <input id="male" type="radio" v-model="gender" value="male"> 男
            </label>
            <label for="female">
                <input id="female" type="radio" v-model="gender" value="female"> 女
            </label>
            <h2>性别: {{gender}}</h2>
        </div>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    gender: "female"
                }
            },
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

6、v-model绑定select

和checkbox一样，select也分单选和多选两种情况。

单选：只能选中一个值

v-model绑定的是一个值；
当我们选中option中的一个时，会将它对应的value赋值到fruit中；

多选：可以选中多个值

v-model绑定的是一个数组；
当选中多个值时，就会将选中的option对应的value添加到数组fruit中；

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <!-- select的单选 -->
        <select v-model="fruit">
            <option value="apple">苹果</option>
            <option value="orange">橘子</option>
            <option value="banana">香蕉</option>
        </select>
        <h2>单选: {{fruit}}</h2>
        <hr>

        <!-- select的多选 -->
        <select multiple size="3" v-model="fruits">
            <option value="apple">苹果</option>
            <option value="orange">橘子</option>
            <option value="banana">香蕉</option>
        </select>
        <h2>多选: {{fruits}}</h2>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    fruit: "orange", // 这里的默认值，就是单选框中默认选中的值
                    fruits: []
                }
            },
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

7、v-model的值绑定

目前我们在前面的案例中大部分的值都是在template中固定好的：

比如gender的两个输入框值male、female；
比如hobbies的三个输入框值basketball、football、tennis；

在真实开发中，我们的数据可能是来自服务器的，那么我们就可以先将值请求下来，绑定到data返回的对象中，再通过v-bind来进行值的绑定，这个过程就是值绑定。

这里不再给出具体的做法，因为还是v-bind的使用过程。

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <!-- 1.select的值绑定 -->
        <select multiple size="3" v-model="fruits">
            <option :key="item.value"
                    :value="item.value"
                    v-for="item in allFruits">
                {{item.text}}
            </option>
        </select>
        <h2>多选: {{fruits}}</h2>

        <hr>

        <!-- 2.checkbox的值绑定 -->
        <div class="hobbies">
            <h2>请选择你的爱好:</h2>
            <template :key="item.value" v-for="item in allHobbies">
                <label :for="item.value">
                    <input :id="item.value" :value="item.value" type="checkbox" v-model="hobbies"> {{item.text}}
                </label>
            </template>
            <h2>爱好: {{hobbies}}</h2>
        </div>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    // 水果
                    allFruits: [
                        {value: "apple", text: "苹果"},
                        {value: "orange", text: "橘子"},
                        {value: "banana", text: "香蕉"},
                    ],
                    fruits: [],

                    // 爱好
                    allHobbies: [
                        {value: "sing", text: "唱"},
                        {value: "jump", text: "跳"},
                        {value: "rap", text: "rap"},
                        {value: "basketball", text: "篮球"}
                    ],
                    hobbies: []
                }
            }
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>

8、v-model修饰符

8.1、lazy

lazy修饰符是什么作用呢？

默认情况下，v-model在进行双向绑定时，绑定的是input事件，那么会在每次内容输入后就将最新的值和绑定的属性进行同步；
如果我们在v-model后跟上lazy修饰符，那么会将绑定的事件切换为 change 事件，只有在提交时（比如回车）才会触发；

8.2、number

我们先来看一下v-model绑定后的值是什么类型的：

message总是string类型，即使在我们设置type为number也是string类型；

如果我们希望转换为数字类型，那么可以使用 .number 修饰符：

另外，在我们进行逻辑判断时，如果是一个string类型，在可以转化的情况下会进行隐式转换的：

下面的score在进行判断的过程中会进行隐式转化的；

8.3、trim

如果要自动过滤用户输入的守卫空白字符，可以给v-model添加 trim 修饰符：

8.4、示例

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Document</title>
</head>
<body>

    <div id="app">
        <!-- 1.lazy: 绑定change事件  -->
        <input type="text" v-model.lazy="message">
        <h2>message: {{message}}</h2>

        <hr>

        <!-- 2.number: 自动将内容转换成数字 -->
        <input type="text" v-model.number="counter">
        <h2>counter:{{counter}}-{{typeof counter}}</h2>

        <input type="number" v-model="counter2">
        <h2>counter2:{{counter2}}-{{typeof counter2}}</h2>

        <hr>

        <!-- 3.trim: 去除首尾的空格 -->
        <input type="text" v-model.trim="content">
        <h2>content: {{content}}</h2>

        <hr>

        <!-- 4.使用多个修饰符 -->
        <input type="text" v-model.lazy.trim="content">
        <h2>content: {{content}}</h2>
    </div>

    <script src="../lib/vue.js"></script>
    <script>
        // 1.创建app
        const app = Vue.createApp({
            // data: option api
            data() {
                return {
                    message: "Hello Vue",
                    counter: 0,
                    counter2: 0,
                    content: ""
                }
            },
            watch: {
                content(newValue) {
                    console.log("content:", newValue)
                }
            }
        })

        // 2.挂载app
        app.mount("#app")
    </script>
</body>
</html>