Полное руководство по Angular @if
- 18 мая 2025
Одно из самых заметных нововведений в Angular — это встроенный синтаксис для управляющих конструкций, который появился в версии 17. Он решает одну из самых частых задач, с которой сталкивается каждый разработчик: показывать или скрывать элементы на странице в зависимости от условия. Раньше для этого использовали привычную структурную директиву *ngIf
. Теперь у нас есть более современная альтернатива — синтаксис @if
, часть нового подхода к управлению шаблоном.
В этом гайде мы сравним оба варианта, разберёмся, чем @if
лучше, и покажем, как можно перейти на него автоматически. Также поговорим об одной распространённой ошибке — о том, как не стоит использовать @if
вместе с пайпом async
.

Содержание
В этом материале разбираем:
- Зачем понадобился новый синтаксис управляющих конструкций
- Что такое
@if
в Angular - Как работает синтаксис
@if
- Как использовать
@if
вместе сelse
- Как использовать
@if
,else if
иelse
- Почему
@if
не нужно импортировать - Почему больше не нужен синтаксис со звёздочкой (*)
- Почему
@if
лучше, чем*ngIf
- Как просто перейти на новый синтаксис @if
- Чем
@if
отличается от скрытия элементов через CSS - Распространённый антипаттерн: вложенные
@if
с пайпом async - Краткое резюме
Зачем нужен новый синтаксис управляющих конструкций?
Как объясняет Минко Гечев в посте, где впервые представили @if, новый встроенный синтаксис управления потоком исполнения даёт сразу несколько преимуществ:
- Более лаконичный и удобный синтаксис, ближе к JavaScript, — выглядит интуитивно и требует меньше обращений к документации.
- Конструкции вроде
@if
сразу доступны в шаблоне — ничего импортировать не нужно. - Улучшенная проверка типов за счёт более точного сужения типов.
- Этот синтаксис работает на этапе сборки, а не в рантайме, что снижает нагрузку и помогает уменьшить размер бандла, а заодно улучшить Core Web Vitals.
- Кроме того, новая система управления потоком в шаблоне упростит внедрение реактивного подхода на основе signal-ов в будущем.
Подробнее о @if и новом синтаксисе шаблонов можно почитать в официальной документации: Angular Control Flow.
Что такое @if в Angular?
@if
для Angular — это то же самое, что обычный if
для JavaScript.
Это новый синтаксис шаблонов, с помощью которого можно условно отображать элементы в шаблоне Angular. Он встроен в сам фреймворк и позволяет показывать или скрывать части интерфейса в зависимости от логического условия.
В отличие от привычной структурной директивы *ngIf
, @if
не требует импорта даже в standalone-компонентах — он доступен по умолчанию.
Синтаксис стал короче и понятнее, а ещё поддерживает конструкции else if
и else
, чего раньше в *ngIf
не было.
Давайте разберёмся, как он работает.
Синтаксис @if
Вот простой пример, показывающий, как использовать новый синтаксис:
@Component({
template: `
@if (showHello) {
<h2>Hello</h2>
}
`,
})
class Test {
showHello: boolean = true;
}
Код выше отобразит заголовок Hello
только в том случае, если значение свойства showHello
— true
.
Видите, насколько этот синтаксис похож на обычный if
в JavaScript?
if (showHello) {
return `<h2>Hello</h2>`;
}
Почти один в один!
Синтаксис @if с else
В отличие от старого *ngIf
, новый синтаксис @if
поддерживает конструкцию else
.
Посмотрим на пример:
@Component({
template: `
@if (showHello) {
<h2>Hello</h2>
}
@else {
<h2>Goodbye</h2>
}
`,
})
class Test {
showHello: boolean = true;
}
Код выше работает так:
- Элемент
<h2>Hello</h2>
отображается, если свойствоshowHello
—true
. - Элемент
<h2>Goodbye</h2>
отображается, еслиshowHello
—false
.
Визуально это очень похоже на конструкцию if-else
в JavaScript — читается просто и интуитивно.
Синтаксис @if else if else
И это ещё не всё. Angular теперь поддерживает и конструкции else if
. Раньше с *ngIf
так сделать было нельзя — приходилось выкручиваться с дополнительными переменными или вложенными блоками.
@Component({
template: `
@if (showHello) {
<h2>Hello</h2>
}
@else if (showGoodbye) {
<h2>Goodbye</h2>
}
@else {
<h2>See you later</h2>
}
`,
})
class Test {
showHello: boolean = true;
showGoodbye: boolean = false;
}
Код выше работает следующим образом:
- Показывает заголовок
<h2>Hello</h2>
, еслиshowHello
—true
. - Если
showHello
—false
, ноshowGoodbye
—true
, отображается<h2>Goodbye</h2>
. - Если оба условия ложны, выводится
<h2>See you later</h2>
.
Согласитесь, это почти дословно повторяет логику обычного if
/ else if
/ else
в JavaScript — просто, понятно и без лишнего кода.
Почему @if больше не нужно импортировать?
Обратите внимание, что теперь нам не нужно импортировать директиву @if
из @angular/common
в шаблоны компонентов. Это потому, что @if
— не директива. Это часть движка Angular.
Новый синтаксис встроен прямо в ядро шаблонизатора, и поэтому доступен «из коробки» в любом шаблоне. Он работает так же, как интерполяция {{variable}}
или синтаксис i18n
— ничего дополнительно подключать не нужно.
Почему теперь не нужен синтаксис со звёздочкой (*)?
Раньше *
использовалась только потому, что ngIf
была структурной директивой. Эта звёздочка — просто синтаксический сахар, который упрощал работу с такими директивами.
А с @if
всё иначе: он не является структурной директивой, поэтому в звёздочке больше нет необходимости.
Почему @if лучше, чем *ngIf?
Кратко подведём итоги, чем @if
выигрывает у *ngIf
:
- Короче и понятнее
- Не требует импортов
- Поддерживает
else if
иelse
- Не даёт лишней нагрузки в рантайме
- Подготавливает почву для будущего развития Angular (например, signal-ов)
Как просто перейти на новый синтаксис @if
Если вы используете более старые версии Angular, можно перейти на новый синтаксис @if
с помощью Angular CLI.
В Angular CLI есть автоматическая миграция, которая обновит весь ваш код до нового синтаксиса @if
:
ng generate @angular/core:control-flow
Эта команда заменит все директивы *ngIf
в вашем проекте на новый синтаксис — и не только на @if
, но также на @for
и @switch
.
Чем @if отличается от скрытия элементов с помощью обычного CSS
В HTML мы можем скрывать элементы, управляя свойствами display
и visibility
:
- если установить
display: none
, элемент не отображается в документе; - если установить
visibility: hidden
, элемент не виден.
На первый взгляд результат один и тот же, но на самом деле это не так.
В обоих случаях скрытый элемент всё ещё существует в DOM, тогда как с @if
— нет: элемент вообще не попадает в DOM.
Антипаттерн с несколькими вложенными @if и пайпом async
Помните, в начале мы упоминали антипаттерн, связанный с @if
?
Если вы используете RxJS в своём коде, это важно, потому что такая ошибка встречается часто и напрямую касается @if
.
Речь идёт об использовании @if
не для отображения или скрытия элементов, а просто для получения значения из Observable
с помощью пайпа async
. Этот антипаттерн иногда называют «цепочкой async pipe» или «пирамидой ужаса».
Пример антипаттерна:
@if (user$ | async; as user) {
....
@if (course$ | async; as course) {
....
@if (lessons$ | async; as lesson) {
....
}
}
}
Как видно, мы используем async
для распаковки значений разных Observable
и сохраняем их в локальные переменные шаблона.
Затем эти переменные передаются в следующий @if.
Мы повторяем @if
и async
на нескольких уровнях страницы только ради доступа к данным — и больше ни для чего. Эта практика усложняет чтение и поддержку кода при большом количестве вложенностей. Кроме того, она усложняет рефакторинг, особенно если такая логика используется в нескольких местах на странице.
Хороший способ избежать этого — изменить компонент так, чтобы он предоставлял один data$ Observable
, содержащий все нужные данные.
Начнём с описания интерфейса:
interface PageData {
user: User;
course: Course;
lessons: Lesson[];
}
Затем создадим общий Observable
:
@Component({...})
export class Component implements OnInit {
private data$: Observable<PageData>;
ngOnInit() {
const user$ = // ... инициализация user$ Observable
const course$ = // ... инициализация course$ Observable
const lessons$ = // ... инициализация lessons$ Observable
this.data$ = combineLatest([user$, course$, lessons$])
.pipe(
map(([user, course, lessons]) => {
return {
user,
course,
lessons
}
})
);
}
}
Оператор combineLatest
— это один из способов объединить Observable
.
Наконец, используем @if
с async
в шаблоне:
@if (data$ | async; as data) {
....
{{data.course}}
{{data.user}}
{{data.lessons}}
}
Как видно, это избавляет от ненужных вложенных @if
и делает код гораздо более читаемым и поддерживаемым. Если применить такую структуру в начале шаблона, все нужные данные будут доступны в любом месте.
В этом гайде мы рассмотрели новый синтаксис @if
в Angular. Мы увидели, что он более лаконичный и читаемый, не требует импортов и поддерживает конструкции else if
и else
, чего не было в прежнем синтаксисе с *ngIf
.
С @if
нам больше не нужна директива NgIf
, как и странный местами синтаксис со звёздочкой (*), используемый для структурных директив.
Синтаксис @if
— мощное и удобное дополнение к инструментам Angular. Попробуйте его в деле!
«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.
Читать дальше

