Thursday, August 4, 2016

Selectivity v3 adds React support

From the start, Selectivity has been developed as a jQuery plugin. It used jQuery internally as well as exposed a typical jQuery plugin API. But given that my own use cases involve more and more React, I wanted to bring Selectivity along into a world where using jQuery is no longer a given. The past few months I've gradually rewritten the Selectivity internals so they became independent of jQuery. It was quite a bit of work, with nothing really to show for it...

But today I released Selectivity v3.0.0-beta1 with the official React API! When you download this latest release, you can simply choose to use the jQuery bundle or the React bundle and each comes with its appropriate API and plugins. If you're adventurous, you can even use the VanillaJS bundle that depends on neither library. I have updated the Selectivity homepage to (hopefully) make it clear how to use each API.

Also new (or at least: finally usable) is the NPM release. I have added extensive instructions on how to use the NPM release on the GitHub project page. I have to admit having a triple-API model certainly makes things more complicated in that area. But then again, the alternative would be to create separate projects for each API and each plugin, and I would be stuck with 13 projects to maintain. I guess it would certainly be more in the spirit of NPM, but I hope I struck a good balance here :)

I'd be happy to receive bug reports and suggestions for improvements (not in the least when it comes to the documentation!). Cheers!

Thursday, May 14, 2015

Selectivity.js v1.1.0 improves keyboard support, adds Ruby Gem

Today I'm proud to announce the release of Selectivity.js v1.1.0. Selectivity.js is a library for displaying rich select boxes. It is intended to be lightweight and flexible and has a modular design, a build system for creating custom builds and a proper test suite.

The new version comes with a few notable changes:
  • Shortly after version v1.0.0 was release the project has been officially renamed from Select3 to Selectivity. If you are still using the project under the Select3 name, this will be a breaking change as all symbols have been renamed accordingly. Anyone who jumped in after the name change should not have to deal with any API changes.
  • Keyboard support has been vastly improved. All Selectivity inputs can now be navigated to using the Tab key. Submenus can now be navigated with the keyboard, and submenus can be closed using Backspace. Backspace can also be used to clear a selected input if the allowClear option is enabled. And finally, some annoying page scrolling issues have been fixed when using keyboard navigation to scroll through a longer list of results.
  • Compatibility with web forms has been improved so values selected in a Selectivity.js instance can be submitted back to a server using regular HTML form submission.
  • A Ruby on Rails Gem has been created to facilitate users wanting to use Selectivity.js in their Ruby application.
  • Many bugs have been fixed.
Special thanks go to Konrad Jurkowski without whom this release would've been significantly less impressive. Specifically, he's developed the web forms compatibility and the Ruby on Rails gem for which there is a separate project page: https://github.com/msx2/selectivity-rails. As part of this work he has also set up our Sass support that we now use to generate our stylesheets. And last but not least, he's contributed several bugfixes as well.

Additional thanks go to everyone who has submitted Pull Requests or reported issues on GitHub!

You can install the new version through Bower, Component, the new Ruby Gem or just download the release right here: https://github.com/arendjr/selectivity/archive/v1.1.0.tar.gz

Cheers!

Tuesday, March 10, 2015

Selectivity v1.0 released

Update: This post mentioned the release of Select3 v1.0. The project has since been renamed to Selectivity.js and all references in this post have been updated.

After a little over two months of development, I'm proud to announce the first stable release of Selectivity.js. This release follows shortly after we have started using Selectivity in production at Speakap, meaning we believe it is stable enough to expose our users to it :)

Selectivity.js is a library for displaying rich select boxes. It is intended to be lightweight and flexible and has a modular design, a build system for creating custom builds and a proper test suite.

New Features

Some noteworthy features have been added to the library over the past month:

  • Support for submenus, as described in a previous blog post.
  • An AJAX module, for conveniently performing AJAX requests to fetch remote data.
  • An async module, which detects out-of-order responses to requests and discards those that are no longer relevant. This is especially useful in combination with the AJAX module, but can also be used independently.
  • Selectivity.js now automatically fetches more results when the user scrolls to the "Load more" link a dropdown.
  • Dropdowns now detect whether there is enough room to be displayed at the bottom of the screen and expand upwards if necessary.

What's Next?

Now that Selectivity has been released with its first stable release, it is expected the development of additional features will settle down. Maintenance will continue in the form of bug fixes. Some minor features and accessibility enhancements are to be expected, but nothing that will break the API short-term.

