Custom Controls > Widget Reference > Rating |
Member Of | Wijmo Value Control |
Base Control | wijrating |
Description | Creates a customizable star rating control. |
Usage | Apply to an entity property having a numeric data type. |
Generated Code |
Copy Code
|
---|---|
myapp.ScreenName.PropertyName_render = function (element, contentItem) { var div = $("<div/>"); div.appendTo($(element)); div.wijrating({ rated: function (e, data) { var newValue = data.value; if (contentItem.value != newValue) { contentItem.value = newValue; } }, reset: function (e) { contentItem.value = c1ls.isNullableType(contentItem) ? null : 0; } }); contentItem.dataBind("value", function (newValue) { div.wijrating({ value: newValue }); }); }; |
If you need to set additional options on the widget, add them to the initializer passed to the constructor.
The rated event is handled to update the bound value whenever the end user changes the current value by clicking one of the rating icons.
The reset event is handled to update the bound value whenever the end user clicks the reset button. The new value is either null or zero depending upon the semantics of the bound contentItem.
The dataBind method call ensures that the widget stays in sync whenever the bound value changes.