angular-cn/packages/platform-browser/src/browser/title.ts

/**
 * @license
 * Copyright Google Inc. All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.io/license
 */

import {DOCUMENT} from '@angular/common';
import {Inject, Injectable, Δinject} from '@angular/core';

import {getDOM} from '../dom/dom_adapter';

/**
 * Factory to create Title service.
 */
export function createTitle() {
  return new Title(Δinject(DOCUMENT));
}

/**
 * A service that can be used to get and set the title of a current HTML document.
 *
 * Since an Angular application can't be bootstrapped on the entire HTML document (`<html>` tag)
 * it is not possible to bind to the `text` property of the `HTMLTitleElement` elements
 * (representing the `<title>` tag). Instead, this service can be used to set and get the current
 * title value.
 *
 * @publicApi
 */
@Injectable({providedIn: 'root', useFactory: createTitle, deps: []})
export class Title {
  constructor(@Inject(DOCUMENT) private _doc: any) {}
  /**
   * Get the title of the current HTML document.
   */
  getTitle(): string { return getDOM().getTitle(this._doc); }

  /**
   * Set the title of the current HTML document.
   * @param newTitle
   */
  setTitle(newTitle: string) { getDOM().setTitle(this._doc, newTitle); }
}
chore(lint): Added license headers to most TypeScript files Relates to #9380 2016-06-23 09:47:54 -07:00			`/**`
			`* @license`
			`* Copyright Google Inc. All Rights Reserved.`
			`*`
			`* Use of this source code is governed by an MIT-style license that can be`
			`* found in the LICENSE file at https://angular.io/license`
			`*/`

refactor: move DOCUMENT imports from platform-browser to common (#29237) PR Close #29237 2019-03-11 19:20:40 -05:00			`import {DOCUMENT} from '@angular/common';`
refactor(ivy): migrate ɵɵ prefix back to Δ (#30362) Now that issues are resolved with Closure compiler, we can move back to our desired prefix of `Δ`. PR Close #30362 2019-05-09 11:47:25 -07:00			`import {Inject, Injectable, Δinject} from '@angular/core';`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00
repackaging: all the repackaging changes squashed 2016-04-28 17:50:03 -07:00			`import {getDOM} from '../dom/dom_adapter';`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00
fix(platform-browser): workaround wrong import path generated by ngc for DOCUMENT (#24830) 2018-07-10 17:09:29 -07:00			`/**`
			`* Factory to create Title service.`
			`*/`
			`export function createTitle() {`
refactor(ivy): migrate ɵɵ prefix back to Δ (#30362) Now that issues are resolved with Closure compiler, we can move back to our desired prefix of `Δ`. PR Close #30362 2019-05-09 11:47:25 -07:00			`return new Title(Δinject(DOCUMENT));`
fix(platform-browser): workaround wrong import path generated by ngc for DOCUMENT (#24830) 2018-07-10 17:09:29 -07:00			`}`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			`/**`
			`* A service that can be used to get and set the title of a current HTML document.`
			`*`
docs: branding fixes (#14132) Angular 1.x -> AngularJS Angular 1 -> AngularJS Angular1 -> AngularJS Angular 2+ -> Angular Angular 2.0 -> Angular Angular2 -> Angular I have deliberately not touched any of the symbol names as that would cause big merge collisions with Tobias's work. All the renames are in .md, .json, and inline comments and jsdocs. PR Close #14132 2017-01-26 22:30:42 -08:00			* Since an Angular application can't be bootstrapped on the entire HTML document (`<html>` tag)
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			* it is not possible to bind to the `text` property of the `HTMLTitleElement` elements
			* (representing the `<title>` tag). Instead, this service can be used to set and get the current
			`* title value.`
docs(webworkers): add experimental markers for all web worker public apis 2016-06-15 08:41:41 -07:00			`*`
docs: convert all `@experimental` tags to `@publicApi` tags (#26595) PR Close #26595 2018-10-19 12:12:20 +01:00			`* @publicApi`
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			`*/`
fix(platform-browser): workaround wrong import path generated by ngc for DOCUMENT (#24830) 2018-07-10 17:09:29 -07:00			`@Injectable({providedIn: 'root', useFactory: createTitle, deps: []})`
refactor(render): ts’ify render api 2015-05-18 11:57:20 -07:00			`export class Title {`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00			`constructor(@Inject(DOCUMENT) private _doc: any) {}`
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			`/**`
			`* Get the title of the current HTML document.`
			`*/`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00			`getTitle(): string { return getDOM().getTitle(this._doc); }`
refactor(render): ts’ify render api 2015-05-18 11:57:20 -07:00
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			`/**`
			`* Set the title of the current HTML document.`
			`* @param newTitle`
			`*/`
feat(platform-server): add API to render Module and ModuleFactory to string (#14381) - PlatformState provides an interface to serialize the current Platform State as a string or Document. - renderModule and renderModuleFactory are convenience methods to wait for Angular Application to stabilize and then render the state to a string. - refactor code to remove defaultDoc from DomAdapter and inject DOCUMENT where it's needed. 2017-02-14 16:14:40 -08:00			`setTitle(newTitle: string) { getDOM().setTitle(this._doc, newTitle); }`
refactor(render): ts’ify render api 2015-05-18 11:57:20 -07:00			`}`