ASP.NET TagCloud Setup

ShieldUI TagCloud for ASP.NET is a server-side wrapper component implemented in the ASP.NET server side component pattern. To get started using the component simply add a reference to the Shield.Web.UI assembly in your ASP.NET project.
Since this is a wrapper of the JavaScript TagCloud widget you need to include the references to the CSS and JavaScript resources in the HEAD section of your webpage:

<head id="Head1" runat="server">
<link rel="stylesheet" type="text/css" href="css/light/all.min.css" />
<script src="js/jquery-1.9.1.min.js" type="text/javascript"></script>
<script src="js/shieldui-all.min.js" type="text/javascript"></script>
</head>

The JavaScript resources for client side component you can find on the download page under the ShieldUI JavaScript section.

In order to have intellisence into the aspx pages markup you need to add the Shield.Web.UI namespace to the node of the section in your Web.config configuration file:

<system.web>
  <pages>
    <controls>
      <add tagPrefix="shield" namespace="Shield.Web.UI" 
          assembly="Shield.Web.UI" />
    </controls>
  </pages>
</system.web>

The other approach is to add following line of code into your aspx page:

<%@ Register Assembly="Shield.Web.UI" Namespace="Shield.Web.UI" 
    TagPrefix="shield" %>

The ASP.NET Wrapper offers a 1:1 correspondence with the relevant properties of the jquery widget.

For example, the following client side initialization:

<div id="tags" />

<script type="text/javascript">
    jQuery(function ($) {
        $("#tags").shieldTagCloud({
            title: "Shield UI Demos",
            dataSource: {
                remote: {
                    read: "/api/demo-stats"
                },
                schema: {
                    data: "components"
                }
            },
            textTemplate: "{name}",
            frequencyTemplate: "{demos}",
            hrefTemplate: "{url}"
        });
    });
</script>

is translated into the following ASP.NET code:

    <shield:ShieldDataSource runat="server" ID="shieldDataSource">
        <Remote>
            <Read Url="/api/demo-stats" />
        </Remote>
        <Schema Data="components" />
    </shield:ShieldDataSource>

    <shield:ShieldTagCloud ID="tags" runat="server" 
        ClientDataSourceID="shieldDataSource" Cls="tags"
        Title="Shield UI Demos" TextTemplate="{name}" 
        FrequencyTemplate="{demos}" HrefTemplate="{url}" />