4.9 KiB
ProjectionStrategy
ProjectionStrategy 是@abp/ng.core包暴露出的抽象类. 有三种扩展它的投影策略: ComponentProjectionStrategy, RootComponentProjectionStrategy 和 TemplateProjectionStrategy. 它们实现相同的方法和属性,均可以帮助你定义内容投影的工作方式.
ComponentProjectionStrategy
ComponentProjectionStrategy 是扩展 ProjectionStrategy 的类. 它使你可以将组件投影到容器中.
constructor
constructor(
component: T,
private containerStrategy: ContainerStrategy,
private contextStrategy?: ContextStrategy,
)
component是你要投影的组件的类.containerStrategy是在投影组件时将使用的ContainerStrategy.contextStrategy是将在投影组件上使用的ContextStrategy. (默认值: None_)
请参阅ContainerStrategy和ContextStrategy文档以了解其用法.
injectContent
injectContent(injector: Injector): ComponentRef<T>
该方法准备容器,解析组件,设置其上下文并将其投影到容器中. 它返回一个 ComponentRef 实例,你应该保留该实例以便以后清除投影的组件.
RootComponentProjectionStrategy
RootComponentProjectionStrategy 是扩展 ProjectionStrategy 的类. 它使你可以将组件投影到文档中,例如将其附加到 <body>.
constructor
constructor(
component: T,
private contextStrategy?: ContextStrategy,
private domStrategy?: DomStrategy,
)
component是你要投影的组件的类.contextStrategy是将在投影组件上使用的ContextStrategy. (默认值: None_)domStrategy是插入组件时将使用的DomStrategy. (默认值: AppendToBody_)
请参阅ContextStrategy和DomStrategy文档以了解其用法.
injectContent
injectContent(injector: Injector): ComponentRef<T>
该方法解析组件,设置其上下文并将其投影到文档中. 它返回一个 ComponentRef 实例,你应该保留该实例以便以后清除投影的组件.
TemplateProjectionStrategy
TemplateProjectionStrategy 是扩展 ProjectionStrategy 的类.它使你可以将模板投影到容器中.
constructor
constructor(
template: T,
private containerStrategy: ContainerStrategy,
private contextStrategy?: ContextStrategy,
)
template是你要投影的TemplateRef.containerStrategy是在投影组件时将使用的ContainerStrategy.contextStrategy是将在投影组件上使用的ContextStrategy. (默认值: None_)
请参阅ContainerStrategy和ContextStrategy文档以了解其用法.
injectContent
injectContent(): EmbeddedViewRef<T>
该方法准备容器,并将模板及其定义的上下文一起投影到容器. 它返回一个 EmbeddedViewRef 实例,你应该保留该实例以便以后清除投影的模板.
预定义的投影策略
可以通过 PROJECTION_STRATEGY 常量访问预定义的投影策略.
AppendComponentToBody
PROJECTION_STRATEGY.AppendComponentToBody(
component: T,
contextStrategy?: ComponentContextStrategy<T>,
)
将给定上下文设置到组件并将放置在文档中 <body> 标签的末尾.
AppendComponentToContainer
PROJECTION_STRATEGY.AppendComponentToContainer(
component: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
将给定上下文设置到组件并将放置在容器的末尾.
AppendTemplateToContainer
PROJECTION_STRATEGY.AppendTemplateToContainer(
templateRef: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
将给定上下文设置到模板并将其放置在容器的末尾.
PrependComponentToContainer
PROJECTION_STRATEGY.PrependComponentToContainer(
component: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
将给定上下文设置到组件并将其放置在容器的开头.
PrependTemplateToContainer
PROJECTION_STRATEGY.PrependTemplateToContainer(
templateRef: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
将给定上下文设置到模板并将其放置在容器的开头.
ProjectComponentToContainer
PROJECTION_STRATEGY.ProjectComponentToContainer(
component: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
清除容器,将给定的上下文设置到组件并放在已清除的容器中.
ProjectTemplateToContainer
PROJECTION_STRATEGY.ProjectTemplateToContainer(
templateRef: T,
containerRef: ViewContainerRef,
contextStrategy?: ComponentContextStrategy<T>,
)
清除容器,将给定的上下文设置到模板并放在已清除的容器中.