com.newsblob.phphtmllib/tag_utils/wml_utils.inc

<?php

/**
 * This file contains some utility functions
 * to help build some Tag objects that are
 * commonly used in wml.
 *
 * This file only builds the helper functions that
 * build wml specific tags.  Some wml tags are identical
 * to their HTML counterparts.  You should use the html_*
 * functions for those.
 *
 * $Id: wml_utils.inc,v 1.2 2002/11/01 22:33:54 hemna Exp $
 *
 * @author Walter A. Boring IV <waboring@buildabetterweb.com>
 * @package phpHtmlLib
 * 
 */

/**
 * the list of html_* helper functions for HTML tags
 * that are valid for WML.
 *
 * html_head()
 * html_meta()
 * html_comment()
 * html_br()
 * html_p()
 * html_table()
 * html_td()
 * html_tr()
 * html_b()
 * html_big()
 * html_em()
 * html_i()
 * html_small()
 * html_strong()
 * html_u()
 * html_optgroup()
 * html_option()
 * 
 */ 


/**
 * build an href with content and attributes.
 *
 * @param   string $url - the href attribute.
 * @param   string $content - the visible link text.
 * @param   string $class - the css class to use.
 * @param   string $title - the title attribute
 * @return  Atag object.
 */
function wml_a($url, $content, $class=NULL, $title=NULL) {
        return html_a($url, $content, $class, NULL, $title);
}

/**
 * this builds an <anchor> tag
 *
 * @return ANCHORtag object
 */
function wml_anchor() {
    $tag = new ANCHORtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}

/**
 * this function builds a wml <access /> tag
 *
 * @param string - the domain attribute
 * @param string - the path attribute
 * @param string - the id attribute
 * @param string - the class attribute
 *
 * @return ACCESStag object
 */
function wml_access( $domain, $path=NULL, $id=NULL, $class=NULL ) {
        $attributes = array("domain" => $domain );

        if ($path != NULL) {
                $attributes["path"] = $path;
        }

        if ($id != NULL) {
                $attributes["id"] = $id;
        }

        if ($class != NULL) {
                $attributes["class"] = $class;
        }

        return new ACCESStag( $attributes );
}


/**
 * This function helps build a <card> tag
 *
 * @param string - the title attribute
 * @param string - the id attribute
 * @param string - the class attribute
 * @param mixed - any N number of params for
 *                content for the tag
 * @return CARDtag object
 */
function wml_card( $title, $id=NULL, $class=NULL ) {
        $attributes = array("title" => $title);

        if ($id != NULL) {
                $attributes["id"] = $id;
        }

        if ($class != NULL) {
                $attributes["class"] = $class;
        }

        $tag = new CARDtag( $attributes );
        $num_args = func_num_args();
        for ($i=3;$i<$num_args;$i++) {
                $tag->add(func_get_arg($i));
        }
    return $tag;
}


/**
 * This function builds the WML <do> tag
 *
 * @param string - the required 'type' attribute
 * @param mixed - any N number of params for
 *                content for the tag 
 * @return DOtag object
 */
function wml_do($type) {
        $tag = new DOtag( array("type" => $type ) );
        $num_args = func_num_args();
        for ($i=1;$i<$num_args;$i++) {
                $tag->add(func_get_arg($i));
        }
    return $tag;
}


/**
 * This function builds an <fieldset> tag
 * for WML.
 *
 * @param mixed - any N number of params for
 *                content for the tag 
 * @return FIELDSETtag object
 */
function wml_fieldset() {
    $tag = new FIELDSETtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}


/**
 * This function builds the WML <go> tag
 *
 * @param string - the required 'href' attribute
 * @param string - the optional 'method' attribute
 * @param mixed - any N number of params for
 *                content for the tag 
 * @return GOtag object
 */
function wml_go($href, $method="get") {
        $tag = new GOtag(array("href" => $href,
                                                   "method" => $method));
        $num_args = func_num_args();
        for ($i=2;$i<$num_args;$i++) {
                $tag->add(func_get_arg($i));
        }
    return $tag;
}

/**
 * This function builds an <img> tag,
 * which refers to a .wbmp format image.
 *
 *
 * @return IMGtag object
 */
function wml_img( $src, $width=NULL, $height=NULL, $alt=NULL) {
        $attributes = array("src" => $src);

        if ($width != NULL) {
                $attributes["width"] = $width;
        }
        if ($height != NULL) {
                $attributes["height"] = $height;
        }
        if ($alt != NULL) {
                $attributes["alt"] = $alt;
        }

        return new IMGtag( $attributes );
}


