NgxPropertyGrid

A small and simple property grid in angular to view/edit POJOs, excellent if you have a "settings" object you want to give the user to edit (that's why I have created it). Play online.

Dependencies

• angular2+
• ngx-template

Usage

1. Import

   import {PropertyGridModule} from '../components/property-grid';
   
   import {NgxTemplateModule} from 'ngx-template';

2. Getting Started

   • Html
     • Basic

       <ngx-property-grid [width]="'300px'" [options]="editor"></ngx-property-grid>

     • Template

       <ngx-property-grid [width]="'300px'" [options]="editor">
           <ng-template ngxTemplate="text" let-p>
               <input type="text" [value]="p.value" (change)="p.value = $event.target.value">
           </ng-template>
           <ng-template ngxTemplate="color" let-p>
               <input type="color" [value]="p.value" (change)="p.value = $event.target.value">
           </ng-template>
       </ngx-property-grid>

   • Object options

     export class ExampleEditorOptions {
         @meta({name: 'Font', description: 'The font editor to use', componentType: SimpleTextEditorComponent, group: 'Editor', hidden: false})
         font = 'Source Code Pro';
     
         @meta({name: 'Font size', group: 'Editor', type: 'number', valueConvert: parseInt})
         fontSize = 14;
     
         @meta({name: 'Font color', group: 'Editor', type: 'color'})
         fontColor = '#51f41c';
     
         @meta({name: 'jQuery', group: 'Plugins', type: 'checkbox'})
         jQuery = true;
     
         @meta({name: 'modernizr', description: 'Whether or not to include modernizr on the page', group: 'Plugins', type: 'checkbox'})
         modernizr = false;
     
         @meta({
             name: 'Framework',
             description: 'Whether to include any additional framework',
             type: 'options',
             options: ['None', {text: 'AngularJS', value: 'angular'}, {text: 'Backbone.js', value: 'backbone'}]
         })
         framework = 'None';
     }

3. The metadata options declare

   export interface PropertyItemMeta {
       name: string; // The display name of the property in the grid
       description?: string; // A description of the property, will be used as tooltip on an hint element (a span with text "[?]")
       order?: number; // The display order.
       group?: string; //  The group this property belongs to
       hidden?: boolean; // Whether this property should be hidden in the grid, default is false (can be omitted).
       initState?: string; // - hidden/visible.
       componentType?: Type<ControlValueAccessor | ICustomDynamicComponent<any>>; // an custom component should be implement
       // ControlValueAccessor or ICustomDynamicComponent<any>
       componentOptions?: any;
       colSpan2?: boolean; //  - true/false. If true then property input will span both columns and will have no name/label
       // (useful for textarea custom type)
       type?: string; // boolean number options label color
       valueConvert?: (value: any) => any; // convert the value, eg. parseInt
   }

• The result would be (live demo):

The metadata object

As seen from the example above the metadata object can be used (it's optional) in order to describe the object properties. Each proprty in the metadata object could have the following:

• name - The display name of the property in the grid
• description - A description of the property, will be used as tooltip on an hint element (a span with text "[?]")
• hidden - Whether this property should be hidden in the grid, default is false (can be omitted).
• group - The group this property belongs to
• type - The type of the property, supported are:
  • boolean or checkbox - A checkbox would be used
  • number - simple textbox
  • color - simple textbox
  • options - A dropdown list would be used in case the metadata contains the options array property
  • label - A label will be used, useful for uneditable / read-only properties
• componentType - An angular component
• colspan2 - true/false. If true then property input will span both columns and will have no name/label (useful for textarea custom type, see example/index.html)