Commit graph

2166 commits

Author SHA1 Message Date
tjshiu
f84653605a docs: modernize autocomplete examples and guide to signal apis
Some checks are pending
DevInfra / assistant_to_the_branch_manager (push) Waiting to run
CI (push) / lint (push) Waiting to run
CI (push) / zone-js (push) Waiting to run
CI (push) / devtools (push) Waiting to run
CI (push) / test (push) Waiting to run
CI (push) / integration-tests (push) Waiting to run
CI (push) / adev (push) Waiting to run
CI (push) / vscode-ng-language-service (push) Waiting to run
CI (push) / publish-snapshots (push) Waiting to run
CI (push) / adev-deploy (push) Blocked by required conditions
Update ADEV Cross Repo Docs / Update Cross Repo ADEV Docs (push) Waiting to run
Performance Tracking / workflow (push) Blocked by required conditions
Performance Tracking / list (push) Waiting to run
OpenSSF Scorecard / Scorecards analysis (push) Waiting to run
2026-05-21 08:54:04 -07:00
Kam
04f31cce3e docs: link to ng new reference from installation guide
The installation guide walks a developer through `ng new <project-name>` but provides no link to the `ng new` CLI reference, leaving every option the command supports undiscoverable from the install flow. Link `ng new` in the prose to the reference page so options are one click away.
2026-05-20 14:09:32 -07:00
Douglas Parker
c7e08ebe59 docs: add WebMCP docs
Adds initial documentation of experimental WebMCP APIs.
2026-05-20 14:06:15 -07:00
tjshiu
069b0153aa docs: simplify multiselect examples by removing scroll resets 2026-05-20 14:04:12 -07:00
tjshiu
36500a70e3 docs: simplify multiselect overlay bindings and transitions
Remove the delayed overlayOpen signals and synchronization effects across all 9 multiselect example variations. Bind cdkConnectedOverlayOpen directly to popupExpanded() and remove conditional closing classes to simplify code.
2026-05-20 14:04:12 -07:00
tjshiu
8fa7311c6e docs: modernize multiselect guide and standalone examples
Update the multiselect guide and all 27 interactive examples to utilize
the modern standalone, Signal-based Angular ARIA APIs.

* Modernize all examples (Standard, Material, Retro)
  to use standalone directives, animations, and focus suppression.
* Update the multiselect guide API tables and templates:
  - Document ngComboboxPopup, cdkConnectedOverlay, and disabled input.
  - Document ngListbox selectionMode, focusMode, tabIndex, and value signal.
  - Document activeDescendant active focus tracking with ngComboboxWidget.
2026-05-20 14:04:12 -07:00
tjshiu
62f8449453 docs: modernize select guide and examples 2026-05-20 13:56:47 -07:00
Kam
41a772ec0b docs: fix grammar slips on pipes guide
Fixes subject-verb agreement in the overview opener and date/currency example, a singular pronoun for a plural antecedent under change detection, and an "a object" -> "an object" a/an slip.
2026-05-20 13:51:50 -07:00
arturovt
d985957f09 docs: document barrel file caveat for @defer lazy chunks
Users often enable @defer expecting a separate lazy chunk but don't get
one, with no obvious error to explain why. The root cause is almost
always a barrel file import — the bundler treats the whole barrel as a
single module and can't split out individual exports.

Add a section to the defer guide that starts from the symptom (no lazy
chunk), shows the barrel import pattern that causes it, and gives the
direct-import fix.

Closes #52554
2026-05-20 13:47:42 -07:00
arturovt
de9e3d136e docs: document content projection limitations
Add a Limitations section to the content projection guide covering two
common footguns that aren't obvious from the feature description alone.

First, projected content lives in the declaring component's view, not
the receiving component's. This means OnPush on the receiving component
doesn't prevent projected content from being checked on every parent
cycle, and projected content can't see the receiving component's
viewProviders.

Second, some library components (menus, tabs, lists) use ContentChildren
to wire up keyboard navigation and ARIA behavior and assume they own
their children directly. Projecting external content into them tends to
break that behavior silently.

Closes #49679
2026-05-20 13:31:45 -07:00
Angular Robot
4104207913 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-20 11:09:39 -07:00
Alan Agius
b70515cada docs: update supported Angular versions table to reflect v19 end-of-life status 2026-05-20 10:09:56 -07:00
arturovt
03161dc114 docs: clarify viewProviders visibility with projected content
The providers vs. viewProviders section explained what happens but not
why — specifically, why projected content can still access a parent
component's viewProviders. Added an explanation that DI follows where
content was declared, not where it's rendered, so projecting a component
into a child's ng-content cuts off the child's viewProviders but leaves
the declaring component's viewProviders reachable.

Closes #49202
2026-05-20 10:09:02 -07:00
aparziale
8ebc900067 docs: update HTTP testing setup guidance
Update testing documentation clarify HttpClient testing providers