FormControl и FormGroup в Angular
Если вы разрабатываете веб-приложение, вам рано или поздно придётся собирать данные от пользователя. К счастью, реактивные формы в Angular позволяют делать это без лишней сложности — без нагромождения директив и с минимальным количеством шаблонного кода. Более того, их просто валидировать, так что можно обойтись даже без end-to-end тестов.
Говоря проще, form control’ы в Angular дают полный контроль разработчику — ничего не происходит автоматически, и каждое решение по вводу и управлению принимается явно и осознанно. В этом руководстве мы покажем, как объединять form control’ы в form group’ы, чтобы структурировать форму и упростить доступ к её элементам — как к логическим блокам. Чтобы лучше понять, как работают form group’ы в Angular, мы шаг за шагом соберём реактивную форму.
Для работы с примером скачайте стартовый проект с GitHub и откройте его в VS Code. Если ещё не обновляли Angular, поставьте актуальную на момент написания версию — Angular v18.
- 1 июня 2025

AOT против JIT-компилятора: что лучше для разработки на Angular?
Angular — один из самых популярных фреймворков для фронтенда — предлагает два подхода к компиляции: предварительная компиляция и динамическая компиляция во время выполнения. Оба метода играют важную роль в оптимизации приложений на Angular и повышении их производительности. В этом материале мы рассмотрим различия между ними, их преимущества и разберёмся, когда стоит использовать каждый из подходов.
- 25 мая 2025

