You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Security Support ends in January 2024. Read version 5.0 (the latest LTS version) of the Oro documentation to get the updated information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Input Widgets

An input widget is a widget used for form elements, such as datepicker, uniform, select2, or others.

An input widget is used to provide a common API for all input widgets. By using this API, you provide the ability to change the input widget to any other or remove it without changing the code that interacts with the widget.

InputWidgetManager is used to register input widgets and create a widget for applicable inputs.

$.fn.inputWidget - is a jQuery API for InputWidgetManager or InputWidget.

Example of usage:

//Create new input widget

var AbstractInputWidget = require('oroui/js/app/views/input-widget/abstract');
var UniformSelectInputWidget = AbstractInputWidget.extend({
    widgetFunctionName: 'uniform',
    refreshOptions: 'update',
    containerClassSuffix: 'select',

    dispose: function() {
        if (this.disposed) {
        UniformSelectInputWidget.__super__.dispose.apply(this, arguments);

    findContainer: function() {
        return this.$el.parent('.selector');

//Register widget in InputWidgetManager

var InputWidgetManager = require('oroui/js/input-widget-manager');
InputWidgetManager.addWidget('uniform-select', {
    selector: 'select:not(.no-uniform)',
    Widget: UniformSelectInputWidget

//Create widgets for all apllicable inputs


* Call function from InputWidget or jQuery.
* See available functions in AbstractInputWidget.overrideJqueryMethods
* Example: will be executed InputWidget.val function, if widget and function exists, or $.val function.
$(':input').inputWidget('val', newValue);

Your can see more examples in code: