NgIf 指令作用
網(wǎng)站建設(shè)哪家好,找創(chuàng)新互聯(lián)建站!專注于網(wǎng)頁設(shè)計、網(wǎng)站建設(shè)、微信開發(fā)、重慶小程序開發(fā)、集團企業(yè)網(wǎng)站建設(shè)等服務(wù)項目。為回饋新老客戶創(chuàng)新互聯(lián)還提供了進賢免費建站歡迎大家使用!
ngIf 指令用于根據(jù)表達式的值,在指定位置渲染 then 或 else 模板的內(nèi)容。
NgIf 指令語法
簡單形式
... ...
使用else塊
......
使用then和else塊
... ...
使用as語法
{{value}}...
NgIf 使用示例
@Component({ selector: 'ng-if-then-else', template: ` show = {{show}}
this is ignoredPrimary text to show Secondary text to show Alternate text while primary text is hidden ` }) class NgIfThenElse implements OnInit { thenBlock: TemplateRef= null; show: boolean = true; @ViewChild('primaryBlock') primaryBlock: TemplateRef = null; @ViewChild('secondaryBlock') secondaryBlock: TemplateRef = null; switchPrimary() { this.thenBlock = this.thenBlock === this.primaryBlock ? this.secondaryBlock : this.primaryBlock; } ngOnInit() { this.thenBlock = this.primaryBlock; } }
基礎(chǔ)知識
TemplateRef
TemplateRef 實例用于表示模板對象,TemplateRef 抽象類的定義如下:
// angular\packages\core\src\linker\template_ref.ts export abstract class TemplateRef{ abstract get elementRef(): ElementRef; abstract createEmbeddedView(context: C): EmbeddedViewRef ; }
ViewContainerRef
ViewContainerRef 實例提供了 createEmbeddedView()
方法,該方法接收 TemplateRef
對象作為參數(shù),并將模板中的內(nèi)容作為容器 (comment 元素) 的兄弟元素,插入到頁面中。
NgIfContext
NgIfContext 實例用于表示 NgIf 上下文。
// angular\packages\common\src\directives\ng_if.ts export class NgIfContext { public $implicit: any = null; public ngIf: any = null; }
NgIf 源碼分析
NgIf 指令定義
@Directive({ selector: '[ngIf]' // 屬性選擇器 -})
NgIf 類私有屬性及構(gòu)造函數(shù)
export class NgIf { // 創(chuàng)建NgIfContext上下文 private _context: NgIfContext = new NgIfContext(); // 表示then模板對象 private _thenTemplateRef: TemplateRef|null = null; // 表示else模板對象 private _elseTemplateRef: TemplateRef |null = null; // 表示根據(jù)then模板創(chuàng)建的EmbeddedViewRef視圖 private _thenViewRef: EmbeddedViewRef |null = null; // 表示根據(jù)else模板創(chuàng)建的EmbeddedViewRef視圖 private _elseViewRef: EmbeddedViewRef |null = null; constructor( private _viewContainer: ViewContainerRef, templateRef: TemplateRef ) { this._thenTemplateRef = templateRef; // then模板的默認值為ngIf指令關(guān)聯(lián)的內(nèi)聯(lián)模板 } }
NgIf 類輸入屬性
@Input() set ngIf(condition: any) { this._context.$implicit = this._context.ngIf = condition; this._updateView(); // 更新視圖 } @Input() set ngIfThen(templateRef: TemplateRef) { this._thenTemplateRef = templateRef; this._thenViewRef = null; // 清除之前創(chuàng)建的視圖 this._updateView(); } @Input() set ngIfElse(templateRef: TemplateRef ) { this._elseTemplateRef = templateRef; this._elseViewRef = null; // 清除之前創(chuàng)建的視圖 this._updateView(); }
_updateView() 私有方法
// 更新視圖 private _updateView() { // this._context.$implicit = this._context.ngIf = condition // 若condition表達式的值為truthy if (this._context.$implicit) { // 若_thenViewRef為null且_thenTemplateRef存在,則創(chuàng)建_thenViewRef內(nèi)嵌視圖 if (!this._thenViewRef) { this._viewContainer.clear(); this._elseViewRef = null; if (this._thenTemplateRef) { this._thenViewRef = this._viewContainer.createEmbeddedView(this._thenTemplateRef, this._context); } } } else { // condition表達式的值為falsy // 若_elseViewRef為null且_elseTemplateRef存在,則創(chuàng)建_elseViewRef內(nèi)嵌視圖 if (!this._elseViewRef) { this._viewContainer.clear(); this._thenViewRef = null; if (this._elseTemplateRef) { this._elseViewRef = this._viewContainer.createEmbeddedView(this._elseTemplateRef, this._context); } } } }
ngIf
指令的源碼相對比較簡單,最核心的是 _updateView()
方法。而該方法中最重要的功能就是如何基于模板對象創(chuàng)建內(nèi)嵌視圖。接下來我們來分析一下 ViewContainerRef
對象的 createEmbeddedView()
方法。
ViewContainerRef - createEmbeddedView()
方法簽名
// angular\packages\core\src\linker\view_container_ref.ts export abstract class ViewContainerRef { /** * 基于TemplateRef對象創(chuàng)建Embedded View(內(nèi)嵌視圖),然后根據(jù)`index`指定的值,插入到容器中。 * 如果沒有指定`index`的值,新創(chuàng)建的視圖將作為容器中的最后一個視圖插入。 */ abstract createEmbeddedView( templateRef: TemplateRef , context?: C, index?: number): EmbeddedViewRef ; }
方法實現(xiàn)
// angular\packages\core\src\view\refs.ts class ViewContainerRef_ implements ViewContainerData { // ... createEmbeddedView( templateRef: TemplateRef , context?: C, index?: number): EmbeddedViewRef { // 調(diào)用TemplateRef對象createEmbeddedView()方法創(chuàng)建EmbeddedViewRef對象 const viewRef = templateRef.createEmbeddedView(context || {}); // 根據(jù)指定的index值,插入到視圖容器中 this.insert(viewRef, index); return viewRef; } } // ViewContainerData接口繼承于ViewContainerRef抽象類 export interface ViewContainerData extends ViewContainerRef { _embeddedViews: ViewData[]; } export interface ViewData { def: ViewDefinition; root: RootData; renderer: Renderer2; parentNodeDef: NodeDef|null; parent: ViewData|null; viewContainerParent: ViewData|null; component: any; context: any; nodes: {[key: number]: NodeData}; state: ViewState; oldValues: any[]; disposables: DisposableFn[]|null; }
通過觀察 ViewContainerRef_
類中的 createEmbeddedView()
方法,我們發(fā)現(xiàn)該方法內(nèi)部是調(diào)用 TemplateRef
對象的 createEmbeddedView()
方法來創(chuàng)建內(nèi)嵌視圖。因此接下來我們再來分析一下 TemplateRef
對象的 createEmbeddedView()
方法。
TemplateRef - createEmbeddedView()
方法簽名
// angular\packages\core\src\linker\template_ref.ts export abstract class TemplateRef{ abstract createEmbeddedView(context: C): EmbeddedViewRef ; }
方法實現(xiàn)
// angular\packages\core\src\view\refs.ts class TemplateRef_ extends TemplateRefimplements TemplateData { // ... createEmbeddedView(context: any): EmbeddedViewRef { return new ViewRef_(Services.createEmbeddedView( this._parentView, this._def, this._def.element !.template !, context)); } } export interface TemplateData extends TemplateRef { _projectedViews: ViewData[]; }
看完上面的源碼,毫無疑問接下來我們要繼續(xù)分析 Services
對象中的 createEmbeddedView()
方法。
Services - createEmbeddedView()
Services 對象定義
// angular\packages\core\src\view\types.ts export const Services: Services = { setCurrentNode: undefined !, createRootView: undefined !, createEmbeddedView: undefined !, createComponentView: undefined !, createNgModuleRef: undefined !, overrideProvider: undefined !, clearProviderOverrides: undefined !, checkAndUpdateView: undefined !, checkNoChangesView: undefined !, destroyView: undefined !, resolveDep: undefined !, createDebugContext: undefined !, handleEvent: undefined !, updateDirectives: undefined !, updateRenderer: undefined !, dirtyParentQueries: undefined !, };
Services 對象初始化
// angular\packages\core\src\view\services.ts export function initServicesIfNeeded() { if (initialized) { return; } initialized = true; const services = isDevMode() ? createDebugServices() : createProdServices(); Services.setCurrentNode = services.setCurrentNode; Services.createRootView = services.createRootView; Services.createEmbeddedView = services.createEmbeddedView; Services.createComponentView = services.createComponentView; Services.createNgModuleRef = services.createNgModuleRef; Services.overrideProvider = services.overrideProvider; Services.clearProviderOverrides = services.clearProviderOverrides; Services.checkAndUpdateView = services.checkAndUpdateView; Services.checkNoChangesView = services.checkNoChangesView; Services.destroyView = services.destroyView; Services.resolveDep = resolveDep; Services.createDebugContext = services.createDebugContext; Services.handleEvent = services.handleEvent; Services.updateDirectives = services.updateDirectives; Services.updateRenderer = services.updateRenderer; Services.dirtyParentQueries = dirtyParentQueries; }
在 initServicesIfNeeded()
方法中,會根據(jù)當(dāng)前所處的模式,創(chuàng)建不同的 Services 對象。接下來 我們直接來看一下 createProdServices()
方法:
function createProdServices() { return { setCurrentNode: () => {}, createRootView: createProdRootView, createEmbeddedView: createEmbeddedView // 省略了其它方法 }
createEmbeddedView() 方法
// angular\packages\core\src\view\view.ts export function createEmbeddedView( parent: ViewData, anchorDef: NodeDef, viewDef: ViewDefinition, context?: any): ViewData { // embedded views are seen as siblings to the anchor, so we need // to get the parent of the anchor and use it as parentIndex. // 創(chuàng)建ViewData對象 const view = createView(parent.root, parent.renderer, parent, anchorDef, viewDef); // 初始化ViewData對象-設(shè)置component及context屬性的值 initView(view, parent.component, context); // 創(chuàng)建視圖中的節(jié)點,即設(shè)置view.nodes數(shù)組的屬性值 // const nodes = view.nodes; for(...) { ...; nodes[i] = nodeData; } createViewNodes(view); return view; }
此時發(fā)現(xiàn)如果完整分析所有的方法,會涉及太多的內(nèi)容。源碼分析就到此結(jié)束,有興趣的讀者請自行閱讀源碼哈(請各位讀者見諒)。接下來我們來總結(jié)一下 createEmbeddedView()
方法調(diào)用流程:
ViewContainerRef_ -> createEmbeddedView() => TemplateRef_ -> createEmbeddedView() => Services -> createEmbeddedView() => Call createEmbeddedView()
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持創(chuàng)新互聯(lián)。