Lightweightform/core

This package provides the core functionality for Lightweightform, barren of all theme-related logic. This package may be used on its own but its mostly useful when used together with a Lightweightform theme package such as the officially provided Bootstrap theme.

In particular, this package provides:

• Angular services for interacting with a Lightweightform application:
  • A storage service to interact with the application's schema and value (an extended instance of the storage provided by @lightweightform/storage).
  • A router service built on top of the Angular router: used to navigate to routes that can be associated with storage values.
  • A file storage service to allow saving the application's current value to a file, or loading the application's value given a file.
  • An internationalisation service that interacts well with the application's storage.
• Utility directives/classes used to help build Lightweightform themes.

Example setup

import { NgModule } from '@angular/core';
import { RouterModule } from '@angular/router';
import {
  I18nLanguages,
  LF_APP_I18N,
  LF_APP_SCHEMA,
  LF_I18N_LANGUAGE_QUERY_PARAM,
  LF_ROUTER_BASE_PATH,
  LfFileStorage,
  LfI18n,
  LfRouter,
  LfRoutes,
  LfSerializer,
  LfStorage,
  LfUnloadAlert,
} from '@lightweightform/core';
import { recordSchema, RecordSchema } from '@lightweightform/storage';

// Application schema
export const schema: RecordSchema = recordSchema({
  /*...*/
});
// Application routes
export const routes: LfRoutes = {
  /*...*/
};
// Application i18n
export const i18n: I18nLanguages = {
  /*...*/
};

@NgModule({
  imports: [
    /*...*/
    RouterModule.forRoot(routes),
  ],
  providers: [
    LfStorage,
    LfI18n,
    LfFileStorage,
    LfUnloadAlert,
    LfRouter,
    { provide: LF_APP_SCHEMA, useValue: schema },
    { provide: LF_ROUTER_BASE_PATH, useValue: '/' },
    { provide: LF_APP_I18N, useValue: i18n },
    { provide: LF_I18N_LANGUAGE_QUERY_PARAM, useValue: 'l' },
    { provide: LF_ROUTER_BASE_PATH, useValue: '/' },
  ],
})
export class AppModule {}

Documentation

All Lightweightform documentation is available at: https://docs.lightweightform.io.

The @lightweightform/core API is available at: https://docs.lightweightform.io/api/core.

Browser support

• Internet Explorer: 9+ (requires at least Map and Array.from polyfills)
• Other browsers: Latest 2 versions