Skip to main content link. Accesskey S
  • Help
  • IBM Logo
  • IBM Notes and Domino Application Development wiki
  • All Wikis
  • All Forums
  • THIS WIKI IS READ-ONLY. Learn more...
  • Home
  • Product Documentation
  • Community Articles
  • Learning Center
  • IBM Redbooks
  • API Documentation
Search
Community Articles > Designing Applications > Designing XPage Applications > Providing illustration for your XPage custom controls (Design Definition)
  • Share Show Menu▼
  • Subscribe Show Menu▼

About the Original Author

Click to view profileSteve Castledine
Contribution Summary:
  • Articles authored: 3
  • Articles edited: 3
  • Comments Posted: 0

Recent articles by this author

Providing illustration for your XPage custom controls (Design Definition)

Something added to Lotus Domino Designer (DD) in 8.5.1 was the ability to better illustrate our custom controls when laid out within an XPage (within Designer itself). For example in 8.5 a tag cloud may look like this: whereas in 8.5.1 we can now make it look like: This is a simple example so big ...

XPages Repeat Control enhancement for 8.5.1

Repeat controls are probably one of the top tools in an XPage developers box. By their very nature we, the developer, decide how they are used and the html that is sent to the browser. So typically we would want a list, a table or maybe a list of divs (preferably the first two) to display our ...

OneUI Documentation

IBM Lotus Domino 8.5.1 comes pre-installed with OneUI v2.01 for evaluation purposes. OneUI v2.x is in use in other Lotus Products, and is pencilled in for Domino/XPages for version 8.5.2 (with the usual caveats of "this is in plan, however is not guaranteed and future plans are subject to ...
Community articleProviding illustration for your XPage custom controls (Design Definition)
Added by Steve Castledine | Edited by IBM contributorDeanna Drschiwiski on November 3, 2009 | Version 3
  • Actions Show Menu▼
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars
expanded Abstract
collapsed Abstract
No abstract provided.
Tags: XPages, custom control, design definition
Something added to Lotus Domino Designer (DD) in 8.5.1 was the ability to better illustrate our custom controls when laid out within an XPage (within Designer itself).

For example in 8.5 a tag cloud may look like this:


whereas in 8.5.1 we can now make it look like:


This is a simple example so big deal you may think, however with more complex custom controls (and XPages) and the fact that they are reusable so you want them to be as polished as possible its a great improvement. You can even include on screen instructions on how to reuse your custom control like I have in the following example:


So how do we do this? Well in a custom control we have a new setting "Design Definition" and this accepts XSP markup so we can make our custom control look/feel exactly how we wish:


For the simple example of the tag cloud, we just include an image (which is stored in the resources/images) and a panel which reuses composite data defined in the custom control and set within the current XPage (this.viewName for this example). You can even use an XPage/custom control to design your "design definition" and copy/paste into the markup box.

<?xml version="1.0" encoding="UTF-8"?> 
<xp:view xmlns:xp="http://www.ibm.com/xsp/core"> 
<xp:image url="/ccTagCloud.gif"></xp:image> 
<xp:panel> 
tagCloud for <%=this.viewName %> 
</xp:panel> 
</xp:view>

  • Actions Show Menu▼


expanded Attachments (0)
collapsed Attachments (0)
Edit the article to add or modify attachments.
expanded Versions (3)
collapsed Versions (3)
Version Comparison     
VersionDateChanged by              Summary of changes
This version (3)Nov 3, 2009, 7:03:40 PMDeanna Drschiwiski  IBM contributor
2Oct 29, 2009, 1:44:39 PMDeanna Drschiwiski  IBM contributor
1Oct 16, 2009, 7:01:10 AMSteve Castledine  IBM contributor
expanded Comments (0)
collapsed Comments (0)
Copy and paste this wiki markup to link to this article from another article in this wiki.
Go ElsewhereStay ConnectedHelpAbout
  • IBM Collaboration Solutions wikis
  • IBM developerWorks
  • IBM Software support
  • Twitter LinkIBMSocialBizUX on Twitter
  • FacebookIBMSocialBizUX on Facebook
  • ForumsLotus product forums
  • BlogsIBM Social Business UX blog
  • Community LinkThe Social Lounge
  • Wiki Help
  • Forgot user name/password
  • About the wiki
  • About IBM
  • Privacy
  • Accessibility
  • IBM Terms of use
  • Wiki terms of use