Fixed #68792
2026-05-19 13:41:13 -07:00
g.turri
4e55ceafc9 docs: Fix accepted Provider type in doc snippet
out of the box my IDE tells me there an error on

    const testProviders: Provider[] = [provideHttpClient(), provideHttpClientTesting()];

because `provideHttpClient()` returns an `EnvironmentProviders` so
I can't put it in a variable of type `Provider[]`
2026-05-19 13:19:33 -07:00
june-by
c49661b57b docs(compiler): add typeCheckHostBindings option to angular compiler options 2026-05-19 13:09:25 -07:00
SkyZeroZx
d251c0bf87 docs: Adds lazy service loading for best practice performance 2026-05-19 13:08:53 -07:00
Kam
b7255f9d13 docs: open external anchors in adev markdown in a new tab
Several raw HTML `<a>` anchors in adev markdown link to external
sites without `target="_blank"`, so they open in the same tab
instead of a new one like the rest of the site's external links.
Add `target="_blank"` to match.
2026-05-18 13:18:20 -07:00
cexbrayat
9a7dedced6 docs: use when in signal forms rule examples
Some checks failed
CI (push) / lint (push) Has been cancelled
Performance Tracking / list (push) Has been cancelled
DevInfra / assistant_to_the_branch_manager (push) Has been cancelled
CI (push) / zone-js (push) Has been cancelled
OpenSSF Scorecard / Scorecards analysis (push) Has been cancelled
CI (push) / devtools (push) Has been cancelled
CI (push) / test (push) Has been cancelled
CI (push) / integration-tests (push) Has been cancelled
CI (push) / adev (push) Has been cancelled
CI (push) / vscode-ng-language-service (push) Has been cancelled
CI (push) / publish-snapshots (push) Has been cancelled
Update ADEV Cross Repo Docs / Update Cross Repo ADEV Docs (push) Has been cancelled
Performance Tracking / workflow (push) Has been cancelled
CI (push) / adev-deploy (push) Has been cancelled
Update the Signal Forms guides to match df54e6a7b2, which introduced the consistent {when: ...} form for these rules.
2026-05-15 12:16:50 -07:00
Angular Robot
2959d6bd9e docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-15 11:41:49 -07:00
Jens Kuehlers
358d2e63fb docs: move Angular 19 to unsupported versions 2026-05-15 10:41:39 -07:00
Alan Agius
dbf38537f2 docs: add version 22 to the browser support reference table 2026-05-13 15:33:56 -07:00
Ben Hong
3584eeb491 docs: add clarification around plain object models
Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
2026-05-13 11:24:34 -07:00
Matthieu Riegler
f05d675651 build: update cross-repo angular dependencies (main)
Some checks are pending
DevInfra / assistant_to_the_branch_manager (push) Waiting to run
CI (push) / zone-js (push) Waiting to run
CI (push) / lint (push) Waiting to run
CI (push) / devtools (push) Waiting to run
CI (push) / test (push) Waiting to run
CI (push) / integration-tests (push) Waiting to run
CI (push) / adev (push) Waiting to run
CI (push) / vscode-ng-language-service (push) Waiting to run
CI (push) / publish-snapshots (push) Waiting to run
CI (push) / adev-deploy (push) Blocked by required conditions
Update ADEV Cross Repo Docs / Update Cross Repo ADEV Docs (push) Waiting to run
Performance Tracking / workflow (push) Blocked by required conditions
Performance Tracking / list (push) Waiting to run
OpenSSF Scorecard / Scorecards analysis (push) Waiting to run
This PR also replaces the implementation of the select component on ADEV due to the aria breaking changes
2026-05-12 16:41:38 -07:00
Angular Robot
d42fdf151e docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-12 15:50:42 -07:00
Angular Robot
2f143bf9c9 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-11 12:46:59 -07:00
Matthieu Riegler
52a848790f docs: update guides to use @Service
In the cases where it was preferable to use `@Service` in place of `@Injectable`
2026-05-11 12:38:23 -07:00
Ben Hong
ef134ac367 docs: add new signal forms field metadata guide
Some checks are pending
DevInfra / assistant_to_the_branch_manager (push) Waiting to run
CI (push) / lint (push) Waiting to run
CI (push) / devtools (push) Waiting to run
CI (push) / test (push) Waiting to run
CI (push) / integration-tests (push) Waiting to run
CI (push) / adev (push) Waiting to run
CI (push) / vscode-ng-language-service (push) Waiting to run
CI (push) / publish-snapshots (push) Waiting to run
CI (push) / zone-js (push) Waiting to run
CI (push) / adev-deploy (push) Blocked by required conditions
Update ADEV Cross Repo Docs / Update Cross Repo ADEV Docs (push) Waiting to run
Performance Tracking / list (push) Waiting to run
Performance Tracking / workflow (push) Blocked by required conditions
OpenSSF Scorecard / Scorecards analysis (push) Waiting to run
Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
2026-05-11 12:05:27 -07:00
Kam
4ec076e13c docs: add inject() example to "Forwarding injected dependencies"
Lead the section with the recommended `inject()` pattern (child
inherits the property, no `super` forwarding), and keep the existing
constructor DI example after as the alternative. Also fixes a typo
where the verb "class" should read "pass".
2026-05-11 12:02:45 -07:00
Kam
0629e7e505 docs: recommend output() over EventEmitter in reactive forms guide
The "Save form data" step pointed at `EventEmitter` while the rest of
the guide uses modern APIs (e.g. `inject(FormBuilder)`). Swap to
`output()` and align the TODO in the profile-editor example.
2026-05-11 12:02:03 -07:00
SkyZeroZx
538d0a8e93 docs: remove experimental warnings from resource/signal forms documentation 2026-05-11 11:46:08 -07:00
Kam
8b46492b7e docs: fix two 404 links in the roadmap
"Introduce built-in control flow" => guide/templates/control-flow (was
the now-removed next.angular.dev/essentials/conditionals-and-loops),
and "Improve documentation and schematics for standalone components"
=> essentials/components (was the bare `components`, not an adev route).
2026-05-08 15:05:40 -06:00
Alan Agius
b3de3af0dd docs: remove note regarding lack of support for ng test --debug in browser mode
This is no longer the case.

