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 {Inject, Injectable} from '@angular/core';

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


/**
 * 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.
 *
 * @experimental
 */
@Injectable({providedIn: 'root'})
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`
			`*/`

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			`import {Inject, Injectable} from '@angular/core';`

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			`import {DOCUMENT} from '../dom/dom_tokens';`


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			`*`
			`* @experimental`
docs(Title): add documentation for the Title service Closes #3063 2015-07-15 12:07:02 +02:00			`*/`
fix(platform-browser): mark Meta and Title services as tree shakable providers (#24815) This lets services that use Meta and Title services to be tree shakable and provided in root. PR Close #24815 2018-07-10 08:26:48 -07:00			`@Injectable({providedIn: 'root'})`
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			`}`