0.0.8 • Published 5 years ago

ngx-syntax-highlighter v0.0.8

Weekly downloads
1
License
MIT
Repository
github
Last release
5 years ago

Installing

$ npm install --save ngx-syntax-highlighter

Brief description on Highlight.js

Highlight.js will give you syntax highlighting but will not format your code. When adding syntax styling Highlight.js will auto detect the language based on the current array of languages in it's memory. This array of languages is configurable. It is not recommended you load ALL languages as there are 185 supported lanuages; however if you don't care about the binary size you can do this. Currently only one syntax style can be loaded at a single time, however you can change these on the fly.

More info here on Highlight.js

Start

Import NgxHighlightJsModule module in app.module or core.module.

import { NgxHighlightJsModule } from 'ngx-syntax-highlighter'

(...)

@NgModule({
  (...)
  imports: [
    NgxHighlightJsModule.forRoot()
  ]
  (...)
})

Or specify options

import {
  HighlightJsConfig,
  Language,
  NgxHighlightJsModule,
  SyntaxStyle
  } from 'ngx-syntax-highlighter';

const highlightJsConfig: HighlightJsConfig = {
  style: SyntaxStyle['AN-OLD-HOPE'],
  languages: [Language.TYPESCRIPT, Language.JAVASCRIPT]
  // languages: 'all'
};

@NgModule({
  (...)
  imports: [
    NgxHighlightJsModule.forRoot(highlightJsConfig)
  ]
  (...)
})

HighlightJsConfig

propertyvaluedescription
stylenullNo syntax style specified will use default (GITHUB)
SyntaxStyle'STYLE'All supported styles listed in enum. Intellisense will ensure you select a valid style.
~
languagesnullNone specified means you will supply a language later in the component.
Language[]Array of languages which will be loaded on init. Can still specify languages later in component.
'all'Will load Highlight.js with all languages. This is the simplest solution but also will generate the largest binary.

More Config Examples

Note: Configuring in the Module import is optional.

// Style and Language Configured
const highlightJsConfig: HighlightJsConfig = {
  style: SyntaxStyle['AN-OLD-HOPE'],
  languages: [Language.TYPESCRIPT]
};

// Only configure language
const highlightJsConfig: HighlightJsConfig = {
  languages: [Language.TYPESCRIPT]
};

// Only configure style
const highlightJsConfig: HighlightJsConfig = {
  style: SyntaxStyle['AN-OLD-HOPE'],
};

// Load all languages and style
const highlightJsConfig: HighlightJsConfig = {
  style: SyntaxStyle.GITHUB,
  languages: 'all'
};

// In your App.Module or Core.Module
imports: [
  NgxHighlightJsModule.forRoot(highlightJsConfig)
]

Syntax Highlighter Component

To highlight a block of code use the below component in your component.html

<ngx-syntax-highlighter
    [language]="languages.CS"
    [style]="syntaxStyle.VS"
    [code]="csharp"
  ></ngx-syntax-highlighter>

OR if you setup the language and style in the module import you can just pass in the code

<ngx-syntax-highlighter [code]="csharp"></ngx-syntax-highlighter>

In your component.ts

import { Language, SyntaxStyle } from 'ngx-syntax-highlighter';
export class AppComponent {
  syntaxStyle = SyntaxStyle;
  languages = Language;
  csharp = `class Program
      {
          static void Main()
          {
              string[] pets = { "dog", "cat", "bird" };

              // ... Loop with the foreach keyword.
              foreach (var value in pets)
              {
                  Console.WriteLine(value);
              }
          }
      }
    `;
}

Force Language

If Highlight.js isn't recognizing the correct language or incorrectly recognizing the language, then use the forceLanguage attribute. Make sure you also specify the language too.

<ngx-syntax-highlighter 
  [language]="languages.BASH" 
  [code]="bash" 
  [forceLanguage]="true">
</ngx-syntax-highlighter>
0.0.8

5 years ago

0.0.7

5 years ago

0.0.6

5 years ago

0.0.5

5 years ago

0.0.4

5 years ago

0.0.3

5 years ago

0.0.2

5 years ago

0.0.1

5 years ago