Giter Club home page Giter Club logo

brig-module's Introduction

brig-module

Module framework for brig, to let developer implement own module for brig easily.

NPM NPM

Installation

Install module via NPM

npm install brig-module

Create Your NPM module for brig

With brig-module, you can create useful brig module which can be packaged and published to NPM server.

First Step

The first step is making preparation for your own NPM package. Create a project which includes structure:

  • types/
    • MyItem.js
  • index.js
  • package.json
  • README.md

Note that: If you don't know how to package a NPM module, please go to NPM official website to learn more.

Second Step

The entry of this NPM module is index.js, it should contains:

index.js

var BrigModule = require('brig-module');

var brigModule = new BrigModule();

brigModule.addType(require('./types/MyItem'));

module.export = brigModule;

Third Step: Create customized type

Implement your QML type by using BrigModule.TypePrototype.

types/MyItem.js

var BrigModule = require('brig-module');

// Create prototype of type named MyItem
var proto = module.exports = new BrigModule.TypePrototype('MyItem');

// This type has a property named msg, which has default value.
proto.defineProperty('msg', 'hello');

// This type has a method named sum, which has two parameters
proto.defineMethod('sum(a,b)', function(a, b) {
	return a + b;
});

// instance of type was created
proto.on('instance-created', function(instance) {

	instance.on('msgChanged', function() {
    console.log('msg was changed, new value is ' + insntace.getProperty('msg'));
	});

});

Fourth Step: Package and publish your module

Now you can package your brig module which contains your customized type. Using NPM command to make a link or upload package to NPM server.

npm publish

Fifth Step: Using your module and customized QML type in your application

Load your module in your brig application:

app.js

const Brig = require('brig');
const brigMyItem = require('brig-myitem');

const brig = new Brig();

brig.on('ready', (brig) => {

  // Load your module
  brig.loadModule(brigMyItem);
  
  brig.open('Application.qml', (err, window) => {
    // You have a window here
  });
});

Then your customized QML type can be used in QML enviromnet:

Application.js

import QtQuick 2.3
import QtQuick.Controls 2.0
import Brig.MyItem 1.0

ApplicationWindow {
	visible: true;
	color: 'black';
	title: 'My Application';
	width: 1280;
	height: 768;

	MyItem {
		id: myItem;
		msg: 'new msg';
	}
  
	Component.onCompleted: {
		var ret = myItem.sum(1, 2);
		console.log(ret);
	}
}

License

Licensed under the MIT License

Authors

Copyright(c) 2017 Fred Chien <[email protected]>

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.