Spry - Prerelease 1.5
The Spry framework for Ajax is a JavaScript library for web designers that provides functionality that allows designers to build pages that provide a richer experience for their users. It is designed to bring Ajax to the web design community who can benefit from Ajax, but are not well served by other frameworks. The first release of the Spry framework is a preview of the data capabilities that enable designers to incorporate XML data into their HTML documents using HTML, CSS, and a minimal amount of JavaScript, without the need for refreshing the entire page. The Spry framework is HTML-centric, and easy to implement for users with basic knowledge of HTML, CSS and JavaScript. The framework was designed such that the markup is simple and the JavaScript is minimal. The Spry framework can be used by anyone who is authoring for the web in their tool of choice.
This is the 6th release of Spry. In this release, we are focusing on expanding our data capabilities, with HTML and JSON data sets and also the long awaited ability to use nested data sets. We have expanded our form validation widget collection with the radio button widget.
Before you get started, please take a moment to review the following important information.
Disclaimer
We want to remind you that this is PRE-RELEASE code. We are making it available to get your feedback and help us figure out where to take it. We expect to make changes to the framework as we go forward. We want you to build on this and let us know what you think, but please understand that we will make changes. We can't guarantee that something you build today will work in the next release.
What is included in Prerelease 1.5
Articles - Documentation that describe the Spry framework. * is new to this release.
- Accordion Widget Overview—An overview of how to create and style an accordion widget.
- Checkbox Validation Overview - Reference document for the Form Checkbox Validation widget.
- Collapsible Panel Overview - Reference document for the Collapsible Panel widget.
- Data Set and Dynamic Region Overview—An overview of the Spry architecture with sample code.
- Dynamic Table Tutorial—An overview of how Spry works by walking you through the conversion of an HTML table containing static data to one that can load its data dynamically.
- *Spry API - A reference for our Effects functions.
- Effects Coding -A more detailed explanation of our Effects code.
- *HTML Data Set Overview - An explanation of the HTML data set.
- *JSON Primer - An introduction to JSON.
- *JSON Data Set Overview- Explains how to use the JSON Data set.
- *Menu Bar Widget Overview - An explanation of the construction and use of the Menu Bar.
- *Pager Overview - Details how to easily page through data sets in Spry.
- Select Validation Overview - Reference document for the Form Select Validation widget.
- *Sliding Panels - Reference document for the Sliding Panels widget.
- Spry Widget Model—A document that describes the Spry widget philosophy. An overview of how we build our widgets.
- Textarea Validation Overview - Reference document for the Form Textarea Validation widget.
- Tabbed Panel Overview - Reference document for the Tabbed Panel widget.
- Textfield Validation Overview - Reference document for the Form Textfield Validation widget.
- Using the Spry Framework—Documentation on how to get started using Spry, including where to put files and how to start writing code.
- *Validating Spry - Explains how to validate Spry pages against the W3C.
- *XML Primer - An introduction to XML fundamentals.
Some PDFs are also available in the online samples directory.
Data - The XML data files used in all our sample files.
Demos - More complex samples that show the Spry framework in action.
- Effects - A demo of all our Spry Effects. Rewritten for 1.5.
- Form Validation - A demo of the Form Validation widgets.
- Photo Gallery—An XML-based photo gallery.
- Product Table—An interactive data grid displaying XML-based data.
- RSS Reader—An RSS reader showing how multiple XML files can be used to build a rich interface.
Please note: These demos are a proof of concept for the data capabilities of the Spry framework. They are not keyboard or screen reader accessible. Please review the FAQ for more information.
Includes - Core JavaScript files that implement the data framework.
- SpryData.js—Contains the code that defines XML data sets and dynamic regions.
- SpryDataExtensions.js - Contains helper functions such as advanced filtering.
- SpryDebug.js - A file that provides advanced debugging information for Spry pages.
- SpryEffects.js - The Spry Effects framework file.
- SpryHTMLDataSet.js - Enables the HTML data set functionality.
- SpryJSONDataSet.js - Enables JSON as a data source.
- SpryNestedJSONDataSet.js - Allows the use of complex JSON as a data source.
- SpryNestedXMLDataSet.js - Allows the use of complex XML as a data source.
- SpryNestedJSONDataSet.js - Allows the use of complex JSON as a data source.
- SpryPagedView.js - Enabled users to easily set up paging in data sets.
- Spry URLUtils.js - Get URL parameters and hashes to be used with Spry pages.
- SpryUtils.js - Contains helper functions, mostly form submission code.
- SpryXML.js—Function file for handling XML formatting. Only required for certain sample files.
- xpath.js—Google's JavaScript implementation of the XPath 1.0 standard. You can get more information about it by visiting their open source google-ajaxslt project page.
Samples - A series of simple files (located within the /samples/ directory in the ZIP) that show basic functionality of Spry . These provide working code samples of specific features of spry or common techniques used on Spry pages. One of the more useful samples is the Data Set Explorer page.
Widgets - Contains our released widget js, css and reference files.
License—Spry is licensed under a BSD license.
Spry change log—Log of what changed between Prerelease 1 and Prerelease 1.5.
Where can I get more information?
FAQ - Frequently asked questions (and answers!) about the Spry framework.
Spry Dev Center - Aricles and tutorials about Spry.
Creating a Web Photo Album with Spry -Walk through the steps to create a dynamic and flexible page using the Spry framework with remarkably few lines of code.
Adobe Labs Spry Forum - Post any questions or feedback on the Spry framework to the forums available on the Adobe Labs site.
Adobe Labs Wiki - The Adobe Labs wiki allows editing of pages and content by the community, but only within specific sections of the site. For resources that provide group edit access, you will be required to log in with your Adobe Labs/Adobe.com username.
Spry Blog- The Spry Team posts to the blog periodically, with Spry news and information.
We do ask that you only contribute to a page or resource if you feel you can improve it. Please do not add comments or feedback to the author to the pages directly; there is a 'Discussion' tab available for most all areas of the site that you can use to submit your feedback within, if you so desire. Use this tab to comment on or discuss a particular page or resource, so we can keep the content focused and on-topic.
Adobe Labs RSS Feeds - Please subscribe to the RSS feeds on Adobe Labs to be notified when new releases of Spry become available.
How You Can Help Us
While we want to hear about bugs that you find in this prerelease, we are especially interested in what you think about our approach. We are making this available so that we have a better opportunity to address your feedback. Please let us know:
Are there things that miss the mark?
Are there things that make you think "This would be great if they just changed/added..."?
Are there things that don't work the way you think they should?Feedback
Post any questions or feedback on the Spry framework to the forums available on the Adobe site.
We look forward to seeing what you think!