/**
 * This function builds the WML <input> tag object
 *
 * @param string - the required 'name' attribute
 *
 * @return INPUTtag object
 */
function wml_input($name, $type="text", $value=NULL, $size=NULL ) {
        $attributes = array( "name" => $name,
                                                 "type" => $text );

        if ($value != NULL) {
                $attributes["value"] = $value;
        }
        if ($size != NULL) {
                $attributes["size"] = $size;
        }


        return new INPUTtag( $attributes );
}

/**
 * This function builds the WML <noop> tag
 *
 * @return NOOPtag object
 */
function wml_noop() {
        return new NOOPtag;
}


/**
 * This function builds a WML <onevent> tag
 *
 * @param string - the required 'type' attribute
 *
 * @return ONEVENTtag object
 */
function wml_onevent( $type ) {
        $tag = new ONEVENTtag( array("type" => $type ) );
        $num_args = func_num_args();
        for ($i=1;$i<$num_args;$i++) {
                $tag->add(func_get_arg($i));
        }
    return $tag;
}
 
/**
 * This function builds a WML <postfield> tag
 *
 * @param string - the required 'name' attribute
 * @param string - the required 'value' attribute
 *
 * @return POSTFIELDtag object
 */
function wml_postfield( $name, $value ) {
        return new POSTFIELDtag( array( "name" => $name,
                                                                        "value" => $value ));
}

/**
 * This function builds a WML <prev> tag object
 *
 * @param mixed - any N number of params for
 *                content for the tag
 * 
 * @return PREVtag object
 */
function wml_prev() {
    $tag = new PREVtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}

/**
 * This function builds a WML <refresh> tag object
 *
 * @param mixed - any N number of params for
 *                content for the tag
 * 
 * @return REFRESHtag object
 */
function wml_refresh() {
    $tag = new REFRESHtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}

/**
 * This function builds the WML <select> tag
 *
 * @param array - an array of name value pairs for
 *                the options.  the format is
 *                array( LABEL => VALUE );
 *                each <option value="VALUE">LABEL</option>
 *                ie
 *                array( "test" => "foo")  would give an option
 *                of <option value="foo">test</option>
 *
 * @return SELECTtag object
 */
function wml_select($options=array()) {
        $tag = new SELECTtag;
        foreach ( $options as $content => $value ) {
                $select->add( html_option($value, $content) );
        }
        return $select;

}

/**
 * This function builds the WML <setvar> tag
 *
 * @param string - the required 'name' attribute
 * @param string - the required 'value' attribute
 * @return SETVARtag object
 */
function wml_setvar($name, $value) {
        return new SETVARtag( array("name" => $name,
                                                                "value" => $value));
}

/**
 * this function builds a <template> tag
 * and it's content
 *
 * @param mixed - any N number of params for
 *                content for the tag
 *
 * @return TEMPLATEtag object
 */
function wml_template() {
    $tag = new TEMPLATEtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}

/**
 * This function builds the WML <timer> tag
 * the time unit of the value is 1/10 of a second.
 *
 * @param string - the required 'value' attribute
 *
 * @return TIMERtag object
 */
function wml_timer( $value ) {
        return new TIMERtag( array("value" => $value ));
}


/**
 * This function builds a <wml> tag
 *
 * @param mixed - any N number of params for
 *                content for the tag
 *
 * @return WMLtag object
 */
function wml_tag( ) {
    $tag = new TEMPLATEtag;
        $args = func_get_args();
    call_user_func_array( array(&$tag, "add"), $args);
    return $tag;
}

