Injecting Custom Template Loading Logic

[lekhmanrus]

Command

build, serve

Description

In previous Angular versions, when using webpack-based builders, we had the ability to customize how component templates were processed (e.g., using third-party loaders like ngx-pug-builders to support Pug templates). With ESBuild, template loading logic to be managed internally by the AdapterResourceLoader. It looks, like currently there appears to be no way to inject custom logic into the template loading process. This limits the ability for third-party libraries to provide support for alternative template formats or to apply custom modifications during the build.

Describe the solution you'd like

It would be beneficial for Angular to expose a mechanism for developers to hook into or modify the HTML loading logic. This would enable third-party libraries to support template engines like Pug or apply other transformations.

While Angular CLI may not want to handle all possible template engines directly, allowing developers to customize the HTML loading process would open the door for greater flexibility and extensibility within the ecosystem.

Describe alternatives you've considered

No response

[angular-robot[bot]]

This feature request is now candidate for our backlog! In the next phase, the community has 60 days to upvote. If the request receives more than 20 upvotes, we'll move it to our consideration list.

You can find more details about the feature request process in our documentation.

[clydin]

Can you provide additional information regarding your use cases that are not met by using Angular templates? While the Angular template language can be parsed as valid HTML, its full syntactic space goes beyond HTML. This is especially true with the control flow, defer, let, etc. capabilities now present. Additionally, the developer ecosystem tools rely on Angular components using the Angular template language and includes schematics, updates, linting (eslint), formatting (prettier), IDE integration (Angular language service or WebStorm), and more.

[lekhmanrus]

Hi @clydin, I understand that integrating and supporting pug files isn't part of the Angular team's current plans, but a significant number of developers still use Pug in their projects. I had previously integrated the webpack pug loader via a custom Angular builders, but since Angular switched to esbuild and vite (which btw works perfectly and fast), integrating pug into Angular has become impossible. This seems to be because templates are loaded through AdapterResourceLoader (as I understand), and any esbuild plugins are ignored at that stage. I also tried importing pug files using a loader kinda:

import template from './app.component.pug' with { loader: 'text' };

However, using this in the @Component's template is also not possible. Regarding control flow, defer, let, and similar capabilities, it's worth noting that they can still be used in pug templates as well. So perhaps it would be good to have some ability to inject into the template loading (to compile pug to html in this specific case)? Or maybe there is some better workaround.

P.S.: Personally I do not use Pug in my Angular projects anymore - just trying to support a library that some developers still seem to use.

[Eugeny]

To be clear, it's not about replacing the Angular templating functionality with Pug's, but rather using pure, non-templating Pug syntax with Angular, for example:

<div *ngIf="thing" class="dropdown-menu-right" ngbDropdownMenu>
   <a class="dropdown-item" (click)="setFilterMode(mode)">
       <i class="far fa-fw fa-tilde"></i>
       <span translate>{{mode}}</span>
    </a>
</div>

becomes

.dropdown-menu-right(*ngIf='thing', ngbDropdownMenu)
    a.dropdown-item((click)='setFilterMode(mode)')
        i.far.fa-fw.fa-tilde
        span(translate) {{mode}}

All this requires really is a single build callback that provides a chance to modify the raw template (as loaded from templateUrl) before it's used for the build.

That already works with angular-builders/custom-webpack but not esbuild