Skip to content

docs: declare Standalone APIs as stable #47754

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
AndrewKushnir wants to merge 1 commit into from
Closed

docs: declare Standalone APIs as stable #47754

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 1 addition & 8 deletions aio/content/guide/standalone-components.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,6 @@
# Getting started with standalone components

<div class="alert is-important">

The standalone component feature is available for [developer preview](https://angular.io/guide/releases#developer-preview).
It's ready for you to try, but it might change before it is stable.

</div>

In v14 and higher, **standalone components** provide a simplified way to build Angular applications. Standalone components, directives, and pipes aim to streamline the authoring experience by reducing the need for `NgModule`s. Existing applications can optionally and incrementally adopt the new standalone style without any breaking changes.
**Standalone components** provide a simplified way to build Angular applications. Standalone components, directives, and pipes aim to streamline the authoring experience by reducing the need for `NgModule`s. Existing applications can optionally and incrementally adopt the new standalone style without any breaking changes.

## Creating standalone components

Expand Down
10 changes: 5 additions & 5 deletions aio/content/navigation.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -314,6 +314,11 @@
"title": "Overview",
"tooltip": "A list of developer guides for building Angular applications."
},
{
"url": "guide/standalone-components",
"title": "Standalone components",
"tooltip": "Standalone components, directives, and pipes"
},
{
"title": "Change detection",
"tooltip": "Learn how Angular updates the view based on data changes and how to keep your application fast",
Expand Down Expand Up @@ -852,11 +857,6 @@
"title": "Feature preview",
"tooltip": "Angular preview features and APIs",
"children": [
{
"url": "guide/standalone-components",
"title": "Standalone components",
"tooltip": "Standalone components, directives, and pipes"
},
{
"url": "guide/image-directive",
"title": "Image Directive",
Expand Down
1 change: 0 additions & 1 deletion packages/common/testing/src/provide_location_mocks.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@ import {MockLocationStrategy} from './mock_location_strategy';
* Returns mock providers for the `Location` and `LocationStrategy` classes.
* The mocks are helpful in tests to fire simulated location events.
*
* @developerPreview
* @publicApi
*/
export function provideLocationMocks(): Provider[] {
Expand Down
2 changes: 0 additions & 2 deletions packages/core/src/di/provider_collection.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,6 @@ export function makeEnvironmentProviders(providers: Provider[]): EnvironmentProv
/**
* A source of providers for the `importProvidersFrom` function.
*
* @developerPreview
* @publicApi
*/
export type ImportProvidersSource =
Expand Down Expand Up @@ -82,7 +81,6 @@ export type ImportProvidersSource =
*
* @returns Collected providers from the specified list of types.
* @publicApi
* @developerPreview
*/
export function importProvidersFrom(...sources: ImportProvidersSource[]): EnvironmentProviders {
return {
Expand Down
2 changes: 0 additions & 2 deletions packages/core/src/di/r3_injector.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,8 +73,6 @@ interface Record<T> {
/**
* An `Injector` that's part of the environment injector hierarchy, which exists outside of the
* component tree.
*
* @developerPreview
*/
export abstract class EnvironmentInjector implements Injector {
/**
Expand Down
6 changes: 0 additions & 6 deletions packages/core/src/metadata/directives.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -328,8 +328,6 @@ export interface Directive {
*
* More information about standalone components, directives, and pipes can be found in [this
* guide](guide/standalone-components).
*
* @developerPreview
*/
standalone?: boolean;

Expand Down Expand Up @@ -617,8 +615,6 @@ export interface Component extends Directive {
*
* More information about standalone components, directives, and pipes can be found in [this
* guide](guide/standalone-components).
*
* @developerPreview
*/
standalone?: boolean;

Expand All @@ -632,8 +628,6 @@ export interface Component extends Directive {
*
* More information about standalone components, directives, and pipes can be found in [this
* guide](guide/standalone-components).
*
* @developerPreview
*/
imports?: (Type<any>|any[])[];

Expand Down
1 change: 0 additions & 1 deletion packages/core/src/render3/ng_module_ref.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,6 @@ class EnvironmentNgModuleRefAdapter extends viewEngine_NgModuleRef<null> {
* messages.
*
* @publicApi
* @developerPreview
*/
export function createEnvironmentInjector(
providers: Array<Provider|EnvironmentProviders>, parent: EnvironmentInjector,
Expand Down
2 changes: 0 additions & 2 deletions packages/platform-browser/animations/src/module.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,6 @@ export class BrowserAnimationsModule {
* ```
*
* @publicApi
* @developerPreview
*/
export function provideAnimations(): Provider[] {
// Return a copy to prevent changes to the original array in case any in-place
Expand Down Expand Up @@ -118,7 +117,6 @@ export class NoopAnimationsModule {
* ```
*
* @publicApi
* @developerPreview
*/
export function provideNoopAnimations(): Provider[] {
// Return a copy to prevent changes to the original array in case any in-place
Expand Down
4 changes: 0 additions & 4 deletions packages/platform-browser/src/browser.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ const NG_DEV_MODE = typeof ngDevMode === 'undefined' || !!ngDevMode;
/**
* Set of config options available during the application bootstrap operation.
*
* @developerPreview
* @publicApi
*/
export interface ApplicationConfig {
Expand Down Expand Up @@ -92,7 +91,6 @@ export interface ApplicationConfig {
* @returns A promise that returns an `ApplicationRef` instance once resolved.
*
* @publicApi
* @developerPreview
*/
export function bootstrapApplication(
rootComponent: Type<unknown>, options?: ApplicationConfig): Promise<ApplicationRef> {
Expand All @@ -110,7 +108,6 @@ export function bootstrapApplication(
* @returns A promise that returns an `ApplicationRef` instance once resolved.
*
* @publicApi
* @developerPreview
*/
export function createApplication(options?: ApplicationConfig) {
return internalCreateApplication(createProvidersConfig(options));
Expand All @@ -135,7 +132,6 @@ function createProvidersConfig(options?: ApplicationConfig) {
* @returns An array of providers required to setup Testability for an application and make it
* available for testing using Protractor.
*
* @developerPreview
* @publicApi
*/
export function provideProtractorTestingSupport(): Provider[] {
Expand Down
16 changes: 0 additions & 16 deletions packages/router/src/provide_router.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,6 @@ const NG_DEV_MODE = typeof ngDevMode === 'undefined' || ngDevMode;
* @see `RouterFeatures`
*
* @publicApi
* @developerPreview
* @param routes A set of `Route`s to use for the application routing table.
* @param features Optional features to configure additional router behaviors.
* @returns A set of providers to setup a Router.
Expand All @@ -79,7 +78,6 @@ export function rootRoute(router: Router): ActivatedRoute {
* Helper type to represent a Router feature.
*
* @publicApi
* @developerPreview
*/
export interface RouterFeature<FeatureKind extends RouterFeatureKind> {
ɵkind: FeatureKind;
Expand Down Expand Up @@ -122,7 +120,6 @@ export function provideRoutes(routes: Routes): Provider[] {
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type InMemoryScrollingFeature = RouterFeature<RouterFeatureKind.InMemoryScrollingFeature>;

Expand All @@ -147,7 +144,6 @@ export type InMemoryScrollingFeature = RouterFeature<RouterFeatureKind.InMemoryS
* @see `ViewportScroller`
*
* @publicApi
* @developerPreview
* @param options Set of configuration parameters to customize scrolling behavior, see
* `InMemoryScrollingOptions` for additional information.
* @returns A set of providers for use with `provideRouter`.
Expand Down Expand Up @@ -236,7 +232,6 @@ const INITIAL_NAVIGATION = new InjectionToken<InitialNavigation>(
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type EnabledBlockingInitialNavigationFeature =
RouterFeature<RouterFeatureKind.EnabledBlockingInitialNavigationFeature>;
Expand All @@ -250,7 +245,6 @@ export type EnabledBlockingInitialNavigationFeature =
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type InitialNavigationFeature =
EnabledBlockingInitialNavigationFeature|DisabledInitialNavigationFeature;
Expand Down Expand Up @@ -278,7 +272,6 @@ export type InitialNavigationFeature =
* @see `provideRouter`
*
* @publicApi
* @developerPreview
* @returns A set of providers for use with `provideRouter`.
*/
export function withEnabledBlockingInitialNavigation(): EnabledBlockingInitialNavigationFeature {
Expand Down Expand Up @@ -369,7 +362,6 @@ export function withEnabledBlockingInitialNavigation(): EnabledBlockingInitialNa
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type DisabledInitialNavigationFeature =
RouterFeature<RouterFeatureKind.DisabledInitialNavigationFeature>;
Expand Down Expand Up @@ -399,7 +391,6 @@ export type DisabledInitialNavigationFeature =
* @returns A set of providers for use with `provideRouter`.
*
* @publicApi
* @developerPreview
*/
export function withDisabledInitialNavigation(): DisabledInitialNavigationFeature {
const providers = [
Expand All @@ -425,7 +416,6 @@ export function withDisabledInitialNavigation(): DisabledInitialNavigationFeatur
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type DebugTracingFeature = RouterFeature<RouterFeatureKind.DebugTracingFeature>;

Expand All @@ -452,7 +442,6 @@ export type DebugTracingFeature = RouterFeature<RouterFeatureKind.DebugTracingFe
* @returns A set of providers for use with `provideRouter`.
*
* @publicApi
* @developerPreview
*/
export function withDebugTracing(): DebugTracingFeature {
let providers: Provider[] = [];
Expand Down Expand Up @@ -488,7 +477,6 @@ const ROUTER_PRELOADER = new InjectionToken<RouterPreloader>(NG_DEV_MODE ? 'rout
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type PreloadingFeature = RouterFeature<RouterFeatureKind.PreloadingFeature>;

Expand Down Expand Up @@ -517,7 +505,6 @@ export type PreloadingFeature = RouterFeature<RouterFeatureKind.PreloadingFeatur
* @returns A set of providers for use with `provideRouter`.
*
* @publicApi
* @developerPreview
*/
export function withPreloading(preloadingStrategy: Type<PreloadingStrategy>): PreloadingFeature {
const providers = [
Expand All @@ -534,7 +521,6 @@ export function withPreloading(preloadingStrategy: Type<PreloadingStrategy>): Pr
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type RouterConfigurationFeature =
RouterFeature<RouterFeatureKind.RouterConfigurationFeature>;
Expand Down Expand Up @@ -565,7 +551,6 @@ export type RouterConfigurationFeature =
* @returns A set of providers for use with `provideRouter`.
*
* @publicApi
* @developerPreview
*/
export function withRouterConfig(options: RouterConfigOptions): RouterConfigurationFeature {
const providers = [
Expand All @@ -583,7 +568,6 @@ export function withRouterConfig(options: RouterConfigOptions): RouterConfigurat
* @see `provideRouter`
*
* @publicApi
* @developerPreview
*/
export type RouterFeatures = PreloadingFeature|DebugTracingFeature|InitialNavigationFeature|
InMemoryScrollingFeature|RouterConfigurationFeature;
Expand Down
2 changes: 0 additions & 2 deletions packages/router/src/router_config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,6 @@ export type InitialNavigation = 'disabled'|'enabledBlocking'|'enabledNonBlocking
* Extra configuration options that can be used with the `withRouterConfig` function.
*
* @publicApi
* @developerPreview
*/
export interface RouterConfigOptions {
/**
Expand Down Expand Up @@ -115,7 +114,6 @@ export interface RouterConfigOptions {
* function.
*
* @publicApi
* @developerPreview
*/
export interface InMemoryScrollingOptions {
/**
Expand Down