feat(module:cdkconnectedoverlay): supports disabling click on mask

[OriginRing]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/NG-ZORRO/ng-zorro-antd/blob/master/CONTRIBUTING.md#commit
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Documentation content changes
• Application (the showcase website) / infrastructure changes
• Other... Please describe:

What is the current behavior?

Issue Number: N/A

What is the new behavior?

Does this PR introduce a breaking change?

• Yes
• No

Other information

[zorro-bot]

This preview will be available after the AzureCI is passed.

[codecov]

Codecov Report

Attention: Patch coverage is 83.33333% with 1 line in your changes missing coverage. Please review.

Project coverage is 91.84%. Comparing base (472bb34) to head (90214cb).
Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
components/tooltip/base.ts	83.33%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #8878      +/-   ##
==========================================
- Coverage   91.88%   91.84%   -0.04%     
==========================================
  Files         537      537              
  Lines       18453    18473      +20     
  Branches     2814     2816       +2     
==========================================
+ Hits        16955    16966      +11     
- Misses       1196     1205       +9     
  Partials      302      302              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Laffery]

1 comments, and please add unit tests

[Laffery]

There are two ways that invoke hide() method:

Take nz-popconfirm for an example,

1. click outside overlay
2. overlay detachments

<ng-template
      #overlay="cdkConnectedOverlay"
      cdkConnectedOverlay
      nzConnectedOverlay
      [cdkConnectedOverlayHasBackdrop]="nzBackdrop"
      [cdkConnectedOverlayOrigin]="origin"
      (overlayOutsideClick)="onClickOutside($event)"
      (detach)="hide()"
      (positionChange)="onPositionChange($event)"
      [cdkConnectedOverlayPositions]="_positions"
      [cdkConnectedOverlayOpen]="_visible"
      [cdkConnectedOverlayPush]="cdkConnectedOverlayPush"
      [nzArrowPointAtCenter]="nzArrowPointAtCenter"
    >
...
</ng-template>

If skip hiding the popconfirm here, the overlay detachments will not hide the popconfirm correctly.

So what about adding this condition at the onClickOutside method?

onClickOutside(event: MouseEvent): void {
+	if (!this.nzOverlayClickable) {
+		return;
+	}

  const target = _getEventTarget(event);
  if (!this.origin.nativeElement.contains(target) && this.nzTrigger !== null) {
    this.hide();
  }
}