feat(module:util): export stringTemplateOutlet (#324)

packages/util/public_api.ts

@@ -1,3 +1,4 @@
+export * from './src/addon/string_template_outlet';
 export * from './src/string/string';
 
 export * from './src/time/time';

packages/util/src/addon/index.en-US.md

@@ -0,0 +1,36 @@
+---
+title: stringTemplateOutlet
+subtitle: String Template Outlet
+type: Template
+---
+
+Simplify the use of string and embedded view template.
+
+## DEMO
+
+Build a `page-title` component and provide a `title` property, such as:
+
+```html
+<page-title title="Starbucks"></page-title>
+
+<page-title [title]="ptTitleTpl">
+ <ng-template #ptTitleTpl>
+ <a class="text-success" href="https://www.starbucks.com/" target="_blank">Starbucks</a>
+ </ng-template>
+</page-title>
+```
+
+Use `stringTemplateOutlet` to simplify the `title` property of the `page-title` component.
+
+```ts
+@Component({
+ selector: 'page-title',
+ template: `
+ <ng-template *stringTemplateOutlet="title">{{title}}</ng-template>
+ `
+})
+export class PageTitleComponent {
+ @Input() title: string | TemplateRef<void>;
+}
+```
+

packages/util/src/addon/index.zh-CN.md

@@ -0,0 +1,36 @@
+---
+title: stringTemplateOutlet
+subtitle: 字符串模板占位符
+type: Template
+---
+
+简化字符串与嵌入式视图模板的使用方式。
+
+## 示例
+
+构建一个 `page-title` 组件，并提供 `title` 属性，比如：
+
+```html
+<page-title title="星巴克"></page-title>
+
+<page-title [title]="ptTitleTpl">
+ <ng-template #ptTitleTpl>
+ <a class="text-success" href="https://www.starbucks.com/" target="_blank">星巴克</a>
+ </ng-template>
+</page-title>
+```
+
+利用 `stringTemplateOutlet` 可以简化实现 `page-title` 组件的 `title` 属性。
+
+```ts
+@Component({
+ selector: 'page-title',
+ template: `
+ <ng-template *stringTemplateOutlet="title">{{title}}</ng-template>
+ `
+})
+export class PageTitleComponent {
+ @Input() title: string | TemplateRef<void>;
+}
+```
+

src/site.config.js

@@ -356,6 +356,10 @@ module.exports = {
  'zh-CN': '类型',
  'en-US': 'Type',
  },
+ {
+ 'zh-CN': '模板',
+ 'en-US': 'Template',
+ },
  ],
  module: '@delon/util',
  defaultRoute: 'getting-started',