mirror of
				https://github.com/smarty-php/smarty.git
				synced 2025-10-31 04: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 | ||
|  | --> |