iUIView is a Domino web agent that provides an iPhone optimized user interface for any "classic" Notes categorized view, without the need to write any additional code or markup.
iUIView uses the open source iUI library to provide a polished, usable interface that mimics the familiar design layouts used in many of iPhone's native Cocoa Touch applications.
iUIView renders content optimized for the mobile version of Safari for both iPhone and iPod Touch, and will work equally as well for any of the next generation touch based mobile devices that use the mobile WebKit browser.
Features
- Edge-to-edge animated list navigation using the document categorization defined in a Notes view.
- Perform full text search queries on the underlying view using a simple search dialog.
- Provides lightweight content to the device in fragments loaded on demand using Ajax, suitable for low bandwidth EDGE and 3G networks.
- Easy to implement - simply copy one agent and a handful of iUI file resources to your database, construct your views (or use existing ones), then implement the appropriate ?OpenAgent URL references in your application.
Version History
- Version 0.6.5
- Implemented webkit css-based transitions for smoother animation
- Fixed full text search bug with custom site domains
- Exposed async agent parameter
- Addtional usage examples added to database launch page
- Version 0.6.0
- Added full text search support
- Minor code refactoring
- Version 0.5.0
- Initial release
Usage
Download the iUIView database, sign it and copy it to your Domino server. It contains an example view that can be tested by opening the database in Safari. To use iUIView in your own applications, copy the agent and all file resources into your database using Domino Designer.
iUIView is controlled by passing URL parameters to the agent. For example:
http://server/path/database.nsf/iUIView?OpenAgent&src=vehicles&cat=BMW&start=1
The above example would load the view named vehicles, showing only the entries within the category "BMW" starting at the first entry.
The following table defines the various parameters that can be used:
| Parameter | Mandatory? | Description |
|---|---|---|
| src | Yes | The name or alias of the view to be rendered. |
| cat | No | A category name to restrict the output to. Use ~~ to concatenate the category and any sub-categories. |
| start | No | The position of the view entry to start from. Default is 1 if not specified. |
| count | No | The number of entries to display. Default is 25 if not specified, maximum is 50. |
| ajaxlinks | No | Use 0 to force document links launched from the view to load in a new page. Default is 1 if not specified. |
| searchable | No | Use 1 to enable a full text search on the source view. Default is 0 if not specified. |
| async | No | Use 1 to load the view asynchronously from an existing iUI panel div. Default is 0 if not specified. |
There are a few caveats with respect to the format of the views that iUIView can support. Firstly, the categorization can only be done on text values and no hidden columns for the purposes of sorting can be used to the left of any categorized column. The right-most column in the view is always the one used to display the bottom level links to the underlying documents. Views displaying a document response hierarchy are also not supported.
Download
iUIView is completely free and open source. It is distributed under the New BSD License.
- Version 0.6.5 (December 2008)
- Version 0.6.0 (August 2008)
- Version 0.5.0 (May 2008)
Implementations
Resources
- iUI developed by Joe Hewitt
- Apple Developer Connection - Web Apps Dev Center (ADC registration required)
- WebKit - the open source engine behind Apple's Safari
- IBM Lotus Domino
- Aptana Studio and iPhone Development Plugin
Other Tools
Other tools I have created that relate to Eclipse, Notes and Domino:
- Domino Developer Plugin for Aptana Studio
- Formul8 for IBM Lotus Notes 8
- Secret Agent for IBM Lotus Notes 8
- SideLog for IBM Lotus Notes 8
Contact
I can be reached via email at jgilfelt [at] gmail [dot] com