2017-03-26 13:32:29 -07:00
|
|
|
import { Component, ElementRef, ViewChild, OnChanges, OnDestroy, Input } from '@angular/core';
|
|
|
|
import { Logger } from 'app/shared/logger.service';
|
|
|
|
import { PrettyPrinter } from './pretty-printer.service';
|
|
|
|
import { CopierService } from 'app/shared/copier.service';
|
|
|
|
|
|
|
|
const originalLabel = 'Copy Code';
|
|
|
|
const copiedLabel = 'Copied!';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Formatted Code Block
|
|
|
|
*
|
|
|
|
* Pretty renders a code block, used in the docs and API reference by the code-example and
|
|
|
|
* code-tabs embedded components.
|
|
|
|
* It includes a "copy" button that will send the content to the clipboard when clicked
|
|
|
|
*
|
|
|
|
* Example usage:
|
|
|
|
*
|
|
|
|
* ```
|
|
|
|
* <aio-code [code]="variableContainingCode" [language]="ts" [linenums]="true"></aio-code>
|
|
|
|
* ```
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
@Component({
|
|
|
|
selector: 'aio-code',
|
|
|
|
template: `
|
2017-03-27 15:37:11 -07:00
|
|
|
|
2017-03-26 13:32:29 -07:00
|
|
|
<pre class="prettyprint lang-{{language}}">
|
2017-03-28 17:15:02 -07:00
|
|
|
<button class="material-icons copy-button" (click)="doCopy()">content_copy</button>
|
2017-03-26 13:32:29 -07:00
|
|
|
<code class="animated fadeIn" #codeContainer></code>
|
|
|
|
</pre>
|
|
|
|
`
|
|
|
|
})
|
|
|
|
export class CodeComponent implements OnChanges {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The language of the code to render
|
|
|
|
* (could be javascript, dart, typescript, etc)
|
|
|
|
*/
|
|
|
|
@Input()
|
|
|
|
language: string;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether to display line numbers:
|
|
|
|
* - false: don't display
|
|
|
|
* - true: do display
|
|
|
|
* - number: do display but start at the given number
|
|
|
|
*/
|
|
|
|
@Input()
|
|
|
|
linenums: boolean | number | string;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The code to be formatted, this should already be HTML encoded
|
|
|
|
*/
|
|
|
|
@Input()
|
|
|
|
code: string;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The label to show on the copy button
|
|
|
|
*/
|
|
|
|
buttonLabel = originalLabel;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The element in the template that will display the formatted code
|
|
|
|
*/
|
|
|
|
@ViewChild('codeContainer') codeContainer: ElementRef;
|
|
|
|
|
|
|
|
constructor(
|
|
|
|
private pretty: PrettyPrinter,
|
|
|
|
private copier: CopierService,
|
|
|
|
private logger: Logger) {}
|
|
|
|
|
|
|
|
ngOnChanges() {
|
|
|
|
if (!this.code) { return; }
|
|
|
|
|
|
|
|
const linenums = this.getLinenums();
|
|
|
|
|
|
|
|
this.setCodeHtml(this.code); // start with unformatted code
|
|
|
|
this.pretty.formatCode(this.code, this.language, linenums).subscribe(
|
|
|
|
formattedCode => this.setCodeHtml(formattedCode),
|
|
|
|
err => { /* ignore failure to format */ }
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
private setCodeHtml(formattedCode: string) {
|
|
|
|
// **Security:** `codeExampleContent` is provided by docs authors and as such its considered to
|
|
|
|
// be safe for innerHTML purposes.
|
|
|
|
this.codeContainer.nativeElement.innerHTML = formattedCode;
|
|
|
|
}
|
|
|
|
|
|
|
|
doCopy() {
|
|
|
|
// We take the innerText because we don't want it to be HTML encoded
|
|
|
|
const code = this.codeContainer.nativeElement.innerText;
|
|
|
|
if (this.copier.copyText(code)) {
|
|
|
|
this.logger.log('Copied code to clipboard:', code);
|
|
|
|
// change the button label (for one second)
|
|
|
|
this.buttonLabel = copiedLabel;
|
|
|
|
setTimeout(() => this.buttonLabel = originalLabel, 1000);
|
|
|
|
} else {
|
|
|
|
this.logger.error('ERROR copying code to clipboard:', code);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
getLinenums() {
|
|
|
|
const linenums =
|
|
|
|
typeof this.linenums === 'boolean' ? this.linenums :
|
|
|
|
this.linenums === 'true' ? true :
|
|
|
|
this.linenums === 'false' ? false :
|
|
|
|
typeof this.linenums === 'string' ? parseInt(this.linenums, 10) :
|
|
|
|
this.linenums;
|
|
|
|
|
|
|
|
// if no linenums, enable line numbers if more than one line
|
|
|
|
return linenums == null || linenums === NaN ?
|
|
|
|
(this.code.match(/\n/g) || []).length > 1 : linenums;
|
|
|
|
}
|
|
|
|
}
|