Silverlight Toolkit Now Available For Download

On the heels of Scott Guthtrie's PDC keynote this morning, I'm very pleased to announce the launch of the Silverlight Toolkit on CodePlex!


The Silverlight Toolkit is a collection of components dedicated to making you - the Silverlight Developer - as productive as possible writing Silverlight.  The full Silverlight Toolkit is available under the Microsoft Public License, an OSI-Approved license that allows full reuse of the code.

If you've read my last few posts, you know we're doing a slightly different release model.  Based on what we learned with the AJAX Control Toolkit, Scott asked me to build a team focused on writing controls for Silverlight and WPF that could do so in a rapid, agile way.  The Silverlight Toolkit is the first delivery from that team.

Download it here .

Release Model

We are focused on a rapid, feedback-centric release model.  Our goal is to update the Silverlight Toolkit releases roughly every 6-8 weeks - gated mostly on when we have "critical mass" of features or functionality.  Each release may contain new components, bug fixes, or both.

We've delivered the Silverlight Toolkit as a set of assemblies, instead of just one.  We wanted to make sure that Silverlight Applications can pick the components they need and not pay to download all the ones they don't.  So we looked at all the components we're releasing today, and some that we're considering in the future and came up with some high level "buckets" that are easy to remember and give us room to grow.  Each of these buckets represent an Assembly in the Silverlight Toolkit.

  • Common - the Silverlight Toolkit base classes and components that we think a large percentage of applications will be using.  This contains AutoCompleteBox and the layout controls.  Default prefix is "controls".
  • Input - components that take user input.  For this release, only NumericUpDown and it's base classes are in here.  Default prefix is "input".
  • DataVisualization - this contains the charting components.  Default prefix "charting".
  • Layout, Media - these are DLLs (buckets) that don't have any components for this release, but expect to see them in the future.

Quality Bands

There are two different ways that you can do software releases.  The traditional way is to hold an entire release until all components reach, roughly, the same quality level.  This works fine but forces all of your users to wait for everything.  It's a bit of an agility buzz kill.   Another method, is to have a single, rolling, release vehicle which has components different quality levels.  This works fine, provided you can clearly designate which components are at which level so users can make informed decisions about what they are using.

Enter Quality Bands, which are high-level buckets that describe a given components API stability and overall finish level.  This concept ties in with the Issue Tracker on the CodePlex site.  Users file and vote on bugs, and we continue to improve the component in response to that feedback.  It's the nature and the volume of that feedback that helps us determine when to move a component to the next band.  As you move up the Quality Band scale, you'll get components that are mode dependable for a wide variety of projects.

What are the Quality Bands?  We've designated four of them:

Experimental - components that are added to garner scenario or usefulness feedback.  These may not have a future in the Silverlight Toolkit.

Preview - these are components that we have made a commitment too and we think will work for ~80% of the major scenarios.  Many components are relatively simple and if you just need the basic functionality, these may work for you.  We always do our best to minimize "breaking changes" in APIs or behavior, but components at this band may see some level of this as we perfect the API.  Think of this as Alpha quality, give-or-take.

Stable - these components have moved out of Preview and should handle 90+% of scenarios.  We'll hold any breaking changes to a higher bar but if something is really wrong, we'll change it.   Something like Beta quality.

Mature - these components are at full "RTM" quality and fit-and-finish.  These components will not have breaking changes (except in rare critical situations like security issues) and are usable in a broad range of scenarios.  The API stability is key here - by using these components, our goal is that upgrading from one Silverlight Toolkit release to another should be a no-brainer.

The Silverlight Toolkit contains a CHM help file, and if you navigate to any of the component's documentation, you'll see the Quality Band clearly marked at the top.  On the CodePlex site, we've also added information about this.

Controls in the Mature band are eligible to be released with the Visual Studio Tools for Silverlight package, or in the Silverlight Runtime itself if appropriate.

As you'll see below, all of the components in the Silverlight Toolkit are in the Preview or Stable bands, as this is a Preview release.  And, because we haven't taken any feedback from the community, nothing can be in Stable or Mature, by definition.  We're hopeful we can quickly move many of these components up through the bands!

New Silverlight Controls and Components

We have a great set of components available.  You may have noticed from the image above that Charting has made it into the Silverlight Toolkit!  The team has been working literally 24-hours a day to get charting into this release.  We've been very focused on getting the right charting architecture and API model in place, at the cost of some more flashy scenarios.  We're now confident that we are in a place where we have made the right decisions and we'll be able to quickly add chart types and animations. What sets our charts apart is that they fully take advantage of the powerful styling and templating model that's present in Silverlight.


Not only do we support templating (your truly made the template above, believe it or not!), but we do support dynamic update.  If the chart above is attached to an ObservableCollection-based data source, you'll see the bars animate as your data changes.  It's very cool (UPDATE: example animation here at Tim's blog).

AutoCompleteBox is a great component as well.  It allows full templating as well as super-easy "out of the box" scenarios where you just attach it to a collection of items.  It's very flexible.  Check out this AutoCompleteBox with a DataGrid as the drop down:


This sample searches all columns with the word "New".

Of course there is more, and here's the full list of components and their Quality Bands.

Theming Containers


Another major goal of the Silverlight Toolkit is to help developers build good looking applications on this great Silverlight platform.  So in this release you'll see six new themes that you can use in your application.  We will also be making these themes available on WPF.

Silverlight lacks a WPF feature known as "implicit styling", which allows the theme for a type of component - say, Button - to be defined centrally.  One of the powerful attributes of the Silverlight Toolkit is that it allows us to deliver "stopgap" functionality to help developers outside of the main Silverlight ship-cycle.  In this release, we have a component called Implicit Style Manager (ISM) that allows to do this in a way that is similar to WPF. 

We're leveraging ISM to deliver these themes in a very simple way.  Each theme is available in raw XAML, or in a DLL.  In this DLL, is the theme and a "theme container".  For using it, just add a reference to the theme DLL to your project, then wrap your UI with that container.  Done!

Before: XAML: After:

<shiny:ShinyBlueTheme> <StackPanel Margin="10" > <Button Content="Button"/>   

  <CheckBox Content="CheckBox"/> <RadioButton Content="One"/> <RadioButton Content="Two"/> <basics:Calendar/> </StackPanel> </shiny:ShinyBlueTheme>


There's lots more.  With the Silverlight Toolkit project, we've got a great sample site that shows all of the components and how to use them, and we've got more components and themes on the way!  This site is also hosted on here.


Note at the top you can see the running sample, the XAML, and the C# code it took to build it.  Play around with it - there's lots to do there.

Information and Support

There are several ways to get support on the Silverlight Toolkit:

I hope this has given you an idea of what we've been up to and where we are headed.  Let us know what you think!