Finally, there is a way to quickly check on Safari compatibility for multiple versions of Safari, all on the same machine. Oh, note that something alike that for IE has been available for quite a while now, and Firefox is nicely self-contained.
The availability of multiple versions of the same web browser in parallel should really be something browser developers should support out of the box. Given that third-party installers can manage that, can’t it be so hard to add that ability? Please think of your fellow developers’ sanity. 🙂Tweet
from a slide of my rejectconf presentation in berlin…
…more to be revealed soon!Tweet
Awesome amounts of new stuff and improvements, including:
- Total events overhaul with new custom events
- New support for inheritance and superclasses
- Aspect-oriented and functional programming helpers
- Cleaned-up and enhanced DOM APIs
- And sooo much more!
Read all about the new release candidate over at the Prototype blog. (And be sure to help us testing it so we’ve a final release soon!)Tweet
The next meeting of the Rubystammtisch is coming up on July 25. If you’re in/near/around Vienna at that time, consider joining in (please let us now in advance, just follow the link, and add yourself!).
The Rubystammtisch is held once a month, and we welcome anyone wanting to have a chit chat on Ruby, Rails or generally anything Web related. This time, we’ll go to one of Vienna’s Heuriger wine driking places—see you there!Tweet
Christophe rewrote In-Place Editing from scratch, seeking to eliminate all the corner-case quirks, smoothe the API, clean up the options, and add several much-requested features. The result is now part of script.aculo.us (as of changeset 7191)!
Does this break anything?
Well, mostly no. The only feature we know about that changed in a non-compatible manner is multiple-line management in the edited contents. Aside from that, existing options and behaviors remain.
Feedback welcome! I’d encourage trying out script.aculo.us trunk—if you have any bugs or general feedback, please don’t hesitate to discuss this on the mailing list!
Many, many users monkey-patched the classes (that is, hacked internal methods directly, such as
createForm). This was never a safe practice, as it relies on undocumented, generally internal, and essentially unsupported aspects of the code. Note that you can of course continue to use the old version if anything blows, but I’d recommend to port the code over.
Because the code was heavily refactored in this rewrite, it is very much possible that some methods you used to monkey-patch are not there anymore, or that they still exist but do not have the exact same set of responsibilities as their previous version, or occur at the exact same moment in the in-place editor’s lifecycle. So you should beware, and when installing the latest script.aculo.us, test your tweaks like crazy.
Aside from plenty of internal cleanup and performance boosts, there are essentially two changes to existing behavior: multiple-line management and a few options that morphed to something else. The sequence of AJAX calls used by such features as alternate text loading and final persistence have also been cleaned up, along with AJAX-related form disabling/enabling.
In the previous version, if the markup being edited contained any notion of multiple-line once rendered (e.g. it featured a
<br/> or a
<p>), you’d get a multi-line editor (a
textarea). This behavior could be disabled by setting the
handleLineBreaks option to
false. The only way to get a single-line editor was to not feature such markup in the edited text (or disable its detection) and have the
rows option set to 1 (one). The markup itself would be converted on-the-fly to multiple lines with no markup before being edited, but would not get converted back when being saved. Also, if the editor was configured to load alternate text from the server side, this conversion and detection would not occur on the loaded text, but on the loading… message cough.
We discussed this in length, and decided to change that a bit for better consistency. There’s no more implicit, one-way HTML conversion or what-not. If you want a multiple-line editor, just set the
rows option to a value greater than 1 (as before), or just feature line breaks (actual line breaks, not specific markup) in the element’s contents. That’s it. If you want to make that content editable using an alternate syntax, use the alternative text options (
loadingText), which serve exactly that purpose.
There’s also a new option, called
autoRows, which determines how many lines are used when
rows uses its default value of 1 (one), but the element’s contents features line breaks. This option defaults to 3 (three).
Option changes you should migrate to
Several options changed their names and value sets with this rewrite. Here’s a rundown:
okControl. The accepted values are
- The same goes for
cancelControl, except the default value is
highlightendcolorwere re-cased to
evalScriptswas a source of confusion, was improperly used internally, and has been replaced by
htmlResponse(see below, “New options”).
Yes, you can’t have a button and a link for the same action anymore. But then, nobody used that configuration (and frankly, who would?!).
Currently, a deprecation layer lets you still use the former option names and values, but that won’t be kept in eternally, so migrate your scripts now!
Plenty of stuff!
- As stated earlier,
cancelControlgovern OK/cancel controls in the form now.
fieldPostCreationdetermines what to do after the editing form gets ready. It can be
htmlResponsedetermines what kind of request to perform when the editing form gets submitted to the server:
- If set to
Ajax.Updateris used internally, with its
evalScriptsoption defaulting to
true(you can change that using the
ajaxOptionsoption). Only successful requests will update the element: failures will trigger the
- If set to
Ajax.Requestwill be used, as we assume the server will not return an updated version of the contents for our element: we’re just notifying it. However, as always with
Ajax.Request, defaulting to
getmethod (once again,
onFailurecallback, as always.
This essentially replaces the former
evalScriptsoption, whose named introduced confusion.
- If set to
rowsis now complemented by
autoRows, as mentioned earlier: if
rowsis 1 and the value has line breaks, a multiple-line editor with
autoRowsrows (defaults to 3) will be used.
stripLoadedTextTagsdetermines whether to strip the tags from the alternate, AJAX-loaded contents (defaults to
In-place editors feature a variety of callbacks, some of which existed in the previous version. Their exact triggering moment in the lifecycle may have changed, though. Here’s a full rundown so there’s no doubt left.
callbackis called when the form is about to be submitted to the server. At this point in time, the form was taken out of the DOM already, and the saving text was displayed. This takes the form and the editor’s value as its arguments, and defaults to serializing the form using
Form.serialize(which makes it easier for you to customize the form’s contents).
onEnterEditModetriggers right before in-place editing begins, basically as soon as the editable element is clicked. The external control, if any, is not hidden yet, nor is the element, and the editing form hasn’t yet been created. It takes the in-place editor object as its single argument. Along with a few others, this was previously not a proper callback (passed through the options hash), but a method you had to override in your own version of the class. Ugh.
onLeaveEditModeis symmetrical, and triggers once the whole editing process is over and every part of it is out of the page’s DOM. Same argument as
onEnterHovertriggers when the mouse enter the surface of the editable element. This takes the in-place editor object as its single argument, and defaults to setting the background’s color to the
onLeaveHoveris symmetrical, triggering when the mouse leaves the element’s surface, and fading the background color back to its original value (keeping the background image, too).
onCompletetriggers when the editor form is done with, either through cancellation or successful submission to the server, and reacts by performing a highlight (keeping the background image). It takes two arguments: the
undefinedif it’s a cancellation) and the editable element.
onFailuretriggers whenever an internal AJAX request fails (including HTTP responses with non-2xx codes). It takes the
XMLHttpRequestand the in-place editor object as arguments, and defaults to displaying a message box with the details of the response’s body.
onFormCustomizationis a brand-new callback that aims to make it easier to customize the editor form. It is triggered right after the editor field was created, and before any controls (OK/Cancel) are in. As it gets passed the in-place editor object and the form as its arguments, it’s pretty simple to use
appendChildin order to add a few custom controls in there.
Support for multiple in-place editors
Every single AJAX request made by an in-place editor guarantees a new
editorId parameter, that contains the edited element’s
id attribute. This lets you factor the code for multiple in-place editors in a single server-side resource.
A better collection editor
The previous version of
Ajax.InPlaceCollectionEditor required that you provide the collection of items as an array in the
collection parameter at construction time. What’s more, it did not integrate well at all with alternate text loading.
The new version plays nice with alternate text loading, and also lets you dynamically load the collection through AJAX, every time the editing form is created (as always, the collection query will feature a
editorId parameter, as described earlier). The two allowed formats for the collection are retained: either an array of values, which will serve as both value and text, or an array of two-item arrays, the first one being the value, the second one being the text.
When loading an alternate text (which will be used to match against item values in the collection), the loading text is featured as the sole option in the temporarily disabled dropdown list. The same kind of display is used while the collection is dynamically loaded. Note that the collection is loaded before the alternate text is.
value option, which could force a given item in the dropdown list to be selected regardless of the current contents of the editable element, is still featured (however seldom it is used).
So, start your In-Place Editor engines!Tweet
If you’re at the conference, be sure not to miss this one.Tweet
Apple seems to be quite serious on their support for Safari on Windows, as you get the same kind of top-notch debugging and analyzing facilities as on the Mac (of course, on the Mac everything is a little bit better looking).Tweet
Kjell Bublitz who already contributed a CHM version of the Prototype API documentation strives for more glory with a very nice compilation of CHM and PDF script.aculo.us offline docs, plus a printable PDF for reference.
It’s small and fast download, and very welcome as a quick reference!
The docs are made from the wiki contents, so if everyone helps cleaning up the wiki and adding more examples and more descriptions, these offline docs will get even better!
P.S. Want to use the CHM version on a Mac? Grab Chmox, it’s free and works well with the docs.Tweet
An other beta, this time featuring the final version of Prototype 1.5.1, as well as Sortable speed optimizations.
There’s quite a backlog of patches and bugfixes, that I’ll hope to incorporate over the next weeks to get 1.7.1 final out when it’s ready.
Meanwhile, the beta versions of script.aculo.us are quite stable, and while I’m not doing any recommendations for doing so, work quite well on production websites. YMMV, of course; no guarantees. 🙂Tweet