Динамические формы в Angular 19: пошаговое руководство
Формы — неотъемлемая часть большинства веб-приложений: будь то регистрация, ввод данных или опросы. Модуль реактивных форм в Angular отлично подходит для создания статичных форм, но во многих случаях требуется, чтобы форма могла динамически адаптироваться в зависимости от действий пользователя или внешних данных.
В этой статье мы рассмотрим, как создавать динамические формы с использованием автономных компонентов в Angular 19, применяя модульный подход, который избавляет от необходимости использовать традиционные модули Angular. В сопроводительном репозитории на GitHub для оформления форм используется Tailwind CSS, однако в статье внимание сосредоточено исключительно на логике динамических форм. Tailwind и связанные с ним настройки намеренно не включены в примеры, чтобы сохранить акцент на основной теме.
- 25 мая 2025

Как обнаружить изменения в Angular: пошаговая инструкция
Как разработчики на Angular, мы нередко задумываемся, как фреймворк отслеживает изменения в данных и затем отображает их во вьюхе. Этот процесс называется стратегией обнаружения изменений в Angular. В этом материале мы разберёмся, как это работает, и научимся выбирать подходящую стратегию для разных сценариев.
- 24 мая 2025

Компоненты в Angular 18: пошаговое руководство
Angular развивается стремительно, и с выходом версии 18 появились новые возможности, которые разработчики могут использовать в своей работе. Одним из ключевых изменений в Angular 18 стало удаление традиционного файла app.module.ts — ему на смену пришли standalone-компоненты. Если вы только начинаете работать с Angular или переходите с более ранней версии, это пошаговое руководство поможет вам разобраться в базовых принципах компонентов в Angular 18. Независимо от вашего уровня — новичок вы или опытный разработчик — этот туториал покажет, как создавать, управлять и эффективно использовать компоненты в Angular.
- 19 мая 2025

