CSS and HTML are boring and lame. And they suck at designing cool, interactive interfaces. Qt came up with a much better answer for its renowned framework: QML, a declarative language perfect for designing UIs (and much more). Here's a sample of how QML looks like:
import QtQuick 2.0
Rectangle {
width: 500; height: 200
color: "lightgray"
Text {
id: helloText
text: "Hello world!"
anchors.verticalCenter: parent.verticalCenter
anchors.horizontalCenter: parent.horizontalCenter
font.pointSize: 24; font.bold: true
}
}This project aims at bringing the power of QML to the web browser.
This is a fork from git://anongit.kde.org/qmlweb in Webapps written in qml not far from reality anymore
Download the file lib/qt.js and preload it in an HTML page.
<script type="text/javascript" src="/lib/qt.js"></script>You may then modify the <body> element to specify what QML file to load when the page is opened.
<body style="margin: 0;" data-qml="qml/main.qml">Note that for the following, you need to have NodeJS installed.
You can use Gulp to pre-parse your QML files and pre-load them in your javascript file. First, you'll need to install the dependencies. Create a package.json file such as this one:
{
"name": "QmlWebClient",
"devDependencies": {
"gulp": "~3.6.0",
"gulp-concat": "~2.1.7",
"gulp-util": "~2.2.14",
"gulp-uglify": "~0.2.1",
"gulp-qml": "git://github.com/Plaristote/qmlweb.git"
}
}Now run the command npm install to have node.js install your dependencies, and start writing your Gulpfile.js :
var gulp = require('gulp');
var concat = require('gulp-concat');
var qml = require('QMLWeb');
var qmlFiles = [ 'qml/**/*.qml', 'qml/**/*.js' ];
var jsFiles = [ 'lib/qt.js', 'lib/qrc.js' ];
gulp.task('default', ['qml', 'application'], function() {
gulp.watch(qmlFiles, ['qml']);
gulp.watch(jsFiles, ['application']);
});
// Parses your qml and javascript source files
gulp.task('qml', function() {
return gulp.src(qmlFiles).pipe(qml()).pipe(concat('qrc.js')).pipe(gulp.dest('./lib'));
});
// Merge 'qt.js' with your compiled QML files and outputs it in app/QtApplication.js
gulp.task('application', function() {
return gulp.src(jsFiles).pipe(concat('QtApplication.js')).pipe(gulp.dest('./app'));
});Now, you may run the script by running the gulp command: the qml files in the ./qml folder will be directly pre-loaded in your QtApplication.js file.
When implementing new features, you may need to get away from QML and create your own QML components from scratch, using directly the engine's API.
registerQmlType({
module: 'MyModule',
name: 'MyTypeName',
versions: /^1(\.[0-3])?$/, // that regexp must match the version number for the import to work
constructor: function(meta) {
QMLItem.call(this, meta);
var self = this;
// Managing properties
createSimpleProperty("string", this, "name"); // creates a property 'name' of type string
createSimpleProperty("var", this, "data"); // creates a property 'data' of undefined type
this.name = 'default name'; // sets a default value for the property 'name'
// Signals
this.somethingHappened = Signal(); // creates a signal somethingHappened
this.somethingHappened.connect(this, function() {
console.log('You may also connect to signals in Javascript');
});
// Using the DOM
function updateText() {
var text = '';
for (var i = 0 ; i < self.data.length ; ++i)
text += '[' + data[i] + '] ';
self.dom.textContent = text; // Updating the dom
self.somethingHappened(); // triggers the 'somethingHappened' signal.
}
// Run updateText once, ensure it'll be executed whenever the 'data' property changes.
updateText();
this.onDataChanged.connect(this, updateText);
}
});And here's how you would use that component in a regular QML file:
import MyModule 1.3
MyTypeName {
name: 'el nombre'
data: [ 1, 2, 3 ]
onSomethingHappened: console.log(data)
}-
QML Types are now registered into different modules. They're only made available once their module has been required (e.g: can't use Rectangle unless there's an
import QtQuick). Versions can also be matched by the types when they're registered, to allow people to implement different behaviors for different versions of the same module. -
It is now possible to import javascript files in a QML file.
Implemented a Gulp module that:
- parses QML file and store the parsed tree in a
qrcobject. - detect symbols from JS files and store the result and source in a
qrcobject. - don't use any HTTP request to load qml/js files if they are already in
qrc.
- Video (QtMultimedia)
- GeoLocation (QtMobility)
- RegExpValidator (QtQuick)
- IntValidator (QtQuick)
- DoubleValidator (QtQuick)
- Settings (Qt.labs.settings)
- SystemPalette (QtQuick)
- TextInput supports properties focus, maximumLength, readOnly, validator, [partially] echoMode
- Image supports property mirror, supports fill modes PreserveAspectFit, PreserveAspectCrop, Tile, TileVertically
- Unit Testing for each Components using Jasmine
- Improve the implementation of
focus, use it to implementsKeysandFocusScope - Implement Gradient and GradientStop using CSS3
- Implement StateGroup, StateChangeScript, ParentChange, AnchorChange
- Implement ListView, GridView, PathView
- Implement QtQuick.Controls (Action, ProgressBar, Label, ComboBox, ExclusiveGroup, GroupBox, Calendar, Button)