Instead, I intend to shift focus to extending the ecosystem around Selectivity.js. For example, I expect to shortly start working on a React.js Component for working with Selectivity. Also some specific customizations will be released in the form of plugins or add-on modules. Such work will be performed in separate repositories and not in the Selectivity.js repository however.

Questions and Suggestions

If you have any questions about working with Selectivity.js, feel free to post them on Stack Overflow using the "Selectivity" tag. Features requests and other suggestions are welcome in the GitHub issue tracker.

Cheers!

Tuesday, February 10, 2015

Creating submenus with Selectivity.js

Update: This post originally mentioned Select3. The project has since been renamed to Selectivity.js and all references in this post have been updated.

tl;dr: Selectivity.js now supports submenus.

Do you know the feeling when you've built some awesome code that's super-flexible and extensible and everything, opening endless possibilities and unimaginable scenarios, only to realize in hindsight that all this over-engineering was wasted effort and all this true potential of the code never materialized because it simply wasn't what you actually needed? It's a very common trap that I think pretty much every software engineer has fallen into at least once in his career... Which is why it's fun to write about when the opposite happens.

Recently I took it upon myself to create a new library called Selectivity. It was originally called Select3 because it's actually a reimplementation of the popular Select2 library. The main reason I decided to go my own way and make a from-scratch reimplementation was because I needed more flexibility and had to facilitate some use cases involving highly customized dropdowns that Select2 just wouldn't cooperate on. So I made it flexible and modular and everything. Then I integrated it into our product and implemented our use cases and all seemed said and done.

Until last week some requirements fell upon my plate and my colleague jokingly said, "that's a nice job for your Selectivity". I scratched my beard a bit, gave it a thought, then gave it a shot. As obvious as it is now, this was actually a use-case I hadn't anticipated in advance. All that was needed was the ability to open submenus from the main dropdown and the submenus should contain a search input to be able to search among the results as shown in this example. And all that was needed to implement it was another Selectivity module and some minor tweaks.

