@acpaas-ui/ngx-context 中文文档教程

发布于 3年前 浏览 10 更新于 3年前

@acpaas-ui/ngx-context

这个包管理元标签和其他 SEO 属性。

Usage

import { ContextModule, ContextService } from '@acpaas-ui/ngx-context';

Documentation

访问我们的文档网站获取完整的操作文档和指南

Different ways to set tags and other SEO properties.

Set defaults

您可以使用 forRoot() 选项:

API

NameDefault valueDescription
useTitleSuffix: boolean;falseAdd an optional title suffix.
extendTitle: boolean;falseAppend parent page titles (when using router context).
titleDelimiter: string;'|'The separator to use when extendTitle is true.
defaults: Context;{}Default values for the meta tags. Have a look at the list down below for an overview of possible tags.
routerContext: boolean;trueListen for meta data on the route changes.

Example

@NgModule({
    imports: [
        ContextModule.forRoot({
            useTitleSuffix: true,
            extendTitle: true,
            titleDelimiter: ' | ',
            defaults: {
                titleSuffix: 'Context Module',
            },
            routerContext: true,
        }),
    ]
})
Set tags on routes

您可以使用 data 属性在路由上设置标签。 ContextService 将订阅路由器并自动获取这些标签。

export const CONTEXT_EXAMPLES_ROUTES: Routes = [
    {
        path: '',
        component: ContextDemoPageComponent,
        pathMatch: 'full',
        data: {
            meta: {
                page: 'Context example page',
                title: 'Context',
                description: 'Description of the context example page',
                metatags: 'Antwerp UI, Angular, context',
            },
        },
    },
];
Set tags on routes

您也可以使用 loadContext 方法在您的组件中手动设置标签。 这对于异步数据或通用路由很有用。

import { ContextService } from '@acpaas-ui/ngx-context';

@Component({
    providers: [
        ContextService,
    ],
})

export class ContextDemoPageComponent {
    constructor(private contextService: ContextService) {}

    public setTitle() {
        this.contextService.updateContext({
            title: 'New context example title',
        });
    }
}
<button class="a-button" (click)="setTitle()">Set title</button>

Default available tags

Context 界面中提供了最常用的标签。 但是,您可以自由使用格式为 [key: string]: string; 的任何标签。

  • title
  • titleSuffix
  • description
  • favIcon
  • og:url
  • og:type
  • og:title
  • og:description
  • og:image
  • fb:app_id
  • og:locale
  • og:locale:alternate
  • og:see_also
  • og:updated_time
  • twitter:card
  • twitter:site
  • twitter:creator

Contributing

请访问我们的贡献指南,了解有关如何贡献的更多信息。

@acpaas-ui/ngx-context

This package manages meta tags and other SEO properties.

Usage

import { ContextModule, ContextService } from '@acpaas-ui/ngx-context';

Documentation

Visit our documentation site for full how-to docs and guidelines

Different ways to set tags and other SEO properties.

Set defaults

You can set defaults and other options for the module by using the forRoot() option in the import section:

API

NameDefault valueDescription
useTitleSuffix: boolean;falseAdd an optional title suffix.
extendTitle: boolean;falseAppend parent page titles (when using router context).
titleDelimiter: string;'|'The separator to use when extendTitle is true.
defaults: Context;{}Default values for the meta tags. Have a look at the list down below for an overview of possible tags.
routerContext: boolean;trueListen for meta data on the route changes.

Example

@NgModule({
    imports: [
        ContextModule.forRoot({
            useTitleSuffix: true,
            extendTitle: true,
            titleDelimiter: ' | ',
            defaults: {
                titleSuffix: 'Context Module',
            },
            routerContext: true,
        }),
    ]
})
Set tags on routes

You can set tags on routes using the data property. The ContextService will subscribe to the router and pick up these tags automatically.

export const CONTEXT_EXAMPLES_ROUTES: Routes = [
    {
        path: '',
        component: ContextDemoPageComponent,
        pathMatch: 'full',
        data: {
            meta: {
                page: 'Context example page',
                title: 'Context',
                description: 'Description of the context example page',
                metatags: 'Antwerp UI, Angular, context',
            },
        },
    },
];
Set tags on routes

You can set tags manually in your components using the loadContext method as well. This is useful for async data or generic routes.

import { ContextService } from '@acpaas-ui/ngx-context';

@Component({
    providers: [
        ContextService,
    ],
})

export class ContextDemoPageComponent {
    constructor(private contextService: ContextService) {}

    public setTitle() {
        this.contextService.updateContext({
            title: 'New context example title',
        });
    }
}
<button class="a-button" (click)="setTitle()">Set title</button>

Default available tags

The most used tags are available in the Context interface. You are however, free to use whichever tag you need in the format [key: string]: string;.

  • title
  • titleSuffix
  • description
  • favIcon
  • og:url
  • og:type
  • og:title
  • og:description
  • og:image
  • fb:app_id
  • og:locale
  • og:locale:alternate
  • og:see_also
  • og:updated_time
  • twitter:card
  • twitter:site
  • twitter:creator

Contributing

Visit our Contribution Guidelines for more information on how to contribute.

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文