Продолжаем наш учебный курс по Vue, которые порекомендовала Наталья Теплухина, Staff Engineer в Gitlab и Core Team Member фреймворка Vue (Q/A сессия с Наташей прошла в нашем инстаграм, а расшифровку можно прочитать здесь)
На третьем уроке речь пойдёт об условном рендеринге. О том, как выводить что-либо на странице только в том случае, если выполняется какое-то условие.
→ Vue.js для начинающих, урок 1: экземпляр Vue
→ Vue.js для начинающих, урок 2: привязка атрибутов
Цель урока
Нам нужно, чтобы в карточке товара выводилась бы надпись, сообщающая посетителю о том, есть товар на складе, или нет. Если товар на складе есть, должна выводиться надпись In Stock
. Если его на складе нет — надпись Out of Stock
. Решение о выводе той или иной надписи должно приниматься на основе данных, хранящихся в приложении.
Начальный вариант кода
Вот код, с которого мы начнём работу. Он, как обычно, находится в файле index.html
, в теге <body>
:
<div id="app">
<div class="product">
<div class="product-image">
<img :src="image" />
</div>
<div class="product-info">
<h1>{{ product }}</h1>
</div>
</div>
</div>
В файле main.js
, при настройке экземпляра Vue, будет применяться следующий объект с данными:
data: {
product: "Socks",
image: "./assets/vmSocks-green.jpg",
inStock: true
}
Обратите внимание на то, что в объект data
добавлено новое свойство. Это — свойство inStock
, хранящее логическое значение true
.
Задача
При разработке веб-приложений часто бывает нужно, чтобы элемент отображался бы на странице в зависимости от выполнения некоего условия. Например, если запасы товара закончились, в карточке товара нужно об этом сообщить.
Соответствующие сообщения планируется оформить в качестве элементов <p>
. Это значит, что где-то в index.html
будут следующие элементы:
<p>In Stock</p>
<p>Out of Stock</p>
Наша задача заключается в том, чтобы вывести один из них в том случае, если товар на складе есть, а другой — в ситуации, когда товара на складе нет.
Решение задачи
В Vue решение этой задачи выглядит просто и понятно.
Как вы уже знаете, данные, указывающие на наличие или отсутствие товара на складе, описаны в main.js
, в объекте data
:
inStock: true
Для того чтобы указать системе на то, какой именно элемент <p>
нужно рендерить, мы можем воспользоваться директивами v-if
и v-else
. Это значит, что в index.html
попадёт следующее:
<p v-if="inStock">In Stock</p>
<p v-else>Out of Stock</p>
Если в inStock
содержится истинное значение, выведется первый элемент <p>
. В противном случае будет выведен второй элемент. В нашем случае в inStock
записано значение true
, поэтому выведется In Stock
.
На складе есть запасы товара
Замечательно! Только что мы воспользовались механизмом условного рендеринга для вывода сведений о товаре. Задачу мы решили. Но не будем останавливаться на достигнутом и продолжим исследование условного рендеринга.
Директива v-else-if
Наш механизм условного рендеринга, основанный на директивах v-if
и v-else
, можно расширить, добавив в него ещё один уровень логики. Сделать это можно с помощью директивы v-else-if
. Для того чтобы это продемонстрировать, давайте немного усложним наш пример.
Предположим, что в объекте data
, в main.js
, имеются сведения о количестве товара. Они хранятся в свойстве inventory
:
inventory: 100
Анализируя это свойство с помощью JavaScript-выражений, заключённых в кавычки, мы можем сообщать посетителям страницы более точные сведения о товаре:
<p v-if="inventory > 10">In stock</p>
<p v-else-if="inventory <= 10 && inventory > 0">Almost sold out!</p>
<p v-else>Out of stock</p>
В данной ситуации на страницу выведется первый элемент <p>
, так как соответствующее ему выражение оказывается истинным.
Директива v-show
Если некий элемент страницы нужно часто скрывать и отображать, это значит, что для реализации этого механизма имеет смысл взглянуть на директиву v-show
. Элемент с такой директивой всегда будет присутствовать в DOM, но видимым он будет только в том случае, если условие, переданное директиве, окажется истинным. Фактически, речь идёт о том, что, благодаря использованию этой директивы, к элементу, по условию, будет применяться CSS-свойство display: none
.
Этот метод отличается более высокой производительностью, чем управление элементами с использованием v-if
и v-else
.
Вот как выглядит применение этой директивы:
<p v-show="inStock">In Stock</p>
Тот вариант решения нашей задачи, в котором использовались директивы v-if
и v-else
, нас устраивает. Поэтому мы остановимся на нём и не будем ничего менять.
Практикум
Добавьте в объект с данными свойство onSale
. Оно должно использоваться для управления рендерингом элемента <span>
, выводящего текст On Sale
и сообщающего посетителям о распродаже.
Вот заготовка, которую вы можете использовать для решения этой задачи.
Вот решение задачи.
Итоги
Сегодня вы узнали об условном рендеринге с использованием механизмов Vue. А именно, речь шла о следующем:
- Существуют директивы Vue, позволяющие выводить элементы по условию:
- v-if
- v-else-if
- v-else
- v-show
- При работе с директивами можно пользоваться JavaScript-выражениями, передаваемыми им в кавычках.
- Если выражение, передаваемое директиве в кавычках, является истинным, элемент выводится.
- Директива
v-show
влияет только на видимость элемента, она не вставляет элементы в DOM и не удаляет элементы из DOM.
Есть ли у вас какая-то задача, которую вы, начав знакомство с Vue, уже планируете решить с помощью этого фреймворка?
→ Часть 1: Создание экземпляра Vue
→ Часть 2: Привязка атрибутов в Vue
Автор: ru_vds