2747 Commits

Author SHA1 Message Date
SkyZeroZx b416da67c1 docs: add caching guidance for resource data with SSR
(cherry picked from commit 274d1d2dcc)
2026-06-10 18:27:48 +00:00
aparziale 48996d3ab2 docs: update webpack-based system docs
Update webpack-based system docs

Fixes #69279

(cherry picked from commit 8854f2d476)
2026-06-10 17:54:46 +00:00
SkyZeroZx 1bd5a562f5 docs: deprecate XHR support for server-side rendering in HTTP docs and recommend Fetch
(cherry picked from commit 2066225244)
2026-06-10 17:20:43 +00:00
Jad Chahed a704b08379 docs: add Signal Forms and v22 guidance to AI best-practices and llms.txt
Update the AI codegen resources for Angular v22:
- best-practices.md: OnPush is the default in v22+ (don't set it explicitly),
  recommend Signal Forms, and recommend the @Service decorator.
- llms.txt: add a Signal Forms reference, the httpResource guide, and an
  Accessibility section linking the Angular Aria overview.

(cherry picked from commit 248e9c146d)
2026-06-09 21:00:00 +00:00
Kam 4d24f465e3 fix(docs-infra): load cross-origin video embeds under COEP credentialless
adev is cross-origin isolated (COOP same-origin + COEP require-corp) so the
embedded WebContainer editor can use SharedArrayBuffer. Under require-corp the
cross-origin YouTube iframe in `<docs-video>` only loaded in Chromium, leaving
the player blank in Safari.

Switch COEP from `require-corp` to `credentialless`. The page stays cross-origin
isolated, so the editor keeps working, but cross-origin frames are now allowed
to load, which restores the inline player in Safari as well.

(cherry picked from commit 86cd166141)
2026-06-09 20:26:24 +00:00
Kam 8ddda4d0aa fix(docs-infra): improve version picker dropdown positioning
Drops `position: absolute` from the version picker `<ul>` and tightens `max-height` to `70dvh` so the cdk-overlay-pane fits the viewport and the inner scroll reaches the last versions on mobile and desktop.

(cherry picked from commit 7d92cc8b46)
2026-06-09 16:58:26 +00:00
Kam 35a8c28656 docs: fix CurrencyPipe locale override example
The "Override current locale for CurrencyPipe" example used `{{ amount | currency: 'en-US' }}`, but the first `CurrencyPipe` argument is the currency code, not the locale, so `'en-US'` was treated as an invalid currency code (rendered literally as the symbol) and the locale was never overridden. Since `locale` is the fourth positional argument, the example now passes a valid currency code, display, and digits before it (`'USD' : 'symbol' : '1.2-2' : 'en-US'`), matching the parameter order shown on the CurrencyPipe API page.

(cherry picked from commit a82f822057)
2026-06-08 21:36:21 +00:00
KirtiRamchandani e7dae12c3d fix(docs-infra): avoid code copy button overlap
Reveal code copy controls on hover and focus so long code snippets stay readable while keyboard access and copy state feedback remain intact.

(cherry picked from commit b7cb5844cf)
2026-06-08 21:19:54 +00:00
Bhuvansh855 60d88b11bd docs: fix malformed prettier-ignore comment in whitespace guide
(cherry picked from commit 422e6893e4)
2026-06-08 19:59:29 +00:00
aparziale 54fa77adc1 docs: close menù with click outside container
close menù with click outside container

Fixes #69222

(cherry picked from commit dc8165e253)
2026-06-08 19:58:03 +00:00
Matthieu Riegler b310d718d9 docs: mention required behavior for booleans
fixes #68509

(cherry picked from commit 9cfd3f52e1)
2026-06-08 19:54:44 +00:00
Kam 70d038774c docs: trim transparent padding from v22 event hero image
The v22 event hero PNG shipped with a wide transparent margin baked into
its 960x540 canvas. Under the shared `img { width: 100% }` rule that empty
border stretched along with the artwork, leaving visible space around the
image. Trims the canvas to the artwork bounds (831x473) so it renders
flush; the retained pixels are unchanged and the file shrinks from about
795 KB to 568 KB.

(cherry picked from commit af7cb63151)
2026-06-05 17:56:32 +00:00
marktechson 879750a756 docs: update landing page with embed link and updated messaging
(cherry picked from commit 0197be381e)
2026-06-05 17:41:34 +00:00
Kam 652b76b57d docs: bump schematics-for-libraries example peer deps to v22
The my-lib schematics-for-libraries example still declared `^21.0.0`
peerDependencies, the only adev example left on the previous major. Bumps
`@angular/common`/`@angular/core` to `^22.0.0`, matching the current major
and this file's stable-`^N.0.0` bump pattern.

Also adds this example's package.json to .prettierignore: it contains
`// #docregion` markers consumed by the schematics-for-libraries guide, and
Prettier's json-stringify parser (used for any package.json) rejects those as
invalid JSON. Editing the file surfaced this pre-existing incompatibility in
the format check.

(cherry picked from commit 3960ad64e5)
2026-06-05 17:18:42 +00:00
Michael Small c00387b8d2 docs: mention parse of validateHttp
(cherry picked from commit e100c75e37)
2026-06-04 19:32:15 +00:00
Sreeved 93e5f95dd2 docs: fix typo in update card link description
(cherry picked from commit 82193a19ee)
2026-06-04 19:29:07 +00:00
KirtiRamchandani 1f0aeac008 fix(docs-infra): reserve scrollbar gutter for mobile nav
(cherry picked from commit bcb9f8da03)
2026-06-04 19:22:59 +00:00
Matthieu Riegler addedf3f95 docs: update support & release dates
(cherry picked from commit ebb76a4313)
2026-06-04 18:36:32 +00:00
Ben Hong 296f3481d5 docs: fix directives guide issues and inaccuracies
(cherry picked from commit c39b2a3b18)
2026-06-03 22:39:17 +00:00
Angular Robot da07b3cbc7 build: update cross-repo angular dependencies
See associated pull request for more information.
2026-06-03 18:22:53 +02:00
Alan Agius 14fc4b1018 refactor(docs-infra): rename tutorial & example package.json.template to package.json
Rename the tutorial and example template packages' package.json.template files to package.json on disk.

To comply with ng_package limitations (which forbids floating package.json files in package output), we added a copy_file rule in the BUILD files to generate the .template files during build/packaging, and excluded the source package.json files from the filegroups. This keeps package.json as standard files in the source tree while preserving docs packaging and runtime logic.

(cherry picked from commit ba59de563f)
2026-06-03 18:19:27 +02:00
marktechson 4e4242035b docs: update landing page for v22
(cherry picked from commit 20524958b7)
2026-06-03 17:54:55 +02:00
Pawel Kozlowski 24416ce92f docs: update tutorials and playground to v22.0.0
(cherry picked from commit 595660d796)
2026-06-03 17:11:43 +02:00
Pawel Kozlowski 0a3d22a571 docs: update version picker list for v22 release
(cherry picked from commit 95ede172a6)
2026-06-03 17:11:43 +02:00
Cheng-Hsuan Tsai 3401189488 docs: add Signal Forms integration example to Angular Aria Autocomplete guide
(cherry picked from commit b84e5ef183)
2026-06-03 11:23:27 +02:00
Kam da5a9505ef docs: use Türkiye as the country name in aria autocomplete examples
The aria autocomplete examples list "Turkey" in their country data, but
the country's official name is "Türkiye". Update all nine app.ts variants
to use it.

While there, remove a junk "Imporant" entry from the highlight/retro
variant's list, which is not a country and was a misspelled stray paste.

(cherry picked from commit 192ac021e4)
2026-06-03 11:19:58 +02:00
cexbrayat 62e1d88252 docs: simplify testing setup examples
(cherry picked from commit 3bb602ffe6)
2026-06-03 11:17:48 +02:00
Cheng-Hsuan Tsai 0066a640a2 docs: update Aria Menu focus/hover style and add context menu example
(cherry picked from commit af62d88bbd)
2026-06-03 11:16:19 +02:00
Angular Robot a301ba2878 build: update cross-repo angular dependencies
See associated pull request for more information.
2026-06-02 12:27:30 +02:00
Cheng-Hsuan Tsai 04028c75d7 docs: add testing guides to Angular Aria
(cherry picked from commit a76bc3c849)
2026-06-02 11:25:05 +02:00
Michael Small 36ff378564 docs: fix min/max form template examples
(cherry picked from commit 42391329c2)
2026-06-02 11:23:09 +02:00
Joey Perrott 689d41dd1f fix(docs-infra): secure update-assets script against RCE and SSRF
- Validate storedSha and storedBranch from _build-info.json.
- Validate latestSha returned from GitHub API.
- Validate branch in GithubClient.getShaForBranch and baseSha/headSha in GithubClient.getAffectedFiles.
- Use execFileSync instead of execSync to avoid shell execution.

TAG=agy
CONV=4e3e69ba-3f3d-416b-9ce4-9ef75486d2f3

(cherry picked from commit 3093edcad0)
2026-06-02 11:22:04 +02:00
Ben Hong 3b79a6921a docs: add conditional validation to signal forms validation guide
(cherry picked from commit c0eef66bbe)
2026-06-02 11:20:57 +02:00
Bhuvansh855 ae12a0932c docs(core): fix typos and grammar in dependency injection guides
(cherry picked from commit ac47524ede)
2026-06-01 18:56:15 +02:00
Matthieu Riegler 012609a714 docs(docs-infra): simplify code block styles
#68940 introduced a regression that broke style for wrapped `code` blocks.
Simplifying the style by droping the unecessary gradient + before workaround fixes the issue.

(cherry picked from commit ec4f08bb94)
2026-06-01 18:37:00 +02:00
Kam ed72aa8b78 refactor(docs-infra): correct misspelled CodeHighlighter class name
The class exported from `code-highlighter.ts` was named `CodeHighligher` (missing the second `h`) and its private field was `cachedHighligher`, both disagreeing with the filename which spells "highlighter" correctly. Rename the class to `CodeHighlighter` and the field to `cachedHighlighter`, and update the sole consumer (`CodeBlock`). Pure rename, no behavior change.

(cherry picked from commit 032fae8b36)
2026-06-01 18:34:53 +02:00
KirtiRamchandani 3482d01bf2 docs: mention Angular Aria in accessibility guide
(cherry picked from commit 9b5952e3a3)
2026-06-01 18:33:38 +02:00
Matthieu Riegler e834c37054 docs: add v22 entries to the update guide
(cherry picked from commit c743af4919)
2026-06-01 18:20:06 +02:00
Matthieu Riegler 61b34836ba docs: align main and 22.0.x for aria guides 2026-06-01 16:34:27 +02:00
Angular Robot 6fee7aaf89 build: update cross-repo angular dependencies
See associated pull request for more information.
2026-06-01 16:31:26 +02:00
Kam 15f7f8af96 docs: fix esbuild and TensorFlow branding on overview page
The esbuild card on the "What is Angular?" page rendered the bundler name three different ways (title "esbuild", link "ESBuild and Vite", body "Vite and ESBuild") so this unifies on the official lowercase "esbuild"; also corrects "Tensorflow" to "TensorFlow" to match the other brands on its line (Firebase, Material Design, Flutter, Google Cloud) which were already cased correctly.

(cherry picked from commit f777dd112e)
2026-06-01 12:19:10 +02:00
arturovt 3e50a76939 docs: document //i18n(ph="name") placeholder syntax for template interpolations
The `//i18n(ph="name")` comment syntax for naming interpolation placeholders
in templates was not documented anywhere in the i18n guide, despite being a
supported compiler feature with test coverage.

Add a "Name the interpolation placeholder" subsection under "Mark text in
component template" in prepare.md, mirroring the existing subsection in
"Mark text in component code". Includes a cross-reference to the $localize
equivalent (`${var}:name:`) to help readers connect the two approaches.

Closes #52070

(cherry picked from commit 2b44a07ea7)
2026-06-01 12:18:11 +02:00
aparziale 05708e4d6d docs: fix link debbuging and extended-diagnostics
Update link for 'Improve debbuging with better Angular error messages' and 'extended-diagnostics' sections

Fixed #69010

(cherry picked from commit cbc36f59e0)
2026-06-01 12:17:05 +02:00
Kam d82c364fb7 fix(docs-infra): readable contrast for DEV/EXP api badges in light mode
The DEV (developer preview) and EXP (experimental) badges in the API reference list used `--page-background` for text, which is dark in dark mode (working as intended on the pale colored bg) but white in light mode, making the labels invisible against the near-white badge bg. Introduce an `--item-attr-text` CSS variable defaulting to `--page-background` and overridden to `--primary-contrast` in light mode, following the per-mode pattern the file already uses for `--item-attr-base-mix`.

(cherry picked from commit 0010ad5910)
2026-06-01 11:57:56 +02:00
Kristiyan Kostadinov 8061ca4cf3 fix(docs-infra): round up media queries
Uses 1px increments for media queries, rather than the 0.01px we have now which seem to be a bit too precise and cause the UI to be stuck between states in some cases.

I've also removed some unnecessary `calc`, because the calculation is happening inside Sass already.

Fixes #69020.

(cherry picked from commit 96ed0fe45b)
2026-06-01 11:34:45 +02:00
Angular Robot 5f0c9f8bca docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-29 12:22:29 +02:00
arturovt c2153b1eb5 docs: document i18n object forms for sourceLocale and locales in angular.json
The `sourceLocale` and `locales` entries in `angular.json` accept object
forms (with `code`, `baseHref`, and `subPath`) that were never documented.

- Add an `i18n options` reference section to workspace-config.md covering
  the full shape of `sourceLocale` and each `locales` entry, including the
  distinction between `baseHref` (HTML only) and `subPath` (HTML + output
  directory name)
- Add `i18n` to the project configuration options table in workspace-config.md
- Expand the suboptions table in merge.md to mention the object forms and
  link to the new reference section

Closes #59664

(cherry picked from commit 2f49d5dba4)
2026-05-29 11:53:56 +02:00
tjshiu e8a81ce2d7 docs: remove redundant keydown bindings in autocomplete examples
(cherry picked from commit f0e164e4cb)
2026-05-29 11:46:40 +02:00
tjshiu 4c4e9eba9c docs: add clear buttons inside autocomplete examples
(cherry picked from commit 3939799e18)
2026-05-29 11:46:40 +02:00
Kam 8f625e77bd refactor(docs-infra): extract magic 27 in navigation-list tooltip threshold
The matTooltip on navigation list items was disabled when the label was
shorter than the literal `27`, repeated across four bindings in the
template. Lift the value to a protected readonly field so the threshold
has a name and lives in one place.

(cherry picked from commit 34d577f697)
2026-05-28 16:08:17 +02:00