Autolist

How To - Auto List 1.2

------------------------------------------------------------------------------------

1. List description file
2. The header
3. List body
4. XML file example

1. List description file

The applet it is configured using the XML list description file. The name of the .xml file is set up by the value of the "listDescriptionFile" applet parameter. The XML document should contain the root element, <list> with a <listData> child element, which also must contain at least one <row> element.

The <list> element may contain an optional <config> element. The configuration elements may be gruped under this optional element or under the root element.

E. g.:

	<list>
		... configuration elements (optional) ...
		
		<config>
			... configuration elements (optional) ...
		</>
		
	<listData>
			<row .../>
			...
		</listData>
	</list>

2. The header

The number of columns and the names of the columns printed on the header are determined by the first <row> element from the <listData> section. The names of the columns correspond to the names of the XML attributes of the first row. The default size of each column is the double of its name length.

The default font for the column names is "Arial 11". It may be changed by using the <headerFont> configuration element. This element has three attributes: name - the name of the font, style - font style (italic, bold, plain) and size - the size of the font. E. g.:

<list>
		<config>
			<headerFont name="Times New Roman" style="Bold" size="12"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>

The size of the columns may be changed using the configuration element <colSize>. This element has attributes named "colX", where X is the index (starting with 1) of the column for each the size is specified. The size of a column having the index N can be specified only if all column sizes for indices less than N are specified too. E. g.:

<colSize col1="28" col2="45"/>

The height of the header is predefined and can not be changed.

3. List body

The body of the list contains the rows from the <listData> section. The height of the rows depend on the size of the used font.

For the font customization the following element is used <listFont>. This element is similar with the <headerFont> element. E. g.:

	<list>
		<config>
			<listFont name="Times New Roman" style="Bold" size="32"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>

A row may be linked to several URLs or can be used to call one or more javascript procedures. The XML element used in this cases is "link". This should be a child element for the row which it refers to. E. g.:

	<row No.="4" Product="Salt" Qty.="35" Unit="kg" Price="1.43">
		<link url="http://www.carpathia.ro" target="_blank"/>
		<link url="javascript:alert('You have clicked on: Product:Salt Qty:35 Unit:kg Price:1.43')"/>
		<link url="javascript:alert('This can be a link to multiple URLs or a call to javascrip procedures.')"/>
	</row>

The background color of the list it is controled by the <bkgColor> element. The default color is white. The <bkgColor> element has the attributes: red, green and blue, each of them requiring values form 0 to 255. E. g.:

	<list>
		<config>
			<bkgColor red="255" green="10" blue="10"/>
		</config>
		
		<listData>
			<row .../>
			...
		</listData>
	</list>

The color of the following items is configurable: background, text, selected text, selection, grid lines. E. g.:

	<bkgColor red="10" green="10" blue="10"/>
	<selectionColor red="120" green="120" blue="120"/>
	<selectedTextColor red="200" green="200" blue="200"/>
	<gridLinesColor red="150" green="200" blue="217"/>
	<textColor red="150" green="200" blue="217"/>

A default target for the links is supported: <defaultTarget value="_self"/>

The presence of grid: <useGrid value="yes"/>

4. XML file example

<list>
	<config>
		<headerFont name="Arial" style="Bold" size="11"/>
		<colSize col1="32" col2="72" col3="48" col4="50" col5="48"/>
		<bkgColor red="10" green="10" blue="10"/>
		<selectionColor red="120" green="120" blue="120"/>
		<gridLinesColor red="150" green="200" blue="217"/>
		<textColor red="150" green="200" blue="217"/>
		<useGrid value="yes"/>
	</config>
	<listData>
		<row No.="1" Product="Wood" Qty.="1000" Unit="sq. meter" Price="28"/>
		<row No.="2" Product="Oil" Qty.="2300" Unit="barrel" Price="45"/>
		<row No.="3" Product="Computers" Qty.="100" Unit="-" Price="1200">
			<link url="http://www.computers.com" target="_blank"/>
		</row>
		<row No.="4" Product="Salt" Qty.="35" Unit="kg" Price="1.43"/>
		<row No.="5" Product="Paper" Qty.="4300" Unit="kg" Price="1.60"/>
		<row No.="6" Product="Chairs" Qty.="87" Unit="-" Price="59"/>
		<row No.="7" Product="Books" Qty.="23566" Unit="-" Price="35"/>
		<row No.="6" Product="Cars" Qty.="200" Unit="-" Price="30000"/>
	</listData>
</list>

Back to Autolist

Applet Index
(sorted alphabetically)
A B C D E F G H I J K
L M N O P Q R S T U
V W X Y Z #s

The Java Source
(applets w/source code)
A B C D E F G H I J K
L M N O P Q R S T U
V W X Y Z

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.