5. 基础-模版引用 & 基础-表单输入绑定

模版引用

虽然 Vue 的声明性渲染模型为你抽象了大部分对 DOM 的直接操作,但在某些情况下,我们仍然需要直接访问底层 DOM 元素。
使用原生 js 访问

<script>
export default {
  data() {
    return {
      message: "你好",
    };
  },
  methods: {
    doSubmit() {
      var username = document.querySelector("#username");
      alert(username.value);
    },
  },
};
</script>

<template>
  <h2>人员登记系统</h2>
  <div class="people_list">
    <ul>
      <li>姓名:<input type="text" id="username" /></li>
    </ul>
    <button @click="doSubmit()" class="submit">获取表单的内容</button>
  </div>
</template>

我们也可以使用特殊的 ref attribute

<script>
  export default {
    data() {
        return {
            message: "你好",
        };
    },
    methods: {
        doSubmit() {
            var username = document.querySelector("#username");
            alert(username.value);

            var ageDom = this.$refs.age;
            alert(ageDom.value);
        },
    },
  };
</script>

<template>
  <div>
    <h2>人员登记系统</h2>

    <div class="people_list">
        <ul>
            <li>姓名:<input type="text" id="username" /></li>
            <li>年龄:<input type="text" ref="age" /></li>
        </ul>
        <button @click="doSubmit()" class="submit">获取表单的内容</button>
    </div>
  </div>
</template>

ref 是一个特殊的 attribute ,和 v-for 章节中提到的 key 类似。它允许我们在一个特定的 DOM 元素或子组件实例被挂载后,获得对它的直接引用

<template>
  <input ref="input">
</template>

这可能很有用,比如说在组件挂载时将焦点设置到一个 input 元素上,或在一个元素上初始化一个第三方库。

访问模板引用

挂载结束后引用都会被暴露在 this.$refs 之上:

<script>
export default {
  mounted() {
    this.$refs.input.focus()
  }
}
</script>

<template>
  <input ref="input" />
</template>

注意,你只可以在组件挂载后才能访问模板引用。如果你想在模板中的表达式上访问 $refs.input ,在初次渲染时会是 null 。这是因为在初次渲染前这个元素还不存在呢!

v-for 中的模板引用

需要 v3.2.25 及以上版本

当在 v-for 中使用模板引用时,相应的引用中包含的值是一个数组

<script>
export default {
  data() {
    return {
      list: [
        /* ... */
      ]
    }
  },
  mounted() {
    console.log(this.$refs.items)
  }
}
</script>

<template>
  <ul>
    <li v-for="item in list" ref="items">
      {{ item }}
    </li>
  </ul>
</template>

应该注意的是,ref 数组并不保证与源数组相同的顺序。

函数模板引用

除了使用字符串值作名字,ref attribute 还可以绑定为一个函数,会在每次组件更新时都被调用。该函数会收到元素引用作为其第一个参数

<template>
  <input :ref="(el) => { /* 将 el 赋值给一个数据属性或 ref 变量 */ }">
</template>

注意我们这里需要使用动态的 :ref 绑定才能够传入一个函数。当绑定的元素被卸载时,函数也会被调用一次,此时的 el 参数会是 null。你当然也可以绑定一个组件方法而不是内联函数。

组件上的 ref

模板引用也可以被用在一个子组件上。这种情况下引用中获得的值是组件实例

<script>
import Child from './Child.vue'

export default {
  components: {
    Child
  },
  mounted() {
    // this.$refs.child 是 <Child /> 组件的实例
  }
}
</script>

<template>
  <Child ref="child" />
</template>

如果一个子组件使用的是选项式 API ,被引用的组件实例和该子组件的 this 完全一致,这意味着父组件对子组件的每一个属性和方法都有完全的访问权。这使得在父组件和子组件之间创建紧密耦合的实现细节变得很容易,当然也因此,应该只在绝对需要时才使用组件引用。大多数情况下,你应该首先使用标准的 props 和 emit 接口来实现父子组件交互。
expose 选项可以用于限制对子组件实例的访问:

export default {
  expose: ['publicData', 'publicMethod'],
  data() {
    return {
      publicData: 'foo',
      privateData: 'bar'
    }
  },
  methods: {
    publicMethod() {
      /* ... */
    },
    privateMethod() {
      /* ... */
    }
  }
}

