Various KSS plugins
Project description
Introduction
Tested with Plone 3.1. Release 1.1 works with grok 0.13 but has not been tested properly.
This package contains various plugins for kss
Redirect request
Calendar
Javascript value setter
Autocomplete input box
Javascript confirmation
Alert text
Dynamic positioning
Open window
Refresh page
Remove attribute
USAGE
1. Redirect request
Redirect request is a simple plugin to redirect to a given url
2. Calendar
Render date picker is a global plugin that provides simple calendar
One mandatory parameter - id of the input box to fill the selected date Example usage:
#created_calendar:click { evt-click-preventdefault: True; action-client: renderDatePicker; renderDatePicker-fieldName: created; }
3. Value setter
Value setter set a value of an input box using javascript ( changes actual current form values )
target_element is id of an node that can receive the value (i.e. input) source_element is id of an node that is the value taken from value is any value that is send to the target_element
At least one of the sources has to be provided
Example usage:
#kss-attr-activity-field:click { evt-click-preventdefault: True; action-client: valueSetter; valueSetter-target_element: activity_name_field; valueSetter-source_element: project_name_field; }
4. Autocomplete
Autocomplete plugin displays limited list as you type into inpt box An input which is desired to use autocomplete has to have a attribute vocab with a list of possible values
Autocomplete triggers an event “selected” when an item is chosen either using mouse or a keyboard
from kss.plugin.cns.plugins.autocomplete import autocomplete_escape vocab = autocomplete_esacae(DisplayList(…))
Example usage:
.kss-autocomplete:focus { evt-focus-preventdefault: False; action-client: autocomplete; autocomplete-vocab_list: nodeAttr(vocab); } .kss-autocomplete:selected { action-client: alert; alert-message: 'An item was seleted'; }
Note the usage of a class - the vocab is passed by kss attribute so the same kss definition can be used for more elements.
5. Javascript confirmation
Confirm is a plugin to display a confirmation dialog with given message and on confirmation triggers an “confirmed” event
Example usage:
button.removeItem:click { evt-click-preventdefault: True; evt-click-allowbubbling: True; action-client: confirm; confirm-text: "Do you really want to remove this item?"; } button.removeItem:confirmed { action-client: alert; alert-message: "Deleting the item" }
6. Alert text
Alert text is a simple plugin to display a javascript alert box, in opposite to core alert plugin it does not display any debug info
7. Dynamic positioning
Dynamcic positioning is a plugin to center selected node to an absolute position in a window - simple implementation for ie6 problems with fixed position
Parameters: left, top Can be either position in pixels or “center” that finds the center of a window
8. Open window
A simple plugin to open a new window with given url.
Parameters: url
Available as a kss command so it can be invoked within kss server action
9. Refresh page
A simple plugin to reload page. Available as a kss command so it can be invoked within kss server action
10. Remove attribute
A plugin to remove attributes. Core plugins only support adding attributes and removing by setting their values to empty. For instance it was not possible to remove attribute “disabled”.
Parameters: name - a name of the attribute to remove
Changelog
1.0 - Unreleased
Initial release - compatible with Plone 3.0.x. Some plugins does not work with Plone 3.1 (for example confirm plugin)
1.1 - Release
Removed strict dependency on Five and GenericSetup so it works with plain Zope 3
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.