grunt-openui5

grunt-openui5

Grunt tasks around OpenUI5

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-openui5 --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-openui5');

"openui5_theme" task

Overview

Builds a theme and creates the following files in the dest directory of the specified less file

• library.css (regular css)
• library-RTL.css (mirrored css for right-to-left support)
• library-parameters.json (key-value map of all global less variables)

Options

rootPaths

Type: array of string

Root paths to use for import directives.

This option differs from the parser.paths option.
It is useful if less files are located in separate folders but referenced as they would all be in one.
If rootPaths are provided and a file can not be found, the parser.paths option will be used instead.

parser

Type: object

Options for the less parser (less.Parser).

compiler

Type object

Options for the less compiler (tree.toCss).

Usage Examples

Default Options

grunt.initConfig({
  openui5_theme: {
    options: {},
    files: [
      {
        expand: true,
        cwd: 'lib1',
        src: 'my/ui/lib/themes/foo/library.source.less',
        dest: 'tmp'
      }
    ]
  },
});

Creates the following files

• tmp/my/ui/lib/themes/foo/library.css
• tmp/my/ui/lib/themes/foo/library-RTL.css
• tmp/my/ui/lib/themes/foo/library-parameters.json

Custom Options

If import directives are used to import files from other src folders, the root paths should be defined.
The compress option can be used to minify the output css/json.

grunt.initConfig({
  openui5: {
    options: {
      rootPaths: [
        'lib1',
        'lib2'
      ],
      compiler: {
        compress: true
      }
    },
    files: [
      {
        expand: true,
        cwd: 'lib2',
        src: 'my/ui/lib/themes/bar/library.source.less',
        dest: 'tmp'
      }
    ]
  },
});

Creates the following files

• tmp/my/ui/lib/themes/bar/library.css
• tmp/my/ui/lib/themes/bar/library-RTL.css
• tmp/my/ui/lib/themes/bar/library-parameters.json

"openui5_library_preload" task

Overview

Creates a "library-preload.json" file which contains all files/modules specified in the task configuration.

Options

libraryName

Type: string

Name of the library (e.g. foo.bar)

dest

Type: string
Default value: .

Path to the dest folder in which the preload file should be created. All other dest paths (from the files configuration) will be ignored.

Usage Examples

grunt.initConfig({
  openui5_library_preload: {
    options: {
      libraryName: 'my.ui.lib',
      dest: 'tmp'
    },
    files: [
      {
        expand: true,
        cwd: 'lib1',
        src: 'my/ui/lib/**/*.{js,json,xml}'
      }
    ]
  },
});

Creates

• tmp/my/ui/lib/library-preload.json

Contributing

See CONTRIBUTING.md.