[Kimchi-devel] [RFC] Wok widgets as custom HTML elements or UI library

Thu Jun 9 18:10:10 UTC 2016

Hi,

>From the frameworks that I've listed, React is the top trending on Github (although it appears almost at the end of the list). The statistics show that jQuery and Bootstrap are still reining as the most used libraries over the web, but it includes personal websites, e-commerce, blogs, portfolios etc. AngularJS and other MVV libraries are targeted for single page applications and mainly used on enterprise / corporate / applications so I'm not surprised that search and statistic engines won't show it on the top trending libraries. About the community reach and market share, this is an interesting link:

https://www.developereconomics.com/comparison-4-popular-javascript-mv-frameworks-part-2/

It shows Angular and Backbone as the top frameworks, however:
http://trends.builtwith.com/javascript
and https://w3techs.com/technologies/overview/javascript_library/all

...Shows different results.

I think using these frameworks / libraries would make it easier to develop new views and screens because it would not require a certain level of experience with HTML and DOM manipulation, but it would require a concise documentation and a very detailed developer guide and style guide. If we use Angular or React, developers would have to think "the angular way" or "the react way", something very different from the "jquery way" that we're all used to.
With the current Wok structure, if someone wants to develop a new plugin that runs in Angular or any other framework, it will be compatible with Wok and can access or even extend Wok functions and widgets. If we change Wok to Angular or any other framework, Wok specific functions and widgets would be compatible only with this framework that we chose and if the plugin developer wants to access these functions and widgets, it would require the same framework used on Wok for the plugin.

Samuel

From: Aline Manera [mailto:alinefm at linux.vnet.ibm.com]
Sent: quarta-feira, 8 de junho de 2016 17:08
To: Samuel Henrique De Oliveira Guimaraes <samuel.guimaraes at eldorado.org.br>; Kimchi Devel <kimchi-devel at ovirt.org>
Subject: Re: [Kimchi-devel] [RFC] Wok widgets as custom HTML elements or UI library

Hi Samuel,

First of all, I could not check all links you shared here. Sorry about that. But I rather to get back to you sooner than wait until get more time to read all them =)

My only concerned about that is how much gain a Web developer will have with this Wok framework/library comparing to Bootstrap or other existing technologies.
Wouldn't we attract more people if we use existing technologies on which Web developers are already familiar with?
What are the benefits of having our own UI framework/library? Would it be simple enough to be an entry point for Web development?

Regards,
Aline Manera
On 06/03/2016 11:00 AM, Samuel Henrique De Oliveira Guimaraes wrote:
Hi team,

After the open discussion session on our last scrum meeting regarding Wok as an UI framework / library, I decided to list some alternatives and technologies that we could use on the next releases or Wok 3.*.
The idea is to provide a solution that allowed developers to create panels, tabs or even full plugins with minimal or no knowledge on HTML and CSS or even DOM manipulation with jQuery.

Instead of using default HTML tags, the developer could write something like this for Kimchi network tab for example:

<wok-panel collapse="false" title="Networks">
    <wok-datatable filter="network.name, network.interfaces, network.address, network.type" model="kimchi.networks" sort="true" sort-by="network.name" actions="network.actions">
</wok-panel>
<wok-window model="network.add">
    ...
    // Network modal window contents
    ...
</wok-window>
<wok-window model="network.edit">
    ...
    // Network modal window contents
    ...
</wok-window>

This might seem too ahead of time but in fact it looks like any current MVV JavaScript framework. So here are the current alternatives with pros and cons:

1 - Custom elements API:

https://developer.mozilla.org/en-US/docs/Web/Web_Components/Custom_Elements

Current support: http://caniuse.com/#search=custom-elements
Status: Draft
Effort: minimal

In my opinion based on current structure this would be the least difficult alternative to adapt current code into a library but browser support is an obstacle.

2 - Google Polymer

https://www.polymer-project.org/1.0/docs/devguide/feature-overview

Current support:  https://www.polymer-project.org/1.0/docs/browsers
Status: Stable
Effort: medium

To work like the example above it would require some time to develop and I think it would create something bigger than an UI library, check an example source code and you will see what I mean. For some native components such as form controls it would redundant. It could be developed at the same time we maintain the current code.

3 - AngularJS

https://angularjs.org/

Current support: https://docs.angularjs.org/guide/ie
Status: 1.5.x Stable, 2.0 in development
Effort: medium to high

This would definitively work like the example above and make Wok and all its plugins work like a seamless single page application (no more problems with global variables / tasks when switching tabs from different plugins) but the effort would be medium to high. Legacy code would be incompatible, we would have to drop or move almost everything that we have done with jQuery and rewrite ALL tabs, widgets and API calls and all libraries that we currently use would have to be updated to an AngularJS-like compatible version (or some could go away as Angular provides native mechanisms that we could use). The advantage here is that there's a library that uses Bootstrap SCSS so our UI assets wouldn't discarded and the users wouldn't notice anything. The negative factor is that we would have to rewrite our code to meet "AngularJS way": creating services or factories for the REST calls, directives for the UI and the logic would go to the controllers. It wouldn't make the developers lives any easier, in fact it would require a narrow and specific skillset. For example: to make Wok load plugins, we would have to write a mechanism to lazy load our plugins dynamically based on the files installed in the plugins folder.
We could also benefit from some NodeJS plugins for unit, performance and UI tests, even mock objects when developing new UI when we don't have the exact system environment, not having to worry about messing with host or VM settings.

3 - Facebook React

https://facebook.github.io/react/

Current support: https://facebook.github.io/react/docs/working-with-the-browser.html
Status: Stable
Effort: maximum

We would exchange HTML to JSX and JavaScript. I think based on our project structure it brings the worst points from Google Polymer and AngularJS analysis.

Regards,
Samuel

_______________________________________________

Kimchi-devel mailing list

Kimchi-devel at ovirt.org<mailto:Kimchi-devel at ovirt.org>

http://lists.ovirt.org/mailman/listinfo/kimchi-devel

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ovirt.org/pipermail/kimchi-devel/attachments/20160609/6e5ebf0c/attachment.html>