angular-exemplify

Angular Exemplify

A simple directive for adding code examples based on actual code and markup! Just add AddExample to your element and you're done:D

View example

Dependencies

• Prism - for highlighting (optional)
• Bootstrap4 - for basic styling (optional)

Please note that you don't have to use prism and/or bootstrap with angular exemplify although it's recommended.

Installation and usage

Run npm install --save angular-exemplify

If you want to use together with prism

Run npm install prismjs

If you want to use together with bootstrap 4

Run npm install bootstrap@4.0.0-alpha.5

Usage in angular-cli project

Please note the instructions below are for projects based on angular-cli, you might need to set up things differently if you're using something else.

Include scripts and styles in build

If you want to use angular exemplify together with prism, make sure to add the prism script and one of the prism theme css files to your angular-cli.json config, bootstrap.css is optional:

"styles": [
  "../node_modules/bootstrap/dist/css/bootstrap.css",
  "../node_modules/prismjs/themes/prism-coy.css",
  "styles.css"
],
"scripts": [
  "../node_modules/prismjs/prism.js"
],

Import ExemplifyModule

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { HttpModule } from '@angular/http';
import { AppComponent } from './app.component';
import { ExemplifyModule } from "../exemplify/exemplify.module";

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    FormsModule,
    HttpModule,
    ExemplifyModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Basic usage

Add AddExample to your element like this:

<button AddExample class="btn btn-primary" (click)="doSomething()">Action</button>

View demo for live preview and more examples.

Options

Attribute	Type	Usage/description	Default
target	element	attach example to this element, use local variable	directive element
source	string	where to get the markup, 'element' or its 'child'	'element'
customClass	string	class name added to the directive element
externalSources	array	an array of objects specifying external soruces
usePrism	boolean	highlight code examples using prismjs (prismjs has to be included)	true
navStyle	string	customize the style of the nav links, possible values are "tabs", "pills", "inline" see bootstrap for more info.	'inline'
keepInputs	boolean	keep attributes attached to the directive element	false

Using external sources

To keep the examples in sync with your code you should reference the source files. Here's an example based on a app published and deployed to github pages.

externalSources = [{
    name:'app.module.ts',
    src:'https://raw.githubusercontent.com/hjalmers/angular-markup-example/master/src/app/app.module.ts'
  },{
    name:'app.component.ts',
    src:'https://raw.githubusercontent.com/hjalmers/angular-markup-example/master/src/app/app.component.ts'
  },{
    name:'app.component.css',
    src:'https://raw.githubusercontent.com/hjalmers/angular-markup-example/master/src/app/app.component.css',
    language:'css'
  }]