在上面这个例子中,父组件通过模板引用访问到子组件实例后,仅能访问 publicData 和 publicMethod 。

表单输入绑定

在前端处理表单时,我们常常需要将表单输入框的内容同步给 JavaScript 中相应的变量。手动连接值绑定和更改事件监听器可能会很麻烦

<template>
  <input
  :value="text"
  @input="event => text = event.target.value">
</template>

v-model 指令帮我们简化了这一步骤

<template>
  <input v-model="text">
</template>

另外,v-model 还可以用于各种不同类型的输入,<textarea> 、<select> 元素。它会根据所使用的元素自动使用对应的 DOM 属性和事件组合:

  • 文本类型的 <input> 和 <textarea> 元素会绑定 value property 并侦听 input 事件
  • <input type="checkbox"> 和 <input type="radio"> 会绑定 checked property 并侦听 change 事件
  • <select> 会绑定 value property 并侦听 change 事件

注意
v-model 会忽略任何表单元素上初始的 value、checked 或 selected attribute。它将始终将当前绑定的 JavaScript 状态视为数据的正确来源。你应该在 JavaScript 中使用 data 选项来声明该初始值。

示例

<script>
  export default {
    data() {
      return {
        peopleInfo: {
          username: "",
          age: "",
        },
      };
    },
    methods: {
      doSubmit() {
        console.log(this.peopleInfo);
      },
    },
  };
</script>

<template>
  <h2>人员登记系统</h2>

  <div class="people_list">
    <ul>
      <li>姓名:<input type="text" v-model="peopleInfo.username" /></li>
      <li>年龄:<input type="text" v-model="peopleInfo.age" /></li>
    </ul>
    <button @click="doSubmit()" class="submit">获取表单的内容</button>
  </div>
</template>

基本用法

文本

多行文本

复选框

单选按钮

选择器

示例

<script>
  export default {
    data() {
      return {
        peopleInfo: {
          username: "",
          age: "",
          sex: "2",
          cityList: ["北京", "上海", "深圳"],
          city: "上海",
          hobby: [{
              title: "吃饭",
              checked: false,
            },
            {
              title: "睡觉",
              checked: false,
            },
            {
              title: "敲代码",
              checked: true,
            },
          ],
          mark: "",
        },
      };
    },
    methods: {
      doSubmit() {
        console.log(this.peopleInfo);
      },
    },
    mounted() {
      window.obb = this
    }
  };
</script>

<template>
  <h2>人员登记系统</h2>

  <div class="people_list">
      <ul>
          <li>姓 名:<input type="text" v-model="peopleInfo.username" /></li>
          <li>年 龄:<input type="text" v-model="peopleInfo.age" /></li>
          <li>性 别:</li>
          <input type="radio" id="sex1" value="1" v-model="peopleInfo.sex" /><label for="sex1">男</label>
          <input type="radio" id="sex2" value="2" v-model="peopleInfo.sex" /><label for="sex2">女</label>
          <li>
              城 市:
              <select name="city" id="city" v-model="peopleInfo.city">
                  <option v-for="(item, index) in peopleInfo.cityList" :key="index" :value="item">
                      {{ item }}
                  </option>
              </select>
          </li>
          <li>
              爱 好:
              <span v-for="(item, index) in peopleInfo.hobby" :key="index">
                  <input type="checkbox" :id="'check' + index" v-model="item.checked" />
                  <label :for="'check' + index"> {{ item.title }}</label>
                  &nbsp;&nbsp;
              </span>
          </li>
          <li>
              备 注:
              <textarea name="mark" id="mark" cols="30" rows="4" v-model="peopleInfo.mark"></textarea>
          </li>
      </ul>

      <button @click="doSubmit()" class="submit">获取表单的内容</button>
  </div>
</template>

<style>
  ul {
    list-style-type: none;
  }

  h2 {
    text-align: center;
  }

  .people_list {
    width: 400px;
    margin: 40px auto;
    padding: 40px;
    border: 1px solid #eee;
  }

  .people_list li {
    height: 50px;
    line-height: 50px;
  }

  .form_input {
    width: 300px;
    height: 28px;
  }

  .submit {
    float: right;
    margin-top: 10px;
  }
</style>
posted @ 2023-07-22 21:22  HopeLive  阅读(22)  评论(0)    收藏  举报