Now, for those using Selectivity.js, let me explain how you can create your own select input with submenus. All the results from which the user can select an item are specified as objects with id and text properties. These are either set on the Selectivity instance using the items option (to set a static array of result items) or through the query function (to fetch a dynamic set of result items based on search terms). Now, if you want to attach a submenu to a result item, all you need to do is set a submenu property on the item. This submenu property should be another object and in it you can again specifiy an items array or a query function like you did for the main Selectivity instance. Optionally, you can also specify the showSearchInput option (whether or not the submenu should contain its own search input) and/or the positionDropdown function (to customize the positioning of the submenu's dropdown; this method has the same signature as the positionDropdown function you can specify for the Selectivity instance).

Example code from the example linked above:

$('#example-4').selectivity({ allowClear: true, items: [{ id: '+00:00', text: 'Western European Time Zone', submenu: { items: [ { id: 4, text: 'Barcelona' } /*, ...*/ ], showSearchInput: true } } /*, ...*/], placeholder: 'No city selected' });

That's all!

Saturday, June 7, 2014

How to speed up resource loading when using Require.js

If you're building a single-page AJAX application using Require.js, odds are your boot sequence for loading the application on production looks something like this:
  • First, your index.html gets loaded.
  • At the head of your index.html you link CSS resources which get loaded.
  • There's a script tag referencing Require.js, then some inline script for configuring it and finally you kick it off by specifying which modules should be loaded.
This is pretty much what booting our application at Speakap looks like and it results in the following graph for loading resources:


Here you see the index.html getting loaded at the top from speakap.speakap.com. The CSS gets loaded next and require.js is fetched in parallel because both are referenced straight from the index.html (please note all static files are padded with an MD5 hash for versioning in the graph above). The file nr-411.min.js can be ignored in this discussion as it's used for performance analysis and error reporting by New Relic, but it's not actually a module of our own application. Then finally we see our two modules - app.js and libs.js - that are getting loaded by Require.js.

This is not everything that is happening during boot, but it's the main part and with the resources you saw above, the application is able to render its skeleton and from a user's perspective, the application has loaded and is visible, though data fetching has still to occur. This all happens in under a second for a typical DSL connection (the graph above is measured from my home connection). It's certainly not bad, but it is up for improvement.

The most obvious way to improve the boot time is to improve the parallelization of the loading of resources. Unfortunately, in the current setup the inline script which configures Require.js and tells it which modules to load is blocked by both the loading of the CSS (see here if you want to know why) and the loading of Require.js itself. Because of this, app.js and libs.js cannot be loaded by Require.js until after these two files have been loaded. Fortunately, the workaround is easy; who says these two modules have to be loaded by Require.js? We already know upfront these two modules will be loaded, so why not just reference them straight from the HTML with a good old script tag, preferably with an async attribute.

This is exactly what I did, and the result is that app.js and libs.js are now fetched in parallel with the CSS and require.js. In a development setup (no latency) this saved me about 80ms, or about 15%, in total page load time. In the common case where latency is an issue the savings are even larger.

Before all is said and done however, there is one important caveat that will ruin the plan if you're using a vanilla Require.js library. Require.js expects to be in full control of the loaded libraries and will happily ignore the fact the modules it is instructed to load are already being loaded from a plain script tag. The result being we end up with two script tags for the same module, and depending on the order in which they are actually loaded, global state may be overwritten causing inconsistent JavaScript errors. The fix to this problem is a rather simple check to make Require.js aware of the already existing script tags, and re-use those when applicable. In hopes this might be useful to others, I have created a Pull Request for Require.js, which adds this fix. I hope it gets merged into Require.js proper, but until then, feel free to try it out!

Monday, February 3, 2014

C.I. Joe 0.0.3 "United We Stand" released

After a month of intense work and a big redesign — both mechanically and aesthetically — the time has come to release C.I. Joe 0.0.3 "United We Stand".

New in this release is a great C.I. Joe themed redesign created by my colleague Dennis de Jong (any possible remaining styling issues are due to my lack of CSS skills, not Dennis' design):



In addition, the concept of campaigns has been introduced as seen above. Campaigns provide an easy-to-use mechanism for scheduling multiple missions at once, to be executed one after another or in parallel.

Finally, I've made a beginning writing the in-application Help manual.

As with previous releases, you should be aware this is an alpha release and far from feature complete. But for those wanting to try it out, you can download the new release here: https://github.com/arendjr/CI-Joe/releases/download/v0.0.3/ci-joe-0.0.3.tar.gz

Join or follow the contribute on GitHub: https://github.com/arendjr/

Friday, December 27, 2013

C.I. Joe 0.0.1 "The Germ" released

For a little while, I've been working on a side project called C.I. Joe, and today I'm ready to announce it's very first alpha release, codenamed "The Germ".

This release is marked more by what it doesn't do than what it actually does do. So, to avoid any further disappointment, let's first get out of the way what it doesn't do:

  • No Scheduling
    Currently, every job you want to start has to be started manually. Better set your own watch.
  • No Version Control
    There's no integration with version control systems like Git or SVN yet. However, nothing is stopping you from making your own clone or checkout in the mission workspace and issuing a git pull or svn up at the start of a mission.
  • No Security
    Right now everything is publicly accessible, so anyone who can reach the server can do whatever he likes with it. So don't connect C.I. Joe to the internet just yet.
  • No Slave Configuration
    C.I. Joe comes with a single local slave pre-configured. If you edit the configuration, you can add additional slaves, but there's no UI for this yet, and only local slaves are supported thus far.
  • No Artifact Storage
    So far, every job you run will run in the same workspace, and no artifacts are kept from previous jobs. Console output from jobs is stored only in memory, so as soon as the server is restarted, all output is gone.

Having said all that, this very first release marks an important milestone in the development of C.I. Joe. Even though not yet fully featured, a functional master-slave architecture has been developed. There's an HTML5 web frontend that automatically updates in real-time. There's the beginning of a REST API which is already used for configuring missions and starting jobs. The master communicates with slaves as well as the web frontend through Socket.io connections. There is a testing framework and the first integration test has been written to test whether a mission can be configured and ran. The release process has been automated, including a build process that optimizes sources and removes development artifacts before distribution.

All of this means that from here on, development should speed up, and there can now be an actual prioritization of the features to develop next.

If you are interested to see what's next, check out the project page: https://github.com/arendjr/CI-Joe. Feel free to file issues for suggestions about where you would like this project to go next.

Finally, if you want to try out this very limited alpha yourself, here is the download link: https://github.com/arendjr/CI-Joe/raw/master/dist/ci-joe-0.0.1.tar.gz

Happy New Year!