Closes #68621
2026-05-08 09:57:08 -06:00
Michael Small
89ee8a8162 docs: fix signal forms async validator typings
docs: add response types for form async `onSuccess`

docs: set defined fallback for async validator params

docs: replace `this.` w/`const`

docs: give fallback string for form async validators

docs: replace `onError` overwritten by `onSuccess`

docs: use `undefined!` for now w/async validators

chore: lint form's `async-operations.md`
2026-05-07 18:17:57 -06:00
SkyZeroZx
a0b998e293 docs(docs-infra): use signals & improve types
Use signals to avoid markForCheck.

Simplify takeUntilDestroyed usage by relying on implicit DestroyRef.

Improve type safety by typing inject(ElementRef).
2026-05-07 18:17:29 -06:00
SkyZeroZx
307723a352 docs: add documentation for de-duplicate host directives 2026-05-07 17:53:42 -06:00
Michael Small
7b4791f474 docs: add FormField/FormRoot imports + move comment w/backticks 2026-05-07 16:56:45 -06:00
Michael Small
44c0293a3e docs: fix applyWhenValue form example 2026-05-07 16:54:06 -06:00
Michael Small
0ef43c5ff3 docs: rename outdated validateTree example's model 2026-05-07 16:53:41 -06:00
Angular Robot
28e7bfaf77 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-07 16:51:57 -06:00
Kristiyan Kostadinov
1f238ab567 fix(docs-infra): switch remaining adev services to @Service
Reworks all the remaining injectables in adev to use `@Service`.
2026-05-07 16:23:26 -06:00
Kam
ed333c3992 docs: normalize product name casing across docs
Several user-facing docs, tooltips, and tutorial code samples used
non-canonical spellings of product names. This normalizes them to
the form each project uses for its own brand.
2026-05-07 16:09:44 -06:00
Alan Agius
d8e5514f30 docs: update Node.js version requirements in version reference table 2026-05-07 16:06:38 -06:00
Bhuvansh855
dc4b3172df docs(animations): improve grammar and clarity across animation guides 2026-05-07 16:03:41 -06:00
SUMIDA, Ippei
2fcfffbc7d docs: Update error display for password field in signal forms playground
Change error message display from paragraph to list format in signal forms playground.
2026-05-07 15:53:07 -06:00
Alan Agius
b8d3f36ed9 feat(compiler-cli): add support for Node.js 26.0.0
Updates the supported Node.js engine versions to include Node.js 26.

This allows running the CLI on Node.js 26.0.0 and above while continuing to support active LTS versions.
2026-05-06 09:55:38 -07:00
Jaime Burgos
f81fa6e691
docs: add documentation for lazy loading services and update navigation 2026-05-05 15:57:36 -07:00
Kam
8a7f955f0f docs: correct "Angular JS" to "AngularJS"
"AngularJS" is the official product name for the v1.x line and is
written as a single word. A few places in the docs and package
READMEs used "Angular JS" with a space. This normalizes those
references to the canonical spelling.
2026-05-05 12:42:39 -07:00
Leon Senft
708631f2c4 fix(forms): prohibit concurrent submits in signal forms
Prohibit concurrent submits in signal forms to prevent duplicate actions and side effects when a submission is already in progress.

If `submit()` is called while a prior submit is in progress for the same field or any of its parents, it returns `false` immediately without running the action again.

This commit also updates the documentation in `form-submission.md` to reflect this behavior.

Fixes #68317
2026-05-05 11:14:03 -07:00
Kam
1da396fd84 fix(docs-infra): mask page content leak at mobile nav right edge
On phones, the page content behind the primary-nav drawer leaks 1-2px past its right edge. Mask it with a 2px var(--page-background) box-shadow.
2026-05-05 09:31:53 -07:00