knockout-x-editable v0.1.2
knockout-x-editable
knockout binding handler for x-editable - See http://vitalets.github.com/x-editable
Simple Usage
NOTE: set any editable defaults before calling ko.applyBindings
for a view model:
var viewModel = function(){
var self = this;
self.id = ko.observable();
self.firstName = ko.observable();
self.lastName = ko.observable();
self.gender = ko.observable();
self.genders = ko.observableArray();
}
and binding:
<span data-bind="editable: firstName"></span>
will set editable options value (value of firstName) and name to firstName. Your observable is updated to the new value in the save event (you can also pass your own save event that gets called after).
Advanced
You can pass through any editable options with:
<span data-bind="editable: firstName, editableOptions: {name: 'first', pk: id, url: '/save'}"></span>
Note the pk can be an observable since x-editable just calls it as a function. The option editableOptions.visible can be passed an observable, this sets the x-editable toggle to 'manual', then uses the observable to fire the 'show' method
You can also pass in the bindTextInput
option for two-way updates (see http://knockoutjs.com/documentation/textinput-binding.html):
<span data-bind="editable: comment, editableOptions: {/* ... */, bindTextInput: true}"></span>
select, checklist and typeahead options
For select and checklist, you can pass options just as you would to knockout:
<span data-bind="editable: gender, editableOptions: {pk: id, options: genders, optionsText: 'text', optionsValue: 'id'}"></span>
optionsCaption is used to set editable.prepend
knockout.validation
If you are using knockout.validation, I have wired up a call to the observable's isValid for editable.validate. To work, this has to push the new value into the observable, then validate, then revert back. If you have subscribed to changes, you will see them. Not the best choice, but works.
6 years ago