Deliver web apps with confidence 🚀
Find a file
JoostK 243ccce624 fix(core): exclude class attribute intended for projection matching from directive matching (#54800)
This commit resolves a regression that was introduced when the compiler switched from
`TemplateDefinitionBuilder` (TDB) to the template pipeline (TP) compiler. The TP compiler
has changed the output of

```html
if (false) { <div class="test"></div> }
```

from

```ts
defineComponent({
  consts: [['class', 'test'], [AttributeMarker.Classes, 'test']],
  template: function(rf) {
    if (rf & 1) {
      ɵɵtemplate(0, App_Conditional_0_Template, 2, 0, "div", 0)
    }
  }
});
```

to

```ts
defineComponent({
  consts: [[AttributeMarker.Classes, 'test']],
  template: function(rf) {
    if (rf & 1) {
      ɵɵtemplate(0, App_Conditional_0_Template, 2, 0, "div", 0)
    }
  }
});
```

The last argument to the `ɵɵtemplate` instruction (0 in both compilation outputs) corresponds with
the index in `consts` of the element's attribute's, and we observe how TP has allocated only a single
attribute array for the `div`, where there used to be two `consts` entries with TDB. Consequently,
the `ɵɵtemplate` instruction is now effectively referencing a different attributes array, where the
distinction between the `"class"` attribute vs. the `AttributeMarker.Classes` distinction affects
the behavior: TP's emit causes the runtime to incorrectly match a directive with `selector: '.foo'` to
be instantiated on the `ɵɵtemplate` instruction as if it corresponds with a structural directive!

Instead of changing TP to align with TDB's emit, this commit updates the runtime instead. This uncovered
an inconsistency in selector matching for class names, where there used to be two paths dealing with
class matching:

1. The first check was commented to be a special-case for class matching, implemented in `isCssClassMatching`.
2. The second path was part of the main selector matching algorithm, where `findAttrIndexInNode` was being used
   to find the start position in `tNode.attrs` to match the selector's value against.

The second path only considers `AttributeMarker.Classes` values if matching for content projection, OR of the
`TNode` is not an inline template. The special-case in path 1 however does not make that distinction, so it
would consider the `AttributeMarker.Classes` binding as a selector match, incorrectly causing a directive to
match on the `ɵɵtemplate` itself.

The second path was also buggy for class bindings, as the return value of `classIndexOf` was incorrectly
negated: it considered a matching class attribute as non-matching and vice-versa. This bug was not observable
because of another issue, where the class-handling in part 2 was never relevant because of the special-case
in part 1.

This commit separates path 1 entirely from path 2 and removes the buggy class-matching logic in part 2, as
that is entirely handled by path 1 anyway. `isCssClassMatching` is updated to exclude class bindings from
being matched for inline templates.

Fixes #54798

PR Close #54800
2024-03-12 14:05:18 -07:00
.circleci ci: migrate snapshot publishing from CircleCI to GHA (#51957) 2023-10-05 10:53:22 -07:00
.devcontainer build: upgrade node version for .devcontainer example file (#53157) 2023-11-27 15:49:35 +01:00
.github build: update scorecard action dependencies (#54407) 2024-02-26 18:29:36 -08:00
.husky build: simplify husky setup (#54315) 2024-02-07 16:34:13 +00:00
.ng-dev ci: Add primitives configurations for ng-dev tools (#54662) 2024-03-04 17:41:17 +01:00
.vscode docs: minor update to modify the Bazel extension url (#51925) 2023-09-27 09:21:33 -07:00
.yarn build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
adev docs: fix missing security guide in navigation (#54830) 2024-03-12 13:13:03 -07:00
aio docs: bump to 2024 for copyright text (#54822) 2024-03-11 13:39:49 -07:00
devtools release: bump Angular DevTools version to 1.0.11 (#54631) 2024-02-27 14:02:15 -08:00
docs docs: add process documentation to CARETAKER.md (#54664) 2024-03-05 19:11:41 +01:00
goldens build: fix size failure (#54756) 2024-03-07 16:13:44 -08:00
integration build: update to TypeScript 5.4 stable (#54743) 2024-03-11 09:16:55 -07:00
modules refactor: standardize doctype declaration to <!DOCTYPE html> (#51052) 2024-02-01 19:29:46 +00:00
packages fix(core): exclude class attribute intended for projection matching from directive matching (#54800) 2024-03-12 14:05:18 -07:00
scripts refactor: migrate scripts to prettier formatting (#53976) 2024-01-19 10:22:06 +01:00
third_party build: create NodeJS ESM loader for supporting Bazel setup (#48521) 2022-12-19 19:50:40 +00:00
tools docs: revise documentation for @for control flow, 'track $index' performance issues explanation, and confusing 'trackBy' mention (#53806) 2024-03-04 11:37:37 +01:00
.bazelignore test: add integration test for signal inputs in CLI (#53808) 2024-01-10 12:21:05 +00:00
.bazelrc refactor: add --spawn_strategy local to --config debug (#54167) 2024-02-26 18:36:38 -08:00
.bazelversion build: update to bazel v5 for new runfiles API used in dev-infra (#45407) 2022-03-21 16:55:36 -07:00
.clang-format
.editorconfig build: use https link to editorconfig.org in .editorconfig (#27664) 2018-12-18 09:30:09 -08:00
.gitattributes build: cleanup .gitattributes file and remove outdated CRLF attribute (#46513) 2022-06-28 13:38:27 -07:00
.gitignore refactor(docs-infra): refactor adev to build using architect (#53497) 2023-12-11 19:21:07 +00:00
.gitmessage build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00
.mailmap build: add a Git .mailmap with my new name (#19550) 2017-10-09 14:35:30 -07:00
.npmrc build: rely on engines to prevent using npm for dependency install (#41477) 2021-04-07 12:05:01 -07:00
.nvmrc build: update node (#54399) 2024-02-12 15:36:19 -08:00
.prettierrc refactor: migrate router to prettier formatting (#54318) 2024-02-08 19:17:14 +00:00
.pullapprove.yml docs: add updating to v17 guide (#52410) 2024-02-28 14:19:45 +01:00
.yarnrc build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
browser-providers.conf.d.ts build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
browser-providers.conf.js ci: enable Android 12 for tests on CI (#45926) 2022-05-09 11:26:10 -07:00
BUILD.bazel refactor(docs-infra): refactor adev to build using architect (#53497) 2023-12-11 19:21:07 +00:00
CHANGELOG.md release: cut the v17.3.0-rc.0 release 2024-03-06 20:40:30 +01:00
CHANGELOG_ARCHIVE.md docs: fix typos 2023-06-22 12:56:49 +02:00
CODE_OF_CONDUCT.md build: update CODE_OF_CONDUCT.md to match the content of angular/.github 2023-03-13 21:07:51 +00:00
CONTRIBUTING.md docs: Fix misspelling in note of git commit --all (#51735) 2023-09-12 12:25:42 -07:00
gulpfile.js build: remove the unused source-map-test (#46518) 2022-06-27 15:42:43 -07:00
karma-js.conf.js build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
LICENSE docs: bump to 2024 for copyright text (#54822) 2024-03-11 13:39:49 -07:00
package.json build: update to TypeScript 5.4 stable (#54743) 2024-03-11 09:16:55 -07:00
packages.bzl refactor(docs-infra): build adev application using local generated assets (#53511) 2023-12-20 14:49:31 -08:00
README.md docs: add documentation and script for local docs dev environment (#54038) 2024-01-25 18:02:27 +00:00
renovate.json ci: update renovate.json (#49909) 2023-04-18 20:54:28 +00:00
SECURITY.md build: update SECURITY.md to match the content of angular/.github 2023-01-06 08:51:29 +00:00
tsconfig-tslint.json refactor(devtools): run ng-dev format on angular devtools files 2022-01-26 16:35:30 -05:00
tslint.json build: configure tslint to ban performance.mark usages (#52505) 2023-11-03 07:43:36 -07:00
WORKSPACE build: update io_bazel_rules_sass digest to 888dd9c (#54615) 2024-02-27 14:06:29 -08:00
yarn.bzl build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
yarn.lock build: update to TypeScript 5.4 stable (#54743) 2024-03-11 09:16:55 -07:00
yarn.lock.readme.md build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00

Angular - The modern web developer's platform

angular-logo
Angular is a development platform for building mobile and desktop web applications
using TypeScript/JavaScript and other languages.

angular.dev

Contributing Guidelines · Submit an Issue · Blog

CI status   Angular on npm   Discord conversation

InsightsSnapshot


Documentation

Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.

Advanced

Local Development

To contribute to Angular docs, you can setup a local environment with the following commands:

# Clone Angular repo
git clone https://github.com/angular/angular.git

# Navigate to project directory
cd angular

# Install dependencies
yarn

# Build and run local dev server
# Note: Initial build will take some time
yarn docs

Development Setup

Prerequisites

Setting Up a Project

Install the Angular CLI globally:

npm install -g @angular/cli

Create workspace:

ng new [PROJECT NAME]

Run the application:

cd [PROJECT NAME]
ng serve

Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.

Quickstart

Get started in 5 minutes.

Ecosystem

angular ecosystem logos

Changelog

Learn about the latest improvements.

Upgrading

Check out our upgrade guide to find out the best way to upgrade your project.

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

Code of Conduct

Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.

Community

Join the conversation and help the community.

Love Angular badge

Love Angular? Give our repo a star ⬆️.