Формы Vue3

В этом разделе мы рассмотрим применение форм Vue.

Мы можем использовать директиву v-model в элементах формы,<input>、<textarea>и<select>чтобы создать двустороннюю привязку данных.

v-model автоматически выбирает правильный способ обновления элементов в зависимости от типа элемента управления.

v-model игнорирует начальные значения атрибутов value, checked и selected всех элементов формы и вместо этого использует начальные значения, объявленные в опции data.

Внутри v-model использует разные свойства и генерирует разные события для разных элементов ввода:

  • элементы text и textarea используютvalueсвойство иinputсобытие;
  • checkbox и radio используютcheckedсвойство иchangeсобытие;
  • поля select будутvalueиспользовать как свойство иchangeкак событие.

Ввод

В примере показано использование v-model для реализации двусторонней привязки данных к элементам input и textarea:

<div id="app"> <p>элемент input:</p> <input v-model="message" placeholder="Отредактируйте меня..."> <p>Сообщение из формы input: {{ message }}</p> <p>элемент textarea:</p> <textarea v-model="message2" placeholder="Многострочный ввод текста..."></textarea> <p>Сообщение из формы textarea:</p> <p style="white-space: pre">{{ message2 }}</p> </div> <script>const app = { data() { return { message: '', message2: 'Example\r\nhttps://www.example.com' } } } Vue.createApp(app).mount('#app')</script>

Попробуйте сами »
Интерполяция не работает в элементе textarea; вместо этого нужно использовать v-model:
<!-- 错误 -->
<textarea>{{ text }}</textarea>

<!-- 正确 -->
<textarea v-model="text"></textarea>

Флажок

Если флажок один, это логическое значение; если несколько, они привязываются к одному и тому же массиву:

Флажок

В следующем примере демонстрируется двусторонняя привязка данных флажков:

<div id="app"> <p>Одиночный флажок:</p> <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> <p>Несколько флажков:</p> <input type="checkbox" id="example" value="Пример" v-model="checkedNames"> <label for="example">Пример</label> <input type="checkbox" id="google" value="Google" v-model="checkedNames"> <label for="google">Google</label> <input type="checkbox" id="taobao" value="Taobao" v-model="checkedNames"> <label for="taobao">taobao</label> <br> <span>Выбранное значение: {{ checkedNames }}</span> </div> <script> const app = { data() { return { checked : false, checkedNames: [] } } } Vue.createApp(app).mount('#app') </script>

Попробуйте сами »

Результат установки флажков в примере показан ниже:

Радиокнопки

В следующем примере показана двусторонняя привязка данных радиокнопок:

Радиокнопки

<div id="app"> <input type="radio" id="example" value="Example" v-model="picked"> <label for="example">Example</label> <br> <input type="radio" id="google" value="Google" v-model="picked"> <label for="google">Google</label> <br> <span>Выбранное значение: {{ picked }}</span> </div> <script> const app = { data() { return { picked : 'Example' } } } Vue.createApp(app).mount('#app') </script>

Попробуйте сами »

После выбора эффект показан ниже:

Выпадающий список

Следующий пример демонстрирует двустороннюю привязку данных выпадающего списка:

select

<div id="app"> <select v-model="selected" name="site"> <option value="">Выберите сайт</option> <option value="www.example.com">Example</option> <option value="www.google.com">Google</option> </select> <div id="output">Выбранный веб-сайт: {{selected}}</div> </div> <script> const app = { data() { return { selected: '' } } } Vue.createApp(app).mount('#app') </script>

Попробуйте сами »

Выберите Example, результат показан ниже:

Когда включён множественный выбор, он привязывается к массиву:

select

<div id="app"> <select v-model="selected" name="fruit" multiple> <option value="www.example.com">Example</option> <option value="www.google.com">Google</option> <option value="www.taobao.com">Taobao</option> </select> <div id="output">Выбранные сайты: {{selected}}</div> </div> <script> const app = { data() { return { selected: '' } } } Vue.createApp(app).mount('#app') </script>

Попробуйте сами »

Выберите Example и Google:

Используйтеv-forцикл для вывода опций:

select

<div id="app" class="demo"> <select v-model="selected"> <option v-for="option in options" :value="option.value"> {{ option.text }} </option> </select> <span>Выбрано: {{ selected }}</span> </div> <script> const app = { data() { return { selected: 'www.example.com', options: [ { text: 'Example', value: 'www.example.com' }, { text: 'Google', value: 'www.google.com' }, { text: 'Taobao', value: 'www.taobao.com' } ] } } } Vue.createApp(app).mount('#app') </script>

Попробуйте сами »

Пример с select:

Привязка значения

Для радиокнопок, флажков и опций select значение, привязанное с помощью v-model, обычно является статической строкой (для флажков оно также может быть логическим):

<!-- При выборе `picked` — это строка "a" -->
<input type="radio" v-model="picked" value="a" />

<!-- `toggle` — true или false -->
<input type="checkbox" v-model="toggle" />

<!-- Когда выбрана первая опция, `selected` — строка "abc" -->
<select v-model="selected">
  <option value="abc">ABC</option>
</select>

Но иногда мы можем захотеть привязать значение к динамическому свойству текущего активного экземпляра. В этом случае можно использовать v-bind. Кроме того, v-bind может привязывать значения input к нестроковым значениям.

Флажок:

<input type="checkbox" v-model="toggle" true-value="yes" false-value="no" />
...
// 选中时
vm.toggle === 'yes'
// 取消选中 
vm.toggle === 'no'

Радиокнопка:

<input type="radio" v-model="pick" v-bind:value="a" />
// 当选中时
vm.pick === vm.a

Выбор опции:

<select v-model="selected">
  <!-- 内联对象字面量 -->
  <option :value="{ number: 123 }">123</option>
</select>
// 当被选中时
typeof vm.selected // => 'object'
vm.selected.number // => 123

Модификаторы

.lazy

По умолчанию v-model синхронизирует значение input с данными при событии input, но вы можете добавить модификатор lazy, чтобы вместо этого синхронизировать при событии change:

<!-- 在 "change" 而不是 "input" 事件中更新 -->
<input v-model.lazy="msg" >

.число

Если вы хотите автоматически преобразовать введённое пользователем значение в тип Number (если результатом преобразования исходного значения является NaN, возвращается исходное значение), вы можете добавить модификатор number к v-model для обработки значения input:

<input v-model.number="age" type="number">

Это часто полезно, потому что при type="number" значение, введённое в HTML, всегда возвращается как строковый тип.

.trim

Если вы хотите автоматически отфильтровывать начальные и конечные пробелы во вводе пользователя, вы можете добавить модификатор trim к v-model для фильтрации ввода:

<input v-model.trim="msg">
Другие расширения