mirror of
				https://github.com/smarty-php/smarty.git
				synced 2025-11-04 06:11:37 +01:00 
			
		
		
		
	
		
			
	
	
		
			142 lines
		
	
	
		
			5.0 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
		
		
			
		
	
	
			142 lines
		
	
	
		
			5.0 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
| 
								 | 
							
								<?xml version="1.0" encoding="iso-8859-1"?>
							 | 
						||
| 
								 | 
							
								<!-- $Revision$ -->
							 | 
						||
| 
								 | 
							
										<sect1 id="language.function.html.radios">
							 | 
						||
| 
								 | 
							
											<title>html_radios</title>
							 | 
						||
| 
								 | 
							
								            <informaltable frame="all">
							 | 
						||
| 
								 | 
							
								                <tgroup cols="5">
							 | 
						||
| 
								 | 
							
								                <colspec colname="param" align="center" />
							 | 
						||
| 
								 | 
							
								                <colspec colname="type" align="center" />
							 | 
						||
| 
								 | 
							
								                <colspec colname="required" align="center" />
							 | 
						||
| 
								 | 
							
								                <colspec colname="default" align="center" />
							 | 
						||
| 
								 | 
							
								                <colspec colname="desc" />
							 | 
						||
| 
								 | 
							
								                <thead>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>Attribute Name</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Type</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Required</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Default</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Description</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                </thead>
							 | 
						||
| 
								 | 
							
								                <tbody>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>name</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>string</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>No</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>radio</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>name of radio list</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>values</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>array</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Yes, unless using options attribute</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>n/a</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>an array of values for radio buttons</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>output</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>array</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Yes, unless using options attribute</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>n/a</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>an array of output for radio buttons</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>selected</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>string</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>No</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>empty</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>the selected radio element</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>options</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>associative array</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>Yes, unless using values and output</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>n/a</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>an associative array of values and output</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                    <row>
							 | 
						||
| 
								 | 
							
								                        <entry>separator</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>string</entry>
							 | 
						||
| 
								 | 
							
								                        <entry>No</entry>
							 | 
						||
| 
								 | 
							
								                        <entry><emphasis>empty</emphasis></entry>
							 | 
						||
| 
								 | 
							
								                        <entry>string of text to separate each radio item</entry>
							 | 
						||
| 
								 | 
							
								                    </row>
							 | 
						||
| 
								 | 
							
								                </tbody>
							 | 
						||
| 
								 | 
							
								                </tgroup>
							 | 
						||
| 
								 | 
							
								            </informaltable>
							 | 
						||
| 
								 | 
							
											<para>
							 | 
						||
| 
								 | 
							
											html_radios is a custom function that creates html radio button
							 | 
						||
| 
								 | 
							
											group with provided data. It takes care of which item is selected
							 | 
						||
| 
								 | 
							
											by default as well. Required attributes are values and output,
							 | 
						||
| 
								 | 
							
											unless you use options instead. All output is XHTML compatible.
							 | 
						||
| 
								 | 
							
											</para>
							 | 
						||
| 
								 | 
							
											<para>
							 | 
						||
| 
								 | 
							
											All parameters that are not in the list above are printed as
							 | 
						||
| 
								 | 
							
											name/value-pairs inside each of the created <input>-tags.
							 | 
						||
| 
								 | 
							
											</para>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<example>
							 | 
						||
| 
								 | 
							
								<title>html_radios</title>
							 | 
						||
| 
								 | 
							
								<programlisting>
							 | 
						||
| 
								 | 
							
								index.php:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								require('Smarty.class.php');
							 | 
						||
| 
								 | 
							
								$smarty = new Smarty;
							 | 
						||
| 
								 | 
							
								$smarty->assign('cust_ids', array(1000,1001,1002,1003));
							 | 
						||
| 
								 | 
							
								$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
							 | 
						||
| 
								 | 
							
								Johnson','Carlie Brown'));
							 | 
						||
| 
								 | 
							
								$smarty->assign('customer_id', 1001);
							 | 
						||
| 
								 | 
							
								$smarty->display('index.tpl');
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								index.tpl:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{html_radios values=$cust_ids selected=$customer_id output=$cust_names separator="<br />"}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								index.php:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								require('Smarty.class.php');
							 | 
						||
| 
								 | 
							
								$smarty = new Smarty;
							 | 
						||
| 
								 | 
							
								$smarty->assign('cust_radios', array(
							 | 
						||
| 
								 | 
							
											1001 => 'Joe Schmoe',
							 | 
						||
| 
								 | 
							
											1002 => 'Jack Smith',
							 | 
						||
| 
								 | 
							
											1003 => 'Jane Johnson',
							 | 
						||
| 
								 | 
							
											1004 => 'Charlie Brown'));
							 | 
						||
| 
								 | 
							
								$smarty->assign('customer_id', 1001);
							 | 
						||
| 
								 | 
							
								$smarty->display('index.tpl');
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								index.tpl:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								OUTPUT: (both examples)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<input type="radio" name="id[]" value="1000">Joe Schmoe<br />
							 | 
						||
| 
								 | 
							
								<input type="radio" name="id[]" value="1001" checked="checked"><br />
							 | 
						||
| 
								 | 
							
								<input type="radio" name="id[]" value="1002">Jane Johnson<br />
							 | 
						||
| 
								 | 
							
								<input type="radio" name="id[]" value="1003">Charlie Brown<br /></programlisting>
							 | 
						||
| 
								 | 
							
								</example>
							 | 
						||
| 
								 | 
							
								</sect1>
							 | 
						||
| 
								 | 
							
								<!-- Keep this comment at the end of the file
							 | 
						||
| 
								 | 
							
								Local variables:
							 | 
						||
| 
								 | 
							
								mode: sgml
							 | 
						||
| 
								 | 
							
								sgml-omittag:t
							 | 
						||
| 
								 | 
							
								sgml-shorttag:t
							 | 
						||
| 
								 | 
							
								sgml-minimize-attributes:nil
							 | 
						||
| 
								 | 
							
								sgml-always-quote-attributes:t
							 | 
						||
| 
								 | 
							
								sgml-indent-step:1
							 | 
						||
| 
								 | 
							
								sgml-indent-data:t
							 | 
						||
| 
								 | 
							
								indent-tabs-mode:nil
							 | 
						||
| 
								 | 
							
								sgml-parent-document:nil
							 | 
						||
| 
								 | 
							
								sgml-default-dtd-file:"../../../../manual.ced"
							 | 
						||
| 
								 | 
							
								sgml-exposed-tags:nil
							 | 
						||
| 
								 | 
							
								sgml-local-catalogs:nil
							 | 
						||
| 
								 | 
							
								sgml-local-ecat-files:nil
							 | 
						||
| 
								 | 
							
								End:
							 | 
						||
| 
								 | 
							
								vim600: syn=xml fen fdm=syntax fdl=2 si
							 | 
						||
| 
								 | 
							
								vim: et tw=78 syn=sgml
							 | 
						||
| 
								 | 
							
								vi: ts=1 sw=1
							 | 
						||
| 
								 | 
							
								-->
							 |