?>
1	jonen	1.1	<?php
2
3			/**
4			* This file contains some utility functions
5			* to help build some Tag objects that are
6			* commonly used in wml.
7			*
8			* This file only builds the helper functions that
9			* build wml specific tags. Some wml tags are identical
10			* to their HTML counterparts. You should use the html_*
11			* functions for those.
12			*
13			* $Id: wml_utils.inc,v 1.2 2002/11/01 22:33:54 hemna Exp $
14			*
15			* @author Walter A. Boring IV <waboring@buildabetterweb.com>
16			* @package phpHtmlLib
17			*
18			*/
19
20			/**
21			* the list of html_* helper functions for HTML tags
22			* that are valid for WML.
23			*
24			* html_head()
25			* html_meta()
26			* html_comment()
27			* html_br()
28			* html_p()
29			* html_table()
30			* html_td()
31			* html_tr()
32			* html_b()
33			* html_big()
34			* html_em()
35			* html_i()
36			* html_small()
37			* html_strong()
38			* html_u()
39			* html_optgroup()
40			* html_option()
41			*
42			*/
43
44
45			/**
46			* build an href with content and attributes.
47			*
48			* @param string $url - the href attribute.
49			* @param string $content - the visible link text.
50			* @param string $class - the css class to use.
51			* @param string $title - the title attribute
52			* @return Atag object.
53			*/
54			function wml_a($url, $content, $class=NULL, $title=NULL) {
55			return html_a($url, $content, $class, NULL, $title);
56			}
57
58			/**
59			* this builds an <anchor> tag
60			*
61			* @return ANCHORtag object
62			*/
63			function wml_anchor() {
64			$tag = new ANCHORtag;
65			$args = func_get_args();
66			call_user_func_array( array(&$tag, "add"), $args);
67			return $tag;
68			}
69
70			/**
71			* this function builds a wml <access /> tag
72			*
73			* @param string - the domain attribute
74			* @param string - the path attribute
75			* @param string - the id attribute
76			* @param string - the class attribute
77			*
78			* @return ACCESStag object
79			*/
80			function wml_access( $domain, $path=NULL, $id=NULL, $class=NULL ) {
81			$attributes = array("domain" => $domain );
82
83			if ($path != NULL) {
84			$attributes["path"] = $path;
85			}
86
87			if ($id != NULL) {
88			$attributes["id"] = $id;
89			}
90
91			if ($class != NULL) {
92			$attributes["class"] = $class;
93			}
94
95			return new ACCESStag( $attributes );
96			}
97
98
99			/**
100			* This function helps build a <card> tag
101			*
102			* @param string - the title attribute
103			* @param string - the id attribute
104			* @param string - the class attribute
105			* @param mixed - any N number of params for
106			* content for the tag
107			* @return CARDtag object
108			*/
109			function wml_card( $title, $id=NULL, $class=NULL ) {
110			$attributes = array("title" => $title);
111
112			if ($id != NULL) {
113			$attributes["id"] = $id;
114			}
115
116			if ($class != NULL) {
117			$attributes["class"] = $class;
118			}
119
120			$tag = new CARDtag( $attributes );
121			$num_args = func_num_args();
122			for ($i=3;$i<$num_args;$i++) {
123			$tag->add(func_get_arg($i));
124			}
125			return $tag;
126			}
127
128
129			/**
130			* This function builds the WML <do> tag
131			*
132			* @param string - the required 'type' attribute
133			* @param mixed - any N number of params for
134			* content for the tag
135			* @return DOtag object
136			*/
137			function wml_do($type) {
138			$tag = new DOtag( array("type" => $type ) );
139			$num_args = func_num_args();
140			for ($i=1;$i<$num_args;$i++) {
141			$tag->add(func_get_arg($i));
142			}
143			return $tag;
144			}
145
146
147			/**
148			* This function builds an <fieldset> tag
149			* for WML.
150			*
151			* @param mixed - any N number of params for
152			* content for the tag
153			* @return FIELDSETtag object
154			*/
155			function wml_fieldset() {
156			$tag = new FIELDSETtag;
157			$args = func_get_args();
158			call_user_func_array( array(&$tag, "add"), $args);
159			return $tag;
160			}
161
162
163			/**
164			* This function builds the WML <go> tag
165			*
166			* @param string - the required 'href' attribute
167			* @param string - the optional 'method' attribute
168			* @param mixed - any N number of params for
169			* content for the tag
170			* @return GOtag object
171			*/
172			function wml_go($href, $method="get") {
173			$tag = new GOtag(array("href" => $href,
174			"method" => $method));
175			$num_args = func_num_args();
176			for ($i=2;$i<$num_args;$i++) {
177			$tag->add(func_get_arg($i));
178			}
179			return $tag;
180			}
181
182			/**
183			* This function builds an <img> tag,
184			* which refers to a .wbmp format image.
185			*
186			*
187			* @return IMGtag object
188			*/
189			function wml_img( $src, $width=NULL, $height=NULL, $alt=NULL) {
190			$attributes = array("src" => $src);
191
192			if ($width != NULL) {
193			$attributes["width"] = $width;
194			}
195			if ($height != NULL) {
196			$attributes["height"] = $height;
197			}
198			if ($alt != NULL) {
199			$attributes["alt"] = $alt;
200			}
201
202			return new IMGtag( $attributes );
203			}
204
205
206			/**
207			* This function builds the WML <input> tag object
208			*
209			* @param string - the required 'name' attribute
210			*
211			* @return INPUTtag object
212			*/
213			function wml_input($name, $type="text", $value=NULL, $size=NULL ) {
214			$attributes = array( "name" => $name,
215			"type" => $text );
216
217			if ($value != NULL) {
218			$attributes["value"] = $value;
219			}
220			if ($size != NULL) {
221			$attributes["size"] = $size;
222			}
223
224
225			return new INPUTtag( $attributes );
226			}
227
228			/**
229			* This function builds the WML <noop> tag
230			*
231			* @return NOOPtag object
232			*/
233			function wml_noop() {
234			return new NOOPtag;
235			}
236
237
238			/**
239			* This function builds a WML <onevent> tag
240			*
241			* @param string - the required 'type' attribute
242			*
243			* @return ONEVENTtag object
244			*/
245			function wml_onevent( $type ) {
246			$tag = new ONEVENTtag( array("type" => $type ) );
247			$num_args = func_num_args();
248			for ($i=1;$i<$num_args;$i++) {
249			$tag->add(func_get_arg($i));
250			}
251			return $tag;
252			}
253
254			/**
255			* This function builds a WML <postfield> tag
256			*
257			* @param string - the required 'name' attribute
258			* @param string - the required 'value' attribute
259			*
260			* @return POSTFIELDtag object
261			*/
262			function wml_postfield( $name, $value ) {
263			return new POSTFIELDtag( array( "name" => $name,
264			"value" => $value ));
265			}
266
267			/**
268			* This function builds a WML <prev> tag object
269			*
270			* @param mixed - any N number of params for
271			* content for the tag
272			*
273			* @return PREVtag object
274			*/
275			function wml_prev() {
276			$tag = new PREVtag;
277			$args = func_get_args();
278			call_user_func_array( array(&$tag, "add"), $args);
279			return $tag;
280			}
281
282			/**
283			* This function builds a WML <refresh> tag object
284			*
285			* @param mixed - any N number of params for
286			* content for the tag
287			*
288			* @return REFRESHtag object
289			*/
290			function wml_refresh() {
291			$tag = new REFRESHtag;
292			$args = func_get_args();
293			call_user_func_array( array(&$tag, "add"), $args);
294			return $tag;
295			}
296
297			/**
298			* This function builds the WML <select> tag
299			*
300			* @param array - an array of name value pairs for
301			* the options. the format is
302			* array( LABEL => VALUE );
303			* each <option value="VALUE">LABEL</option>
304			* ie
305			* array( "test" => "foo") would give an option
306			* of <option value="foo">test</option>
307			*
308			* @return SELECTtag object
309			*/
310			function wml_select($options=array()) {
311			$tag = new SELECTtag;
312			foreach ( $options as $content => $value ) {
313			$select->add( html_option($value, $content) );
314			}
315			return $select;
316
317			}
318
319			/**
320			* This function builds the WML <setvar> tag
321			*
322			* @param string - the required 'name' attribute
323			* @param string - the required 'value' attribute
324			* @return SETVARtag object
325			*/
326			function wml_setvar($name, $value) {
327			return new SETVARtag( array("name" => $name,
328			"value" => $value));
329			}
330
331			/**
332			* this function builds a <template> tag
333			* and it's content
334			*
335			* @param mixed - any N number of params for
336			* content for the tag
337			*
338			* @return TEMPLATEtag object
339			*/
340			function wml_template() {
341			$tag = new TEMPLATEtag;
342			$args = func_get_args();
343			call_user_func_array( array(&$tag, "add"), $args);
344			return $tag;
345			}
346
347			/**
348			* This function builds the WML <timer> tag
349			* the time unit of the value is 1/10 of a second.
350			*
351			* @param string - the required 'value' attribute
352			*
353			* @return TIMERtag object
354			*/
355			function wml_timer( $value ) {
356			return new TIMERtag( array("value" => $value ));
357			}
358
359
360			/**
361			* This function builds a <wml> tag
362			*
363			* @param mixed - any N number of params for
364			* content for the tag
365			*
366			* @return WMLtag object
367			*/
368			function wml_tag( ) {
369			$tag = new TEMPLATEtag;
370			$args = func_get_args();
371			call_user_func_array( array(&$tag, "add"), $args);
372			return $tag;
373			}
374
375			?>
MailToCvsAdmin">MailToCvsAdmin	ViewVC Help
Powered by ViewVC 1.1.26