Модули Angular для организации кода и ленивой загрузки
Модули — один из ключевых инструментов Angular для построения масштабируемых и поддерживаемых приложений. В этой статье мы подробно рассмотрим:
- что такое модули в Angular;
- зачем они нужны;
- как их использовать для структурирования кода;
- как реализовать «ленивую» загрузку модулей;
- и чем отличаются Feature, Core и Shared модули.
Если вы только начинаете изучать Angular или хотите углубить свои знания, эта статья поможет вам лучше понять, как правильно организовать архитектуру Angular-приложения.
- 12 мая 2025

Навигация в Angular: RouterLink, Router.navigate и Router.navigateByUrl
Директива RouterLink
позволяет настраивать переходы между маршрутами прямо в шаблоне Angular. А методы Router.navigate
и Router.navigateByUrl
, доступные в классе Router
, дают возможность управлять навигацией программно — прямо из кода компонентов.
Разберёмся, как работают RouterLink
, Router.navigate
и Router.navigateByUrl
.
- 11 мая 2025

Полное руководство по Lazy Loading в Angular
Если вы создаёте большое Angular-приложение, вам наверняка важно, чтобы оно загружалось быстро. Представьте, что вы устраиваете вечеринку и хотите подавать закуски не сразу, а по мере прихода гостей, чтобы не перегрузить кухню. «Ленивая» загрузка в Angular работает примерно так же: вместо того чтобы загружать всё приложение целиком сразу, вы подгружаете только те части, которые нужны — и только когда они нужны.
В этом пошаговом руководстве мы разберём, как реализовать lazy loading в Angular.
- 10 мая 2025

Все (ну или почти все) способы автоматически перезагрузить страницу раз в N секунд
Иногда страницу нужно просто перезагрузить. Полностью. Не компонент, не блок, а именно целиком. Без обсуждений, без лишней логики. Например, чтобы:
- экран с результатами обновлялся каждые 10 секунд;
- интерфейс на стенде показывал последние данные без кнопок;
- страницы в интранете не устаревали, пока никто не смотрит.
Это можно сделать в любой связке: HTML, JS, Python, PHP, Go, Node.js — не важно. Ну и если говорить совсем прямо, то совсем разных способов всего три, а остальное просто вариации.
- 5 мая 2025

Поиск с конца массива в JavaScript: findLast и findLastIndex в JavaScript
С недавних пор в JavaScript появились два полезных метода для массивов: findLast
и findLastIndex
. Они делают то же, что и привычные find
и findIndex
, только проходят массив с конца.
- 5 мая 2025