| [ Index ] |
|
Code source de eGroupWare 1.2.106-2 |
1 <?php 2 /**************************************************************************\ 3 * eGroupWare - HTML creation class * 4 * http://www.eGroupWare.org * 5 * Written and (c) by Ralf Becker <RalfBecker@outdoor-training.de> * 6 * -------------------------------------------- * 7 * This program is free software; you can redistribute it and/or modify it * 8 * under the terms of the GNU General Public License as published by the * 9 * Free Software Foundation; either version 2 of the License, or (at your * 10 * option) any later version. * 11 \**************************************************************************/ 12 13 /* $Id: class.html.inc.php 22277 2006-08-18 09:22:30Z ralfbecker $ */ 14 15 /** 16 * generates html with methods representing html-tags or higher widgets 17 * 18 * @package api 19 * @subpackage html 20 * @author RalfBecker-AT-outdoor-training.de 21 * @license GPL 22 */ 23 class html 24 { 25 /** 26 * user-agent: 'mozilla','msie','konqueror', 'safari', 'opera' 27 * @var string 28 */ 29 var $user_agent; 30 /** 31 * version of user-agent as specified by browser 32 * @var string 33 */ 34 var $ua_version; 35 /** 36 * what attribute to use for the title of an image: 'title' for everything but netscape4='alt' 37 * @var string 38 */ 39 var $prefered_img_title; 40 /** 41 * charset used by the page, as returned by $GLOBALS['egw']->translation->charset() 42 * @var string 43 */ 44 var $charset; 45 /** 46 * URL (NOT path) of the js directory in the api 47 * @var string 48 */ 49 var $phpgwapi_js_url; 50 /** 51 * do we need to set the wz_tooltip class, to be included at the end of the page 52 * @var boolean 53 */ 54 var $wz_tooltip_included = False; 55 56 /** 57 * Constructor: initialised the class-vars 58 */ 59 function html() 60 { 61 // should be Ok for all HTML 4 compatible browsers 62 if (!eregi('(Safari)/([0-9.]+)',$_SERVER['HTTP_USER_AGENT'],$parts) && 63 !eregi('compatible; ([a-z_]+)[/ ]+([0-9.]+)',$_SERVER['HTTP_USER_AGENT'],$parts)) 64 { 65 eregi('^([a-z_]+)/([0-9.]+)',$_SERVER['HTTP_USER_AGENT'],$parts); 66 } 67 list(,$this->user_agent,$this->ua_version) = $parts; 68 $this->user_agent = strtolower($this->user_agent); 69 70 $this->netscape4 = $this->user_agent == 'mozilla' && $this->ua_version < 5; 71 $this->prefered_img_title = $this->netscape4 ? 'alt' : 'title'; 72 //echo "<p>HTTP_USER_AGENT='$_SERVER[HTTP_USER_AGENT]', UserAgent: '$this->user_agent', Version: '$this->ua_version', img_title: '$this->prefered_img_title'</p>\n"; 73 74 if ($GLOBALS['egw']->translation) 75 { 76 $this->charset = $GLOBALS['egw']->translation->charset(); 77 } 78 $this->phpgwapi_js_url = $GLOBALS['egw_info']['server']['webserver_url'].'/phpgwapi/js'; 79 } 80 81 /** 82 * Created an input-field with an attached color-picker 83 * 84 * Please note: it need to be called before the call to phpgw_header() !!! 85 * 86 * @param string $name the name of the input-field 87 * @param string $value the actual value for the input-field, default '' 88 * @param string $title tooltip/title for the picker-activation-icon 89 * @return string the html 90 */ 91 function inputColor($name,$value='',$title='') 92 { 93 $id = str_replace(array('[',']'),array('_',''),$name).'_colorpicker'; 94 $onclick = "javascript:window.open('".$this->phpgwapi_js_url.'/colorpicker/select_color.html?id='.urlencode($id)."&color='+document.getElementById('$id').value,'colorPicker','width=240,height=187,scrollbars=no,resizable=no,toolbar=no');"; 95 return '<input type="text" name="'.$name.'" id="'.$id.'" value="'.$this->htmlspecialchars($value).'" /> '. 96 '<a href="#" onclick="'.$onclick.'">'. 97 '<img src="'.$this->phpgwapi_js_url.'/colorpicker/ed_color_bg.gif'.'"'.($title ? ' title="'.$this->htmlspecialchars($title).'"' : '')." /></a>"; 98 } 99 100 /** 101 * Handles tooltips via the wz_tooltip class from Walter Zorn 102 * 103 * Note: The wz_tooltip.js file gets automaticaly loaded at the end of the page 104 * 105 * @param string/boolean $text text or html for the tooltip, all chars allowed, they will be quoted approperiate 106 * Or if False the content (innerHTML) of the element itself is used. 107 * @param boolean $do_lang (default False) should the text be run though lang() 108 * @param array $options param/value pairs, eg. 'TITLE' => 'I am the title'. Some common parameters: 109 * title (string) gives extra title-row, width (int,'auto') , padding (int), above (bool), bgcolor (color), bgimg (URL) 110 * For a complete list and description see http://www.walterzorn.com/tooltip/tooltip_e.htm 111 * @return string to be included in any tag, like '<p'.$html->tooltip('Hello <b>Ralf</b>').'>Text with tooltip</p>' 112 */ 113 function tooltip($text,$do_lang=False,$options=False) 114 { 115 if (!$this->wz_tooltip_included) 116 { 117 if (!strstr('wz_tooltip',$GLOBALS['egw_info']['flags']['need_footer'])) 118 { 119 $GLOBALS['egw_info']['flags']['need_footer'] .= '<script language="JavaScript" type="text/javascript" src="'.$this->phpgwapi_js_url.'/wz_tooltip/wz_tooltip.js"></script>'."\n"; 120 } 121 $this->wz_tooltip_included = True; 122 } 123 if ($do_lang) $text = lang($text); 124 125 $opt_out = 'this.T_WIDTH = 200;'; 126 if (is_array($options)) 127 { 128 foreach($options as $option => $value) 129 { 130 $opt_out .= 'this.T_'.strtoupper($option).'='.(is_numeric($value)?$value:"'".str_replace(array("'",'"'),array("\\'",'"'),$value)."'").'; '; 131 132 } 133 } 134 if ($text === False) return ' onmouseover="'.$opt_out.'return escape(this.innerHTML);"'; 135 136 return ' onmouseover="'.$opt_out.'return escape(\''.str_replace(array("\n","\r","'",'"'),array('','',"\\'",'"'),$text).'\')"'; 137 } 138 139 /** 140 * activates URLs in a text, URLs get replaced by html-links 141 * 142 * @param string $content text containing URLs 143 * @return string html with activated links 144 */ 145 function activate_links($content) 146 { 147 // Exclude everything which is already a link 148 $NotAnchor = '(?<!"|href=|href\s=\s|href=\s|href\s=)'; 149 150 // spamsaver emailaddress 151 $result = preg_replace('/'.$NotAnchor.'mailto:([a-z0-9._-]+)@([a-z0-9_-]+)\.([a-z0-9._-]+)/i', 152 '<a href="#" onclick="document.location=\'mai\'+\'lto:\\1\'+unescape(\'%40\')+\'\\2.\\3\'; return false;">\\1 AT \\2 DOT \\3</a>', 153 $content); 154 155 // First match things beginning with http:// (or other protocols) 156 $Protocol = '(http|ftp|https):\/\/'; 157 $Domain = '([\w]+.[\w]+)'; 158 $Subdir = '([\w\-\.,@?^=%&;:\/~\+#]*[\w\-\@?^=%&\/~\+#])?'; 159 $Expr = '/' . $NotAnchor . $Protocol . $Domain . $Subdir . '/i'; 160 161 $result = preg_replace( $Expr, "<a href=\"$0\" target=\"_blank\">$2$3</a>", $result ); 162 163 // Now match things beginning with www. 164 $NotHTTP = '(?<!:\/\/)'; 165 $Domain = 'www(.[\w]+)'; 166 $Subdir = '([\w\-\.,@?^=%&:\/~\+#]*[\w\-\@?^=%&\/~\+#])?'; 167 $Expr = '/' . $NotAnchor . $NotHTTP . $Domain . $Subdir . '/i'; 168 169 return preg_replace( $Expr, "<a href=\"http://$0\" target=\"_blank\">$0</a>", $result ); 170 } 171 172 /** 173 * escapes chars with special meaning in html as entities 174 * 175 * Allows to use and char in the html-output and prefents XSS attacks. 176 * Some entities are allowed and get NOT escaped: 177 * - &# some translations (AFAIK the arabic ones) need this 178 * - < > for convinience 179 * 180 * @param string $str string to escape 181 * @return string 182 */ 183 function htmlspecialchars($str) 184 { 185 // add @ by lkneschke to supress warning about unknown charset 186 $str = @htmlspecialchars($str,ENT_COMPAT,$this->charset); 187 188 // we need '&#' unchanged, so we translate it back 189 $str = str_replace(array('&#','&nbsp;','&lt;','&gt;'),array('&#',' ','<','>'),$str); 190 191 return $str; 192 } 193 194 /** 195 * allows to show and select one item from an array 196 * 197 * @param string $name string with name of the submitted var which holds the key of the selected item form array 198 * @param string/array $key key(s) of already selected item(s) from $arr, eg. '1' or '1,2' or array with keys 199 * @param array $arr array with items to select, eg. $arr = array ( 'y' => 'yes','n' => 'no','m' => 'maybe'); 200 * @param boolean $no_lang NOT run the labels of the options through lang(), default false=use lang() 201 * @param string $options additional options (e.g. 'width') 202 * @param int $multiple number of lines for a multiselect, default 0 = no multiselect, < 0 sets size without multiple 203 * @return string to set for a template or to echo into html page 204 */ 205 function select($name, $key, $arr=0,$no_lang=false,$options='',$multiple=0) 206 { 207 if (!is_array($arr)) 208 { 209 $arr = array('no','yes'); 210 } 211 if ((int)$multiple > 0) 212 { 213 $options .= ' multiple="1" size="'.(int)$multiple.'"'; 214 if (substr($name,-2) != '[]') 215 { 216 $name .= '[]'; 217 } 218 } 219 elseif($multiple < 0) 220 { 221 $options .= ' size="'.abs($multiple).'"'; 222 } 223 $out = "<select name=\"$name\" $options>\n"; 224 225 if (!is_array($key)) 226 { 227 // explode on ',' only if multiple values expected and the key contains just numbers and commas 228 $key = $multiple > 0 && preg_match('/^[,0-9]+$/',$key) ? explode(',',$key) : array($key); 229 } 230 foreach($arr as $k => $data) 231 { 232 if (!is_array($data) || count($data) == 2 && isset($data['label']) && isset($data['title'])) 233 { 234 $out .= $this->select_option($k,is_array($data)?$data['label']:$data,$key,$no_lang, 235 is_array($data)?$data['title']:''); 236 } 237 else 238 { 239 $out .= '<optgroup label="'.$this->htmlspecialchars($no_lang || $k == '' ? $k : lang($k))."\">\n"; 240 241 foreach($data as $k => $label) 242 { 243 $out .= $this->select_option($k,is_array($label)?$label['label']:$label,$key,$no_lang, 244 is_array($label)?$lable['title']:''); 245 } 246 $out .= "</optgroup>\n"; 247 } 248 } 249 $out .= "</select>\n"; 250 251 return $out; 252 } 253 254 /** 255 * emulating a multiselectbox using checkboxes 256 * 257 * Unfortunaly this is not in all aspects like a multi-selectbox, eg. you cant select options via javascript 258 * in the same way. Therefor I made it an extra function. 259 * 260 * @param string $name string with name of the submitted var which holds the key of the selected item form array 261 * @param string/array $key key(s) of already selected item(s) from $arr, eg. '1' or '1,2' or array with keys 262 * @param array $arr array with items to select, eg. $arr = array ( 'y' => 'yes','n' => 'no','m' => 'maybe'); 263 * @param boolean $no_lang NOT run the labels of the options through lang(), default false=use lang() 264 * @param string $options additional options (e.g. 'width') 265 * @param int $multiple number of lines for a multiselect, default 3 266 * @param boolean $selected_first show the selected items before the not selected ones, default true 267 * @param string $style='' extra style settings like "width: 100%", default '' none 268 * @return string to set for a template or to echo into html page 269 */ 270 function checkbox_multiselect($name, $key, $arr=0,$no_lang=false,$options='',$multiple=3,$selected_first=true,$style='') 271 { 272 //echo "<p align=right>checkbox_multiselect('$name',".print_r($key,true).",".print_r($arr,true).",$no_lang,'$options',$multiple,$selected_first,'$style')</p>\n"; 273 if (!is_array($arr)) 274 { 275 $arr = array('no','yes'); 276 } 277 if ((int)$multiple <= 0) $multiple = 1; 278 279 if (substr($name,-2) != '[]') 280 { 281 $name .= '[]'; 282 } 283 $base_name = substr($name,0,-2); 284 285 if (!is_array($key)) 286 { 287 // explode on ',' only if multiple values expected and the key contains just numbers and commas 288 $key = preg_match('/^[,0-9]+$/',$key) ? explode(',',$key) : array($key); 289 } 290 $html = ''; 291 $options_no_id = preg_replace('/id="[^"]+"/i','',$options); 292 293 if ($selected_first) 294 { 295 $selected = $not_selected = array(); 296 foreach($arr as $val => $label) 297 { 298 if (in_array($val,$key,!$val)) 299 { 300 $selected[$val] = $label; 301 } 302 else 303 { 304 $not_selected[$val] = $label; 305 } 306 } 307 $arr = $selected + $not_selected; 308 } 309 foreach($arr as $val => $label) 310 { 311 if (is_array($label)) 312 { 313 $title = $label['title']; 314 $label = $label['label']; 315 } 316 else 317 { 318 $title = ''; 319 } 320 if ($label && !$no_lang) $label = lang($label); 321 if ($title && !$no_lang) $title = lang($title); 322 323 if (strlen($label) > $max_len) $max_len = strlen($label); 324 325 $html .= $this->label($this->checkbox($name,in_array($val,$key),$val,$options_no_id. 326 ' id="'.$base_name.'['.$val.']'.'"').$this->htmlspecialchars($label), 327 $base_name.'['.$val.']','',($title ? 'title="'.$this->htmlspecialchars($title).'" ':''))."<br />\n"; 328 } 329 if ($style && substr($style,-1) != ';') $style .= '; '; 330 if (!strstr($style,'height')) $style .= 'height: '.(1.7*$multiple).'em; '; 331 if (!strstr($style,'width')) $style .= 'width: '.(4+$max_len*($max_len < 15 ? 0.65 : 0.55)).'em; '; 332 $style .= 'background-color: white; overflow: auto; border: lightgray 2px inset;'; 333 334 return $this->div($html,$options,'',$style); 335 } 336 337 /** 338 * generates an option-tag for a selectbox 339 * 340 * @param string $value value 341 * @param string $label label 342 * @param mixed $selected value or array of values of options to mark as selected 343 * @param boolean $no_lang NOT running the label through lang(), default false=use lang() 344 * @return string html 345 */ 346 function select_option($value,$label,$selected,$no_lang=0,$title='') 347 { 348 // the following compares strict as strings, to archive: '0' == 0 != '' 349 // the first non-strict search via array_search, is for performance reasons, to not always search the whole array with php 350 if (($found = ($key = array_search($value,$selected)) !== false) && !$value) 351 { 352 if ((string) $value !== (string) $selected[$key]) 353 { 354 $found = false; 355 foreach($selected as $sel) 356 { 357 if ($found = ((string) $value === (string) $selected[$key])) break; 358 } 359 } 360 } 361 return '<option value="'.$this->htmlspecialchars($value).'"'.($found ? ' selected="selected"' : '') . 362 ($title ? ' title="'.$this->htmlspecialchars($no_lang ? $title : lang($title)).'"' : '') . '>'. 363 $this->htmlspecialchars($no_lang || $label == '' ? $label : lang($label)) . "</option>\n"; 364 } 365 366 /** 367 * generates a div-tag 368 * 369 * @param string $content of a div, or '' to generate only the opening tag 370 * @param string $options to include in the tag, default ''=none 371 * @param string $class css-class attribute, default ''=none 372 * @param string $style css-styles attribute, default ''=none 373 * @return string html 374 */ 375 function div($content,$options='',$class='',$style='') 376 { 377 if ($class) $options .= ' class="'.$class.'"'; 378 if ($style) $options .= ' style="'.$style.'"'; 379 380 return "<div $options>\n".($content ? "$content</div>\n" : ''); 381 } 382 383 /** 384 * generate one or more hidden input tag(s) 385 * 386 * @param array/string $vars var-name or array with name / value pairs 387 * @param string $value value if $vars is no array, default '' 388 * @param boolean $ignore_empty if true all empty, zero (!) or unset values, plus filer=none 389 * @param string html 390 */ 391 function input_hidden($vars,$value='',$ignore_empty=True) 392 { 393 if (!is_array($vars)) 394 { 395 $vars = array( $vars => $value ); 396 } 397 foreach($vars as $name => $value) 398 { 399 if (is_array($value)) 400 { 401 $value = serialize($value); 402 } 403 if (!$ignore_empty || $value && !($name == 'filter' && $value == 'none')) // dont need to send all the empty vars 404 { 405 $html .= "<input type=\"hidden\" name=\"$name\" value=\"".$this->htmlspecialchars($value)."\" />\n"; 406 } 407 } 408 return $html; 409 } 410 411 /** 412 * generate a textarea tag 413 * 414 * @param string $name name attr. of the tag 415 * @param string $value default 416 * @param boolean $ignore_empty if true all empty, zero (!) or unset values, plus filer=none 417 * @param string html 418 */ 419 function textarea($name,$value='',$options='' ) 420 { 421 return "<textarea name=\"$name\" $options>".$this->htmlspecialchars($value)."</textarea>\n"; 422 } 423 424 /** 425 * Checks if HTMLarea (or an other richtext editor) is availible for the used browser 426 * 427 * @return boolean 428 */ 429 function htmlarea_availible() 430 { 431 switch($this->user_agent) 432 { 433 case 'msie': 434 return $this->ua_version >= 5.5; 435 case 'mozilla': 436 return $this->ua_version >= 1.3; 437 default: 438 return False; 439 } 440 } 441 442 /** 443 * compability function for former used htmlarea. Please use function tinymce now! 444 * 445 * creates a textarea inputfield for the htmlarea js-widget (returns the necessary html and js) 446 */ 447 function htmlarea($name,$content='',$style='',$base_href='',$plugins='',$custom_toolbar='',$set_width_height_in_config=false) 448 { 449 if (!$plugins) $plugins = 'ColorChooser,FontChooser,ContexMenu,TableOperations'; 450 return $this->tinymce($name,$content,$style,$plugins,$base_href); 451 } 452 453 /** 454 * init the tinymce js-widget by adding the js file in the head of the page 455 * 456 * Please note: it need to be called before the call to phpgw_header() !!! 457 * 458 */ 459 function init_tinymce() 460 { 461 /* do stuff once */ 462 if (!is_object($GLOBALS['egw']->js)) 463 { 464 $GLOBALS['egw']->js = CreateObject('phpgwapi.javascript'); 465 } 466 467 if (!strstr($GLOBALS['egw_info']['flags']['java_script'],'tinyMCE')) 468 { 469 $GLOBALS['egw']->js->validate_file('tinymce','jscripts/tiny_mce/tiny_mce'); 470 } 471 } 472 473 /** 474 * creates a textarea inputfield for the tinymce js-widget (returns the necessary html and js) 475 * 476 * Please note: if you did not run init_tinymce already you this function need to be called before the call to phpgw_header() !!! 477 * 478 * @param string $name name and id of the input-field 479 * @param string $content='' of the tinymce (will be run through htmlspecialchars !!!), default '' 480 * @param string $style='' initial css for the style attribute 481 * @param string $init_options='', see http://tinymce.moxiecode.com/ for all init options. mode and elements are allready set. 482 * to make things more easy, you also can just provide a comma seperated list here with the options you need. 483 * Supportet are: 'TableOperations','ContextMenu','ColorChooser' 484 * @return string the necessary html for the textarea 485 * @todo make wrapper for backwards compatibility with htmlarea 486 * @todo enable all features from htmlarea 487 */ 488 function tinymce($name,$content='',$style='',$init_options='',$base_href='') 489 { 490 if (!$style) 491 { 492 $style = 'width:100%; min-width:500px; height:300px;'; 493 } 494 if (!$this->htmlarea_availible()) 495 { 496 return $this->textarea($name,$content,'style="'.$style.'"'); 497 } 498 499 /* do stuff once */ 500 $this->init_tinymce(); 501 502 if(strpos($init_options,':') === false) 503 { 504 $init = 'theme : "advanced", theme_advanced_toolbar_location : "top", theme_advanced_toolbar_align : "left"'; 505 $tab1a = 'theme_advanced_buttons1_add : "'; 506 $tab2a = 'theme_advanced_buttons2_add : "'; 507 $tab3a = 'theme_advanced_buttons3_add : "separator,fullscreen'; 508 $plugs = 'plugins : "paste,fullscreen,advimage,advlink'; 509 $eve = 'extended_valid_elements : "a[name|href|target|title|onclick], img[class|src|border=0|alt|title|hspace|vspace|width|height|align|onmouseover|onmouseout|name],font[*]'; 510 if($init_options) 511 { 512 foreach(explode(',',$init_options) as $plugin) 513 { 514 switch($plugin) 515 { 516 case 'TableOperations' : 517 $plugs .= ',table'; 518 $tab3a .= ',separator,tablecontrols'; 519 break; 520 case 'ContextMenu' : 521 $plugs .= ',contextmenu'; 522 break; 523 case 'ColorChooser' : 524 $tab3a .= ',separator,forecolor,backcolor'; 525 break; 526 case 'FontChooser' : 527 $tab1a .= ',fontselect,fontsizeselect'; 528 $init .= ',theme_advanced_disable : "styleselect"'; 529 break; 530 case 'FileManager' : 531 $plugs .= ',filemanager'; 532 $tab3a .= ',separator,filemanager'; 533 break; 534 case 'SearchReplace' : 535 $plugs .= ',searchreplace'; 536 $tab1a .= ',separator,search,replace'; 537 break; 538 case 'InsertDateTime' : 539 $plugs .= ',insertdatetime'; 540 $tab2a .= ',separator,insertdate,inserttime'; 541 break; 542 default: 543 if(strstr($plugin,'=')) 544 { 545 $init .= ','. str_replace('=',':',$plugin); 546 } 547 } 548 } 549 } 550 if($base_href) 551 { 552 $init .= ',document_base_url : "'. $base_href. '", relative_urls : true'; 553 } 554 555 $init_options = $init. ','. $tab1a. '",'. $tab2a. '",'. $tab3a. '",'. $plugs. '",'. $eve. '"'; 556 } 557 558 /* do again and again */ 559 return '<script language="javascript" type="text/javascript"> 560 tinyMCE.init({ 561 mode : "exact", 562 language: "'.$GLOBALS['egw_info']['user']['preferences']['common']['lang'].'", 563 plugin_insertdate_dateFormat : "'.str_replace(array('Y','m','M','d'),array('%Y','%m','%b','%d'),$GLOBALS['egw_info']['user']['preferences']['common']['dateformat']).' ", 564 plugin_insertdate_timeFormat : "'.($GLOBALS['egw_info']['user']['preferences']['common']['timeformat'] == 12 ? '%I:%M %p' : '%H:%M').' ", 565 elements : "'.$name.'", 566 '.$init_options.' 567 }); 568 </script> 569 570 <textarea id="'.$name.'" name="'.$name.'" style="'.$style.'"> 571 '.@htmlspecialchars($content,ENT_COMPAT,$this->charset).' 572 </textarea> 573 '; 574 } 575 576 /** 577 * represents html's input tag 578 * 579 * @param string $name name 580 * @param string $value default value of the field 581 * @param string $type type, default ''=not specified = text 582 * @param string $options attributes for the tag, default ''=none 583 */ 584 function input($name,$value='',$type='',$options='' ) 585 { 586 if ($type) 587 { 588 $type = 'type="'.$type.'"'; 589 } 590 return "<input $type name=\"$name\" value=\"".$this->htmlspecialchars($value)."\" $options />\n"; 591 } 592 593 /** 594 * represents html's button (input type submit or image) 595 * 596 * @param string $name name 597 * @param string $label label of the button 598 * @param string $onClick javascript to call, when button is clicked 599 * @param boolean $no_lang NOT running the label through lang(), default false=use lang() 600 * @param string $options attributes for the tag, default ''=none 601 * @param string $image to show instead of the label, default ''=none 602 * @param string $app app to search the image in 603 * @return string html 604 */ 605 function submit_button($name,$label,$onClick='',$no_lang=false,$options='',$image='',$app='phpgwapi') 606 { 607 // workaround for idots and IE button problem (wrong cursor-image) 608 if ($this->user_agent == 'msie') 609 { 610 $options .= ' style="cursor: pointer; cursor: hand;"'; 611 } 612 if ($image != '') 613 { 614 $image = str_replace(array('.gif','.GIF','.png','.PNG'),'',$image); 615 616 if (!($path = $GLOBALS['egw']->common->image($app,$image))) 617 { 618 $path = $image; // name may already contain absolut path 619 } 620 $image = ' src="'.$path.'"'; 621 } 622 if (!$no_lang) 623 { 624 $label = lang($label); 625 } 626 if (($accesskey = strstr($label,'&')) && $accesskey[1] != ' ' && 627 (($pos = strpos($accesskey,';')) === False || $pos > 5)) 628 { 629 $label_u = str_replace('&'.$accesskey[1],'<u>'.$accesskey[1].'</u>',$label); 630 $label = str_replace('&','',$label); 631 $options = 'accesskey="'.$accesskey[1].'" '.$options; 632 } 633 else 634 { 635 $accesskey = ''; 636 $label_u = $label; 637 } 638 if ($onClick) $options .= ' onclick="'.str_replace('"','\\"',$onClick).'"'; 639 640 // <button> is not working in all cases if ($this->user_agent == 'mozilla' && $this->ua_version < 5 || $image) 641 { 642 return $this->input($name,$label,$image != '' ? 'image' : 'submit',$options.$image); 643 } 644 return '<button type="submit" name="'.$name.'" value="'.$label.'" '.$options.' />'. 645 ($image != '' ? "<img$image $this->prefered_img_title=\"$label\"> " : ''). 646 ($image == '' || $accesskey ? $label_u : '').'</button>'; 647 } 648 649 /** 650 * creates an absolut link + the query / get-variables 651 * 652 * Example link('/index.php?menuaction=infolog.uiinfolog.get_list',array('info_id' => 123)) 653 * gives 'http://domain/phpgw-path/index.php?menuaction=infolog.uiinfolog.get_list&info_id=123' 654 * 655 * @param string $url phpgw-relative link, may include query / get-vars 656 * @param array/string $vars query or array ('name' => 'value', ...) with query 657 * @return string absolut link already run through $phpgw->link 658 */ 659 function link($url,$vars='') 660 { 661 //echo "<p>html::link(url='$url',vars='"; print_r($vars); echo "')</p>\n"; 662 if (!is_array($vars)) 663 { 664 parse_str($vars,$vars); 665 } 666 list($url,$v) = explode('?',$url); // url may contain additional vars 667 if ($v) 668 { 669 parse_str($v,$v); 670 $vars += $v; 671 } 672 return $GLOBALS['egw']->link($url,$vars); 673 } 674 675 /** 676 * represents html checkbox 677 * 678 * @param string $name name 679 * @param boolean $checked box checked on display 680 * @param string $value value the var should be set to, default 'True' 681 * @param string $options attributes for the tag, default ''=none 682 * @return string html 683 */ 684 function checkbox($name,$checked=false,$value='True',$options='') 685 { 686 return '<input type="checkbox" name="'.$name.'" value="'.$this->htmlspecialchars($value).'"' .($checked ? ' checked="1"' : '') . "$options />\n"; 687 } 688 689 /** 690 * represents a html form 691 * 692 * @param string $content of the form, if '' only the opening tag gets returned 693 * @param array $hidden_vars array with name-value pairs for hidden input fields 694 * @param string $url eGW relative URL, will be run through the link function, if empty the current url is used 695 * @param string/array $url_vars parameters for the URL, send to link function too 696 * @param string $name name of the form, defaul ''=none 697 * @param string $options attributes for the tag, default ''=none 698 * @param string $method method of the form, default 'POST' 699 * @return string html 700 */ 701 function form($content,$hidden_vars,$url,$url_vars='',$name='',$options='',$method='POST') 702 { 703 $url = $url ? $this->link($url,$url_vars) : $_SERVER['PHP_SELF'].'?'.$_SERVER['QUERY_STRING']; 704 $html = "<form method=\"$method\" ".($name != '' ? "name=\"$name\" " : '')."action=\"$url\" $options>\n"; 705 $html .= $this->input_hidden($hidden_vars); 706 707 if ($content) 708 { 709 $html .= $content; 710 $html .= "</form>\n"; 711 } 712 return $html; 713 } 714 715 /** 716 * represents a html form with one button 717 * 718 * @param string $name name of the button 719 * @param string $label label of the button 720 * @param array $hidden_vars array with name-value pairs for hidden input fields 721 * @param string $url eGW relative URL, will be run through the link function 722 * @param string/array $url_vars parameters for the URL, send to link function too 723 * @param string $options attributes for the tag, default ''=none 724 * @param string $form_name name of the form, defaul ''=none 725 * @param string $method method of the form, default 'POST' 726 * @return string html 727 */ 728 function form_1button($name,$label,$hidden_vars,$url,$url_vars='',$form_name='',$method='POST') 729 { 730 return $this->form($this->submit_button($name,$label),$hidden_vars,$url,$url_vars,$form_name,'',$method); 731 } 732 733 /** 734 * creates table from array of rows 735 * 736 * abstracts the html stuff for the table creation 737 * Example: $rows = array ( 738 * '1' => array( 739 * 1 => 'cell1', '.1' => 'colspan=3', 740 * 2 => 'cell2', 741 * 3 => 'cell3', '.3' => 'width="10%"' 742 * ),'.1' => 'BGCOLOR="#0000FF"' ); 743 * table($rows,'width="100%"') = '<table width="100%"><tr><td colspan=3>cell1</td><td>cell2</td><td width="10%">cell3</td></tr></table>' 744 * 745 * @param array $rows with rows, each row is an array of the cols 746 * @param string $options options for the table-tag 747 * @param boolean $no_table_tr dont return the table- and outmost tr-tabs, default false=return table+tr 748 * @return string with html-code of the table 749 */ 750 function table($rows,$options = '',$no_table_tr=False) 751 { 752 $html = $no_table_tr ? '' : "<table $options>\n"; 753 754 foreach($rows as $key => $row) 755 { 756 if (!is_array($row)) 757 { 758 continue; // parameter 759 } 760 $html .= $no_table_tr && $key == 1 ? '' : "\t<tr ".$rows['.'.$key].">\n"; 761 762 foreach($row as $key => $cell) 763 { 764 if ($key[0] == '.') 765 { 766 continue; // parameter 767 } 768 $table_pos = strpos($cell,'<table'); 769 $td_pos = strpos($cell,'<td'); 770 if ($td_pos !== False && ($table_pos === False || $td_pos < $table_pos)) 771 { 772 $html .= $cell; 773 } 774 else 775 { 776 $html .= "\t\t<td ".$row['.'.$key].">$cell</td>\n"; 777 } 778 } 779 $html .= "\t</tr>\n"; 780 } 781 if (!is_array($rows)) 782 { 783 echo "<p>".function_backtrace()."</p>\n"; 784 } 785 $html .= "</table>\n"; 786 787 if ($no_table_tr) 788 { 789 $html = substr($html,0,-16); 790 } 791 return $html; 792 } 793 794 /** 795 * changes a selectbox to submit the form if it gets changed, to be used with the sbox-class 796 * 797 * @param string $sbox html with the select-box 798 * @param boolean $no_script if true generate a submit-button if javascript is off 799 * @return string html 800 */ 801 function sbox_submit( $sbox,$no_script=false ) 802 { 803 $html = str_replace('<select','<select onchange="this.form.submit()" ',$sbox); 804 if ($no_script) 805 { 806 $html .= '<noscript>'.$this->submit_button('send','>').'</noscript>'; 807 } 808 return $html; 809 } 810 811 /** 812 * html-widget showing progessbar with a view div's (html4 only, textual percentage otherwise) 813 * 814 * @param mixed $percent percent-value, gets casted to int 815 * @param string $title title for the progressbar, default ''=the percentage itself 816 * @param string $options attributes for the outmost div (may include onclick="...") 817 * @param string $width width, default 30px 818 * @param string $color color, default '#D00000' (dark red) 819 * @param string $height height, default 5px 820 * @return string html 821 */ 822 function progressbar( $percent,$title='',$options='',$width='',$color='',$height='' ) 823 { 824 $percent = (int) $percent; 825 if (!$width) $width = '30px'; 826 if (!$height)$height= '5px'; 827 if (!$color) $color = '#D00000'; 828 $title = $title ? $this->htmlspecialchars($title) : $percent.'%'; 829 830 if ($this->netscape4) 831 { 832 return $title; 833 } 834 return '<div class="onlyPrint">'.$title.'</div><div class="noPrint" title="'.$title.'" '.$options. 835 ' style="height: '.$height.'; width: '.$width.'; border: 1px solid black; padding: 1px; text-align: left;'. 836 (stristr($options,'onclick="') ? ' cursor: pointer; cursor: hand;' : '').'">'."\n\t". 837 '<div style="height: '.$height.'; width: '.$percent.'%; background: '.$color.';"></div>'."\n</div>\n"; 838 } 839 840 /** 841 * representates a html img tag, output a picture 842 * 843 * If the name ends with a '%' and the rest is numeric, a progressionbar is shown instead of an image. 844 * The vfs:/ pseudo protocoll allows to access images in the vfs, eg. vfs:/home/ralf/me.png 845 * Instead of a name you specify an array with get-vars, it is passed to eGW's link function. 846 * This way session-information gets passed, eg. $name=array('menuaction'=>'myapp.class.image','id'=>123). 847 * 848 * @param string $app app-name to search the image 849 * @param string/array $name image-name or URL (incl. vfs:/) or array with get-vars 850 * @param string $title tooltip, default '' = none 851 * @param string $options further options for the tag, default '' = none 852 * @return string the html 853 */ 854 function image( $app,$name,$title='',$options='' ) 855 { 856 if (substr($name,0,5) == 'vfs:/') // vfs pseudo protocoll 857 { 858 $parts = explode('/',substr($name,4)); 859 $file = array_pop($parts); 860 $path = implode('/',$parts); 861 $name = array( 862 'menuaction' => 'filemanager.uifilemanager.view', 863 'path' => rawurlencode(base64_encode($path)), 864 'file' => rawurlencode(base64_encode($file)), 865 ); 866 } 867 if (is_array($name)) // menuaction and other get-vars 868 { 869 $name = $GLOBALS['egw']->link('/index.php',$name); 870 } 871 if ($name[0] == '/' || substr($name,0,7) == 'http://' || substr($name,0,8) == 'https://') 872 { 873 $url = $name; 874 } 875 else // no URL, so try searching the image 876 { 877 $name = str_replace(array('.gif','.GIF','.png','.PNG'),'',$name); 878 879 if (!($url = $GLOBALS['egw']->common->image($app,$name))) 880 { 881 $url = $name; // name may already contain absolut path 882 } 883 if($GLOBALS['egw_info']['server']['webserver_url']) 884 { 885 list(,$path) = explode($GLOBALS['egw_info']['server']['webserver_url'],$url); 886 887 if (!is_null($path)) $path = EGW_SERVER_ROOT.$path; 888 } 889 else 890 { 891 $path = EGW_SERVER_ROOT.$url; 892 } 893 if (is_null($path) || !@is_readable($path)) 894 { 895 // if the image-name is a percentage, use a progressbar 896 if (substr($name,-1) == '%' && is_numeric($percent = substr($name,0,-1))) 897 { 898 return $this->progressbar($percent,$title); 899 } 900 return $title; 901 } 902 } 903 if ($title) 904 { 905 $options .= " $this->prefered_img_title=\"".$this->htmlspecialchars($title).'"'; 906 } 907 return "<img src=\"$url\" $options />"; 908 } 909 910 /** 911 * representates a html link 912 * 913 * @param string $content of the link, if '' only the opening tag gets returned 914 * @param string $url eGW relative URL, will be run through the link function 915 * @param string/array $vars parameters for the URL, send to link function too 916 * @param string $options attributes for the tag, default ''=none 917 * @return string the html 918 */ 919 function a_href( $content,$url,$vars='',$options='') 920 { 921 if (!strstr($url,'/') && count(explode('.',$url)) == 3) 922 { 923 $url = "/index.php?menuaction=$url"; 924 } 925 if (is_array($url)) 926 { 927 $vars = $url; 928 $url = '/index.php'; 929 } 930 //echo "<p>html::a_href('".htmlspecialchars($content)."','$url',".print_r($vars,True).") = ".$this->link($url,$vars)."</p>"; 931 return '<a href="'.$this->link($url,$vars).'" '.$options.'>'.$content.'</a>'; 932 } 933 934 /** 935 * representates a b tab (bold) 936 * 937 * @param string $content of the link, if '' only the opening tag gets returned 938 * @return string the html 939 */ 940 function bold($content) 941 { 942 return '<b>'.$content.'</b>'; 943 } 944 945 /** 946 * representates a i tab (bold) 947 * 948 * @param string $content of the link, if '' only the opening tag gets returned 949 * @return string the html 950 */ 951 function italic($content) 952 { 953 return '<i>'.$content.'</i>'; 954 } 955 956 /** 957 * representates a hr tag (horizontal rule) 958 * 959 * @param string $width default ''=none given 960 * @param string $options attributes for the tag, default ''=none 961 * @return string the html 962 */ 963 function hr($width='',$options='') 964 { 965 if ($width) $options .= " width=\"$width\""; 966 967 return "<hr $options />\n"; 968 } 969 970 /** 971 * formats option-string for most of the above functions 972 * 973 * Example: formatOptions('100%,,1','width,height,border') = ' width="100%" border="1"' 974 * 975 * @param mixed $options String (or Array) with option-values eg. '100%,,1' 976 * @param mixed $names String (or Array) with the option-names eg. 'WIDTH,HEIGHT,BORDER' 977 * @return string with options/attributes 978 */ 979 function formatOptions($options,$names) 980 { 981 if (!is_array($options)) $options = explode(',',$options); 982 if (!is_array($names)) $names = explode(',',$names); 983 984 foreach($options as $n => $val) 985 { 986 if ($val != '' && $names[$n] != '') 987 { 988 $html .= ' '.strtolower($names[$n]).'="'.$val.'"'; 989 } 990 } 991 return $html; 992 } 993 994 /** 995 * returns simple stylesheet (incl. <STYLE> tags) for nextmatch row-colors 996 * 997 * @deprecated included now always by the framework 998 * @return string classes 'th' = nextmatch header, 'row_on'+'row_off' = alternating rows 999 */ 1000 function themeStyles() 1001 { 1002 return $this->style($this->theme2css()); 1003 } 1004 1005 /** 1006 * returns simple stylesheet for nextmatch row-colors 1007 * 1008 * @deprecated included now always by the framework 1009 * @return string classes 'th' = nextmatch header, 'row_on'+'row_off' = alternating rows 1010 */ 1011 function theme2css() 1012 { 1013 return ".th { background: ".$GLOBALS['egw_info']['theme']['th_bg']."; }\n". 1014 ".row_on,.th_bright { background: ".$GLOBALS['egw_info']['theme']['row_on']."; }\n". 1015 ".row_off { background: ".$GLOBALS['egw_info']['theme']['row_off']."; }\n"; 1016 } 1017 1018 /** 1019 * html style tag (incl. type) 1020 * 1021 * @param string $styles css-style definitions 1022 * @return string html 1023 */ 1024 function style($styles) 1025 { 1026 return $styles ? "<style type=\"text/css\">\n<!--\n$styles\n-->\n</style>" : ''; 1027 } 1028 1029 /** 1030 * html label tag 1031 * 1032 * @param string $content the label 1033 * @param string $id for the for attribute, default ''=none 1034 * @param string $accesskey accesskey, default ''=none 1035 * @param string $options attributes for the tag, default ''=none 1036 * @return string the html 1037 */ 1038 function label($content,$id='',$accesskey='',$options='') 1039 { 1040 if ($id != '') 1041 { 1042 $id = " for=\"$id\""; 1043 } 1044 if ($accesskey != '') 1045 { 1046 $accesskey = " accesskey=\"$accesskey\""; 1047 } 1048 return "<label$id$accesskey $options>$content</label>"; 1049 } 1050 1051 /** 1052 * html fieldset, eg. groups a group of radiobuttons 1053 * 1054 * @param string $content the content 1055 * @param string $legend legend / label of the fieldset, default ''=none 1056 * @param string $options attributes for the tag, default ''=none 1057 * @return string the html 1058 */ 1059 function fieldset($content,$legend='',$options='') 1060 { 1061 $html = "<fieldset $options>".($legend ? '<legend>'.$this->htmlspecialchars($legend).'</legend>' : '')."\n"; 1062 1063 if ($content) 1064 { 1065 $html .= $content; 1066 $html .= "\n</fieldset>\n"; 1067 } 1068 return $html; 1069 } 1070 1071 /** 1072 * tree widget using dhtmlXtree 1073 * 1074 * Code inspired by Lars's Felamimail uiwidgets::createFolderTree() 1075 * 1076 * @author Lars Kneschke <lars-AT-kneschke.de> original code in felamimail 1077 * @param array $_folders array of folders: pairs path => node (string label or array with keys: label, (optional) image, (optional) title, (optional) checked) 1078 * @param string $_selected path of selected folder 1079 * @param mixed $_topFolder=false node of topFolder or false for none 1080 * @param string $_onNodeSelect='alert' js function to call if node gets selected 1081 * @param string $_divId='foldertree' id of the div 1082 * @param string $_divClass='' css class of the div 1083 * @param string $_leafImage='' default image of a leaf-node, ''=default of foldertree, set it eg. 'folderClosed.gif' to show leafs as folders 1084 * @param boolean/string $_onCheckHandler=false string with handler-name to display a checkbox for each folder, or false (default) 1085 * @param string $delimiter='/' path-delimiter, default / 1086 * 1087 * @return string the html code, to be added into the template 1088 */ 1089 function tree($_folders,$_selected,$_topFolder=false,$_onNodeSelect="null",$_divId='foldertree',$_divClass='',$_leafImage='',$_onCheckHandler=false,$delimiter='/') 1090 { 1091 $folderImageDir = $GLOBALS['egw_info']['server']['webserver_url'].'/phpgwapi/templates/default/images/'; 1092 1093 $html = $this->div("\n",'id="'.$_divId.'"',$_divClass); 1094 1095 static $tree_initialised=false; 1096 if (!$tree_initialised) 1097 { 1098 $html .= '<link rel="STYLESHEET" type="text/css" href="'.$GLOBALS['egw_info']['server']['webserver_url'].'/phpgwapi/js/dhtmlxtree/css/dhtmlXTree.css">'."\n"; 1099 $html .= "<script type='text/javascript' src='{$GLOBALS['egw_info']['server']['webserver_url']}/phpgwapi/js/dhtmlxtree/js/dhtmlXCommon.js'></script>\n"; 1100 $html .= "<script type='text/javascript' src='{$GLOBALS['egw_info']['server']['webserver_url']}/phpgwapi/js/dhtmlxtree/js/dhtmlXTree.js'></script>\n"; 1101 $tree_initialised = true; 1102 } 1103 $html .= "<script type='text/javascript'>\n"; 1104 $html .= "tree=new dhtmlXTreeObject('$_divId','100%','100%',0);\n"; 1105 $html .= "tree.setImagePath('$folderImageDir/dhtmlxtree/');\n"; 1106 1107 if($_onCheckHandler) 1108 { 1109 $html .= "tree.enableCheckBoxes(1);\n"; 1110 $html .= "tree.setOnCheckHandler('$_onCheckHandler');\n"; 1111 } 1112 1113 $top = 0; 1114 if ($_topFolder) 1115 { 1116 $top = '--topfolder--'; 1117 $topImage = ''; 1118 if (is_array($_topFolder)) 1119 { 1120 $label = $_topFolder['label']; 1121 if (isset($_topFolder['image'])) 1122 { 1123 $topImage = $_topFolder['image']; 1124 } 1125 } 1126 else 1127 { 1128 $label = $_topFolder; 1129 } 1130 $html .= "\ntree.insertNewItem(0,'$top','".addslashes($label)."',$_onNodeSelect,'$topImage','$topImage','$topImage','CHILD,TOP');\n"; 1131 1132 if (is_array($_topFolder) && isset($_topFolder['title'])) 1133 { 1134 $html .= "tree.setItemText('$top','".addslashes($label)."','".addslashes($_topFolder['title'])."');\n"; 1135 } 1136 } 1137 // evtl. remove leading delimiter 1138 if ($_selected{0} == $delimiter) $_selected = substr($_selected,1); 1139 foreach($_folders as $path => $data) 1140 { 1141 if (!is_array($data)) 1142 { 1143 $data = array('label' => $data); 1144 } 1145 $image1 = $image2 = $image3 = '0'; 1146 if (isset($data['image'])) 1147 { 1148 $image1 = $image2 = $image3 = "'".$data['image']."'"; 1149 } 1150 // evtl. remove leading delimiter 1151 if ($path{0} == $delimiter) $path = substr($path,1); 1152 $folderParts = explode($delimiter,$path); 1153 1154 //get rightmost folderpart 1155 $label = array_pop($folderParts); 1156 if (isset($data['label'])) $label = $data['label']; 1157 1158 // the rest of the array is the name of the parent 1159 $parentName = implode((array)$folderParts,$delimiter); 1160 if(empty($parentName)) $parentName = $top; 1161 1162 $entryOptions = 'CHILD,CHECKED'; 1163 // highlight currently item 1164 if ($_selected === $path) 1165 { 1166 $entryOptions .= ',SELECT'; 1167 } 1168 $html .= "tree.insertNewItem('".addslashes($parentName)."','".addslashes($path)."','".addslashes($label). 1169 "',$_onNodeSelect,$image1,$image2,$image3,'$entryOptions');\n"; 1170 if (isset($data['title'])) 1171 { 1172 $html .= "tree.setItemText('".addslashes($path)."','".addslashes($label)."','".addslashes($data['title'])."');\n"; 1173 } 1174 if($_displayCheckBox) 1175 { 1176 $html .= "tree.setCheck('".addslashes($path)."','".(int)$data['checked']."');"; 1177 } 1178 } 1179 $html .= "tree.closeAllItems(0);\n"; 1180 $html .= "tree.openItem('".($_selected ? addslashes($_selected) : $top)."');\n"; 1181 $html .= "</script>\n"; 1182 1183 return $html; 1184 } 1185 }
titre
Description
Corps
titre
Description
Corps
titre
Description
Corps
titre
Corps
| Généré le : Sun Feb 25 17:20:01 2007 | par Balluche grâce à PHPXref 0.7 |