Index: trunk/phase3/includes/Html.php |
— | — | @@ -99,8 +99,8 @@ |
100 | 100 | * |
101 | 101 | * @param $element string The element's name, e.g., 'a' |
102 | 102 | * @param $attribs array Associative array of attributes, e.g., array( |
103 | | - * 'href' => 'http://www.mediawiki.org/' ). Values will be HTML-escaped. |
104 | | - * A value of false means to omit the attribute. |
| 103 | + * 'href' => 'http://www.mediawiki.org/' ). See expandAttributes() for |
| 104 | + * further documentation. |
105 | 105 | * @param $contents string The raw HTML contents of the element: *not* |
106 | 106 | * escaped! |
107 | 107 | * @return string Raw HTML |
— | — | @@ -192,7 +192,8 @@ |
193 | 193 | * |
194 | 194 | * @param $element string Name of the element, e.g., 'a' |
195 | 195 | * @param $attribs array Associative array of attributes, e.g., array( |
196 | | - * 'href' => 'http://www.mediawiki.org/' ). |
| 196 | + * 'href' => 'http://www.mediawiki.org/' ). See expandAttributes() for |
| 197 | + * further documentation. |
197 | 198 | * @return array An array of attributes functionally identical to $attribs |
198 | 199 | */ |
199 | 200 | private static function dropDefaults( $element, $attribs ) { |
— | — | @@ -290,7 +291,9 @@ |
291 | 292 | * |
292 | 293 | * @param $attribs array Associative array of attributes, e.g., array( |
293 | 294 | * 'href' => 'http://www.mediawiki.org/' ). Values will be HTML-escaped. |
294 | | - * A value of false means to omit the attribute. |
| 295 | + * A value of false means to omit the attribute. For boolean attributes, |
| 296 | + * you can omit the key, e.g., array( 'checked' ) instead of |
| 297 | + * array( 'checked' => 'checked' ) or such. |
295 | 298 | * @return string HTML fragment that goes between element name and '>' |
296 | 299 | * (starting with a space if at least one attribute is output) |
297 | 300 | */ |