HTML_Progress
[ class tree: HTML_Progress ] [ index: HTML_Progress ] [ all elements ]
Prev Next

setStringAttributes Manual

defines look and feel of the progress bar string

by by Laurent Laville
mailto:pear@laurent-laville.org
November 2003, Laurent Laville
(HTML_Progress 1.0+)

Synopsis

void setStringAttributes( $attributes )

Attributes

Name Type Default
attributes array
  • id => installationProgress
  • width => 50
  • font-family => Verdana, Arial, Helvetica, sans-serif
  • font-size => 12
  • color => #000000
  • background-color => #FFFFFF
  • align => right ( left, center )
  • for horizontal bar:
    • valign => right (left, top, bottom)
  • for vertical bar:
    • valign => bottom (top, left, right)

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

Description

The setStringAttributes() method is used to give a look and feel, such as alignment, size and color, to the progress bar string.

You may also used an existing StyleSheet and a CSS id 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"');
...
?>
   
<!-- custom stylesheet -->
...
.myPB .myPBstring { width: 100px; background-color: lightyellow; color: black; }
...
   

Example

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

  1. <?php
  2. require_once ('HTML/Progress.php');
  3.  
  4. $bar = new HTML_Progress();
  5. $bar->setValue(50);
  6. $bar->setBorderPainted(true);
  7.  
  8. $ui =$bar->getUI();
  9. $ui->setFillWay('reverse');
  10. $ui->setCellCount(5);
  11. $ui->setCellAttributes('active-color=#970038 inactive-color=#FFDDAA width=20');
  12. $ui->setBorderAttributes('width=1 color=#000000');
  13. $ui->setStringAttributes('font-size=14 color=#FF0000 align=left valign=bottom');
  14. ?>
  15. <!DOCTYPE html
  16.     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  17.     "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  18.  
  19. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
  20. <head>
  21. <title>setStringAttributes example</title>
  22. <style type="text/css">
  23. <!--
  24. <?php echo $bar->getStyle()?>
  25. // -->
  26. </style>
  27. <script type="text/javascript">
  28. <!--
  29. <?php echo $ui->getScript()?>
  30. //-->
  31. </script>
  32. </head>
  33. <body>
  34.  
  35. <?php 
  36. echo $bar->toHtml()
  37. $bar->display();
  38. ?>
  39.  
  40. </body>
  41. </html>

See Also

setStringPainted Manual

Prev Up Next
getStringAttributes Manual Reference Guides getBorderAttributes Manual

Documentation generated on Mon, 11 Mar 2019 13:52:35 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.