InlineEditor v1.6

InlineEditor allows any text element to be made editable. The user clicks on it, and it turns into a textbox with a save and cancel button. On save a request is sent to the server with the new value, and any other needed metadata.



Details

Author
Nathan
Current version
v1.6
GitHub
reednj/InlineEditor
Downloads
11312
Category
Widgets
Tags
Report
GitHub Issues

Releases


Dependencies

  • _self_/_current_:
    • core/1.2.4: [Class, Event, Element, Selectors, JSON, Request]
    • /InlineEditor

How to use

Include the InlineEditor.js and InlineEditor.css (and InlineEditor.Combo.js if you need drop down lists) in the header:

<link rel="stylesheet" href="InlineEditor.css" type="text/css">
<script type='text/javascript' src='InlineEditor.js'></script>

Make elements editable like this:

new InlineEditor(element, {url: 'save-change.php'});

When the editbox is saved a GET request will be made to that url with the new data.

Maybe you need to send some meta-data such as a row_id along with the request. Use the 'id' option:

new InlineEditor(element, {url: 'save-change.php', 'data':{'id':15}});

You can also place these attributes on the element its self, like this:

<div class='editable' data-url='save-change.php' data-id='1'>data value</div>
<div class='editable' data-url='save-change.php' data-id='2'>data value</div>

// then you could initialize all these at once like this:
$$('.editable').each(function(item) { new InlineEditor(item); }

Drop Down Lists

Use InlineEditor.Combo.js to let the user set input from a drop down list, instead of with a textbox

These are created in the same way as regular InlineEditors but have more settings to deal with setting the list of options in the dropdown.

This can be done in the javascript constructor:

new InlineEditor.Combo(element, {
    url: 'save-edit.php',
    options_list: [
        {'text':'one', 'value':'1'},
        {'text':'two', 'value':'2'},
        {'text':'three', 'value':'3', 'selected':true}
    ]
});

or in the dom:

<div class='editable-combo' data-url='save-edit.php'>
    <div data-value='1'>One</div>
    <div data-value='2'>Two</div>
    <div data-value='3' data-selected='true'>Three</div>
</div>

Textarea

For editing large amounts of text inline, use InlineEditor.Textarea. This works exactly the same as the regular inline editor, except that it creates a Textarea when clicked on, instead of a standard input box.


Server Request Format

This class will make a request to the given url as a GET, POST or JSON request. The new value will be sent as 'value', and the extra data will be sent as it is given in the 'data' option.

If there is an error you should return a '500' code. If you send back error information with the type 'application/json' in the format {code:, message:} the message will be shown as the error on the screen, otherwise a generic error message is shown.


Discuss

A note on comments here: These comments are moderated. No comments will show up until they are approved. Comments that are not productive (i.e. inflammatory, rude, etc) will not be approved.

Found a bug in this plugin? Please report it this repository's Github Issues.

blog comments powered by Disqus