Одно из самых заметных нововведений в 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

FormControl и FormGroup в Angular

Если вы разрабатываете веб-приложение, вам рано или поздно придётся собирать данные от пользователя. К счастью, реактивные формы в Angular позволяют делать это без лишней сложности — без нагромождения директив и с минимальным количеством шаблонного кода. Более того, их просто валидировать, так что можно обойтись даже без end-to-end тестов.

Говоря проще, form control’ы в Angular дают полный контроль разработчику — ничего не происходит автоматически, и каждое решение по вводу и управлению принимается явно и осознанно. В этом руководстве мы покажем, как объединять form control’ы в form group’ы, чтобы структурировать форму и упростить доступ к её элементам — как к логическим блокам. Чтобы лучше понять, как работают form group’ы в Angular, мы шаг за шагом соберём реактивную форму.

Для работы с примером скачайте стартовый проект с GitHub и откройте его в VS Code. Если ещё не обновляли Angular, поставьте актуальную на момент написания версию — Angular v18.

Читать дальше
JS
  • 1 июня 2025
AOT против JIT-компилятора: что лучше для разработки на Angular?

AOT против JIT-компилятора: что лучше для разработки на Angular?

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

Читать дальше
JS
  • 25 мая 2025
Динамические формы в Angular 19: пошаговое руководство

Динамические формы в Angular 19: пошаговое руководство

Формы — неотъемлемая часть большинства веб-приложений: будь то регистрация, ввод данных или опросы. Модуль реактивных форм в Angular отлично подходит для создания статичных форм, но во многих случаях требуется, чтобы форма могла динамически адаптироваться в зависимости от действий пользователя или внешних данных.

В этой статье мы рассмотрим, как создавать динамические формы с использованием автономных компонентов в Angular 19, применяя модульный подход, который избавляет от необходимости использовать традиционные модули Angular. В сопроводительном репозитории на GitHub для оформления форм используется Tailwind CSS, однако в статье внимание сосредоточено исключительно на логике динамических форм. Tailwind и связанные с ним настройки намеренно не включены в примеры, чтобы сохранить акцент на основной теме.

Читать дальше
JS
  • 25 мая 2025
Как обнаружить изменения в Angular: пошаговая инструкция

Как обнаружить изменения в Angular: пошаговая инструкция

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

Читать дальше
JS
  • 24 мая 2025
Компоненты в Angular 18: пошаговое руководство

Компоненты в Angular 18: пошаговое руководство

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

Читать дальше
JS
  • 19 мая 2025
Модули Angular для организации кода и ленивой загрузки

Модули Angular для организации кода и ленивой загрузки

Модули — один из ключевых инструментов Angular для построения масштабируемых и поддерживаемых приложений. В этой статье мы подробно рассмотрим:

  • что такое модули в Angular;
  • зачем они нужны;
  • как их использовать для структурирования кода;
  • как реализовать «ленивую» загрузку модулей;
  • и чем отличаются Feature, Core и Shared модули.

Если вы только начинаете изучать Angular или хотите углубить свои знания, эта статья поможет вам лучше понять, как правильно организовать архитектуру Angular-приложения.

Читать дальше
JS
  • 12 мая 2025
Навигация в Angular: RouterLink, Router.navigate и Router.navigateByUrl

Навигация в Angular: RouterLink, Router.navigate и Router.navigateByUrl

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

Разберёмся, как работают RouterLink, Router.navigate и Router.navigateByUrl.

Читать дальше
JS
  • 11 мая 2025
Полное руководство по Lazy Loading в Angular

Полное руководство по Lazy Loading в Angular

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

В этом пошаговом руководстве мы разберём, как реализовать lazy loading в Angular.

Читать дальше
JS
  • 10 мая 2025
Все (ну или почти все) способы автоматически перезагрузить страницу раз в N секунд

Все (ну или почти все) способы автоматически перезагрузить страницу раз в N секунд

Иногда страницу нужно просто перезагрузить. Полностью. Не компонент, не блок, а именно целиком. Без обсуждений, без лишней логики. Например, чтобы:

  • экран с результатами обновлялся каждые 10 секунд;
  • интерфейс на стенде показывал последние данные без кнопок;
  • страницы в интранете не устаревали, пока никто не смотрит.

Это можно сделать в любой связке: HTML, JS, Python, PHP, Go, Node.js — не важно. Ну и если говорить совсем прямо, то совсем разных способов всего три, а остальное просто вариации.

Читать дальше
JS
  • 5 мая 2025