Options: if it contains a 'i' and/or a 'b' the content (not the label) is rendered in italic and/or bold.

Options has 2 comma-separated fields:
xml: size: the length in chars of the input-field
xml: maxlength: the maximum length of the input

Options has 3 comma-separated fields:
xml: min: minimum value, default none
xml: max: maximum value, default none
xml: size: the length in chars of the input-field, default 5

Options has 3 comma-separated fields:
xml: min: minimum value, default none
xml: max: maximum value, default none
xml: size: the length in chars of the input-field, default 5

Options has 2 comma-separated fields:
xml: cols: the width of the field in chars
xml: rows: the number of rows

onChange xml: onchange: if set and the user has JavaScript enabled the button is renderd as a link around the label and a hidden input to set id if the link is clicked.
Options xml: image, ro_image: Image to use instead of a Button with a label. There will be no button around the image. If a ro_image is given (separated by a comma in the editors options) it will be used if the button is set readonly (else the button is no rendered at all) .

multiselect: options > 1
<listbox rows="#"/>

Examples for predefined selectboxes:

<listbox type="select-cat" rows="5"/>

<menulist>
  <menupopup type="select-account" options="All,both,2"/>
</menulist>

1. in $content["options-$name"]
2. or in an separate array only for select-box-options under the index name, this array is passed to the exec or show function of the etemplate-class

xml: rows: only for <listbox>: number of rows to show

xml options: only for <menupopup/>: textual label for a first Row, e.g. 'All' or 'None' (id will be ''), additional attr see sub-types

xml: type: can be set to get several predefined select-contents, in that case you dont need to set the content as descripted above (if set it too its in front of the predefined rows):
select-cat:
Select a phpgw category
select-account:
Select a user and/or group, determined by the options-field:
,{accounts(default)|groups|both},{''(phpgw-default)|0(only lid)|1(only names)|2(both)}
select-percent, select-priority, select-access, select-country, select-state:
as you expect by the name
select-year, select-month, select-day:
options for year: ,start,end (start and end can be a number of years from now or if > 100 a absolut year)
select-number:
Select a number out of a range specified by the options-field:
,{start (default=1)},{end (incl., default=10)},{decrement (default=1)}
select-app:
Select an application, availible options: ,{''=user enabled(default)|installed|all)}

<date type="date-time"/>

<date type="date-timeonly" options="H:i"/>

<hbox span="all">
  <widget ...>
  <widget ...>
</hbox>

Options in the editor: the number of cells in the box (does NOT need to be set in xml).

The following fields / attributes are in the Editor and internaly in the class separeted by '|', in the xml/xul-file the are attributes of each tab- or grid-tag:
Label xml: label: the labels of the tabs eg. 'Tab 1|Tab 2|Tab 3'
Help xml: statustext: of the tabs
Name xml: id: the names/ids of the eTemplates/grid's to fill the bodies of the tabs, if the name contains no '.', it will be prefixed with the name of the template the widget is in plus a '.'

Demo: There is a demo availible: load 'etemplate.tab_widget.test' into the eTemplate editor and run it with show.

Options xml: options: name of the template to display the rows
Name xml: id: index into the content-array, it need to be pre-set with some information for the nextmatch widget and it returns its content with it:

$content[$id] = array(		// I = value set by the app, 0 = value on return / output
	'get_rows'     =>	// I  method/callback to request the data for the rows eg. 'notes.bo.get_rows'
	'filter_label' =>	// I  label for filter    (optional)
	'filter_help'  =>	// I  help-msg for filter (optional)
	'no_filter'    => True	// I  disable the 1. filter
	'no_filter2'   => True	// I  disable the 2. filter (params are the same as for filter)
	'no_cat'       => True	// I  disable the cat-selectbox
	'template'     =>	// I  template to use for the rows, if not set via options
	'header_left'  =>	// I  template to show left of the range-value, left-aligned (optional)
	'header_right' =>	// I  template to show right of the range-value, right-aligned (optional)
	'bottom_too'   => True	// I  show the nextmatch-line (arrows, filters, search, ...) again after the rows
	'start'        =>	// IO position in list
	'cat_id'       =>	// IO category, if not 'no_cat' => True
	'search'       =>	// IO search pattern
	'filter'       =>	// IO filter, if not 'no_filter' => True
	'filter2'      =>	// IO filter2, if not 'no_filter2' => True
	'rows'         =>	//  O content set by callback
	'total'        =>	//  O the total number of entries
);

/*
 * example: the get_rows function from notes.bo.get_rows (has to be in public_functions !)
 */
function get_rows($query,&$rows,&$readonlys)
{
	$rows = $this->read($query['start'],$query['search'],$query['filter'],$query['cat_id']);
	if (!is_array($rows))
	{
		$rows = array( );
	}
	else
	{
		array_unshift($rows,0); each($rows);	// first entry is not used !!!
	}
	$readonlys = array( );	// set readonlys to enable/disable our edit/delete-buttons
	while (list($n,$note) = each($rows))
	{
		if (!$this->check_perms($this->grants[$note['owner_id']],PHPGW_ACL_EDIT))
		{
			$readonlys["edit[$note[id]]"] = True;
		}
		if (!$this->check_perms($this->grants[$note['owner_id']],PHPGW_ACL_DELETE))
		{
			$readonlys["delete[$note[id]]"] = True;
		}
	}
	return $this->total_records;
}

/*
 * Example how the nextmatch-widget is used in notes.ui.index:
 */
function index($content = 0)
{
	if (!is_array($content))
	{
		$content = array('nm' => $this->session_data); // restore settings from the session
	}
	if (isset($content['nm']['rows']))		// one of the buttons in the rows is pressed
	{
		$this->session_data = $values['nm'];	// save the settings in the session
		unset($this->session_data['rows']);	// we dont want to save the content of the rows
		$this->save_sessiondata();

		if (isset($values['nm']['rows']['edit']))
		{
			list($id) = each($values['nm']['rows']['edit']);
			return $this->edit($id);
		}
		elseif (isset($values['nm']['rows']['delete']))
		{
			list($id) = each($values['nm']['rows']['delete']);
			return $this->delete($id);
		}
	}
	$values['nm']['options-filter'] = array (	// set up the data for our filter
		'all'			=> 'Show all',
		'public'		=> 'Only yours',
		'private'	=> 'Private'
	);
	$values['nm']['get_rows'] = 'notes.bo.get_rows';
	$values['nm']['no_filter2'] = True;		// disable the 2. filter

	$this->tpl->read('notes.index');
	$this->tpl->exec('notes.ui.index',$values);
}

<link type="link-list" id="name"/>

<link type="link-string" id="name"/>

link-list

link-string

link-to
Widget to make a links to other entries of link-aware apps and to attach files.

link-list
Widget to shows the links to an entry and a Unlink Button for each link.

Note: Both Widgets can be used on the same template with the same name. They share the content of that variable, which contains just the id of the entry in the current app.

link-string
Comma-separated list of link-titles with a link to its view-method, value is like the return of bolink::get_links().