ToscaWidgets 2 Documentation

ToscaWidgets aims to be a practical and useful widgets framework that helps people build interactive websites with compelling features, faster and easier. Widgets are re-usable web components that can include a template, server-side code and JavaScripts/CSS resources. The library aims to be: flexible, reliable, documented, performant, and as simple as possible. For changes since ToscaWidgets 0.9, see What’s New in ToscaWidgets 2?.

You can see the available widgets in the Widget Browser.

ToscaWidgets 2 library packages follow the same naming convention, for example:

• tw2.core – Core functionality – no end-usable widgets here.
• tw2.forms – Basic forms library
• tw2.dynforms – Dynamic forms – client-side and Ajax
• tw2.sqla – SQLAlchemy database interface, similar to Sprox and Rum
• tw2.yui – tw2 wrappers around Yahoo User Interface widgets
• tw2.jquery – tw2 wrappers around jQuery core functionality.
• tw2.jqplugins.ui – tw2 wrappers around jQuery-UI widgets.
• tw2.jit – tw2 wrappers around the Javascript Infovis Toolkit.
• ... and many more.

---

Online Resources

• Live demos – Pick and choose from available libraries from the tw2 Widget Browser.

• Tutorials for doing –

  • Dynamic database-driven forms with tw2 and Pyramid.
  • Dynamic database-driven forms with tw2 and TurboGears 2.
  • Dynamic database-driven forms with tw2 all by its standalone self.
  • Interactive relationship graphs with tw2.jit and Pyramid.
  • Interactive relationship graphs with tw2.jit and TurboGears 2.1.
  • Database-aware jqgrid, with jqplot and portlets in a TG2.1 app.
  • Bubble charts with tw2.protovis.

• Nightly run test results.

• Email list: toscawidgets-discuss.

• IRC channel: #toscawidgets on irc.freenode.net

• Bug tracker: The toscawidgets github account. * (All ToscaWidgets 2 issues should go here, regardless of which

  component the issue exists in. However, ToscaWidgets 0.9 bugs must not go on this tracker.)

• Changelog

---

Contents

• Tutorial
  • Installation
  • Using ToscaWidgets
  • Next Steps
  • Import Styles
• Design
  • Widget Overview
  • Widget Hierarchy
  • Template
  • Non-template Output
  • Resources
  • Constructing Javascript from Python
  • Middleware
  • Declarative Instantiation
  • Widgets as Controllers
  • Validation
  • General Considerations
• tw2.devtools
  • Widget Browser
  • Widget Library Quick Start
  • Writing a good widget library
• What’s New in ToscaWidgets 2?
  • Per-Request Widget Instances
  • Simplified Form Definitions
  • Widget Controller Methods
  • Built-in Validation
  • Declarative Parameter Definitions
  • Consistency in IDs and Names
  • Layouts Separated from Containers
  • Explicitly Deferred Parameters
  • Variables in Widget Templates
  • ToscaWidgets as a Framework
  • Minor Differences
  • ToscaWidgets 1
• Changelog
  • 2.2.4
  • 2.2.3
  • 2.2.2
  • 2.2.1
  • 2.2.0.8
  • 2.2.0.7
  • 2.2.0.6
  • 2.2.0.5
  • 2.2.0.4
  • 2.2.0.3
  • 2.2.0.2
  • 2.2.0.1
  • 2.2.0
  • 2.1.6
  • 2.1.5
  • 2.1.4
  • 2.1.3

Indices and tables

• Index
• Module Index
• Search Page