https://github.com/humansinput/htmlui
Attempt to create a Ruby GUI framework based on QML WebEngineView and HTML5.
https://github.com/humansinput/htmlui
desktop gui html linux macos qml qt ruby rubygem windows
Last synced: 19 days ago
JSON representation
Attempt to create a Ruby GUI framework based on QML WebEngineView and HTML5.
- Host: GitHub
- URL: https://github.com/humansinput/htmlui
- Owner: humansinput
- License: mit
- Created: 2019-08-25T16:06:46.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-08-26T14:17:59.000Z (almost 6 years ago)
- Last Synced: 2025-05-07T09:12:02.862Z (28 days ago)
- Topics: desktop, gui, html, linux, macos, qml, qt, ruby, rubygem, windows
- Language: Ruby
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.asciidoc
- License: LICENSE
Awesome Lists containing this project
README
= HTMLUI
*HTMLUI* is a framework that can be used to create GUI applications using HTML and Ruby.
Here is [a really simple example](https://github.com/timkoi/htmlui/tree/master/example) that demostrates the basics of using HTMLUI.
== Installation
HTMLUI is still considered experimental and, as such, no stable releases are available (yet). To use HTMLUI, you'll have to build it from sources, which is pretty easy.
You will need:
[squares]
- Ruby 2.0 or later
- Qt 5.9 or later
- `qml` Ruby gem
If you are on macOS and you have MacPorts installed, all the dependencies can be installed using these commands:
[source,bash]
----
$ sudo port install qt5-qtwebengine qt5-qtbase
$ sudo sh -c "PREFIX=\"/opt/local/libexec/qt5/bin:$PREFIX\" gem install -N qml"
----
Now build the binary gem for `htmlui` and install it:
[source,bash]
----
$ gem build htmlui.gemspec
$ sudo gem install --local htmlui-1.0.0.gem
----
== Status
=== What works?
[squares]
- Rendering HTML pages using QML WebEngineView
- Calling Ruby code from HTML
- Calling JavaScript from HTML
- Creating alerts from Ruby
- Loading internal/external JavaScript or CSS
- Retreiving information about HTML elements from Ruby
- Calling file selection dialog from Ruby
=== What does not work or is not implemented (yet)?
[squares]
- Creating input boxes from Ruby
== License
MIT License