class
Represents a container where one or more views can be attached to a component.
abstract class ViewContainerRef { abstract element: ElementRef abstract injector: Injector abstract parentInjector: Injector abstract length: number abstract clear(): void abstract get(index: number): ViewRef | null abstract createEmbeddedView<C>(templateRef: TemplateRef<C>, context?: C, index?: number): EmbeddedViewRef<C> abstract createComponent<C>(componentFactory: ComponentFactory<C>, index?: number, injector?: Injector, projectableNodes?: any[][], ngModule?: NgModuleRef<any>): ComponentRef<C> abstract insert(viewRef: ViewRef, index?: number): ViewRef abstract move(viewRef: ViewRef, currentIndex: number): ViewRef abstract indexOf(viewRef: ViewRef): number abstract remove(index?: number): void abstract detach(index?: number): ViewRef | null }
Can contain host views (created by instantiating a component with the createComponent()
method), and embedded views (created by instantiating a TemplateRef
with the createEmbeddedView()
method).
A view container instance can contain other view containers, creating a view hierarchy.
Property | Description |
---|---|
abstract element: ElementRef | Read-Only Anchor element that specifies the location of this container in the containing view. Each view container can have only one anchor element, and each anchor element can have only a single view container. Root elements of views attached to this container become siblings of the anchor element in the rendered view. Access the |
abstract injector: Injector | Read-Only The dependency injector for this view container. |
abstract parentInjector: Injector | Read-Only Deprecated No replacement |
abstract length: number | Read-Only Reports how many views are currently attached to this container. |
clear() |
---|
Destroys all views in this container. |
|
get() |
---|
Retrieves a view from this container. |
createEmbeddedView() | |||||||||
---|---|---|---|---|---|---|---|---|---|
Instantiates an embedded view and inserts it into this container. | |||||||||
|
templateRef | TemplateRef | The HTML template that defines the view. |
context | C | The data-binding context of the embedded view, as declared in the Optional. Default is |
index | number | The 0-based index at which to insert the new view into this container. If not specified, appends the new view as the last entry. Optional. Default is |
EmbeddedViewRef<C>
: The ViewRef
instance for the newly created view.
createComponent() | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Instantiates a single component and inserts its host view into this container. | |||||||||||||||
|
componentFactory | ComponentFactory | The factory to use. |
index | number | The index at which to insert the new component's host view into this container. If not specified, appends the new view as the last entry. Optional. Default is |
injector | Injector | The injector to use as the parent for the new component. Optional. Default is |
projectableNodes | any[][] | Optional. Default is |
ngModule | NgModuleRef | Optional. Default is |
ComponentRef<C>
: The new component instance, containing the host view.
insert() |
---|
Inserts a view into this container. |
move() |
---|
Moves a view to a new location in this container. |
indexOf() |
---|
Returns the index of a view within the current container. |
remove() | |||
---|---|---|---|
Destroys a view attached to this container | |||
|
index | number | The 0-based index of the view to destroy. If not specified, the last view in the container is removed. Optional. Default is |
void
detach() |
---|
Detaches a view from this container without destroying it. Use along with |
© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v12.angular.io/api/core/ViewContainerRef