HTML_Progress_UI::setStringAttributes

sets the look and feel of the progress meter string

Synopsis

require_once 'HTML/Progress/UI.php';

void HTML_Progress_UI::setStringAttributes( mixed $attributes)

Description

This method is used to give a look and feel, such as alignment, size and color, to the progress meter string.

$attributes is an associative array or string of HTML tag attributes.

Parameter

mixed $attributes

the new string attributes of the progress meter.

Key-values allowed are:
Attribute Format Default value

id string installationProgress

width integer 50

font-family string Verdana, Arial, Helvetica, sans-serif

font-size integer 12

color string #000000

background-color string #FFFFFF

align string right

valign string HB=right, VB=bottom (HB:Horizontal Bar, VB:Vertical Bar)

Note

( HTML_Progress >= 1.0 )

This function can not be called statically.

You may also used an existing StyleSheet and a CSS class-selector with pre-defined style. For example:
<?php

require_once 'HTML/Progress.php';

$bar = new HTML_Progress();

// specify a user-ident (instead of the auto-generated value)

$bar->setIdent('myPB');

$bar->setStringPainted(true);

$ui =& $bar->getUI();

$ui->setStringAttributes('id="myPBstring"');

?>

could be replaced by:
<style type="text/css">  </style>

See

HTML_Progress_UI::getStringAttributes, HTML_Progress::setStringPainted

Example

Example below will produced a progress bar with a custom style string. It's a static example, the progress bar will not run.

<?php
require_once 'HTML/Progress.php';
 
$bar = new HTML_Progress();
$bar->setValue(50);
$bar->setBorderPainted(true);
 
$ui =& $bar->getUI();
$ui->setFillWay('reverse');
$ui->setCellCount(5);
$ui->setCellAttributes('active-color=#970038 inactive-color=#FFDDAA width=20');
$ui->setBorderAttributes('width=1 color=#000000');
$ui->setStringAttributes('font-size=14 color=#FF0000 align=left valign=bottom');
?>
<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>setStringAttributes example</title>
<style type="text/css">
<!--
<?php echo $bar->getStyle(); ?>
// -->
</style>
<script type="text/javascript">
<!--
<?php echo $ui->getScript(); ?>
//-->
</script>
</head>
<body>
 
<?php echo $bar->toHtml(); ?>
 
</body>
</html>