PHP Classes

File: htdocs/xoops_lib/vendor/smarty/smarty/docs/designers/language-custom-functions/language-function-html-radios.md

Recommend this page to a friend!
  Packages of Michael Beck   Xoops 2.5   htdocs/xoops_lib/vendor/smarty/smarty/docs/designers/language-custom-functions/language-function-html-radios.md   Download  
File: htdocs/xoops_lib/vendor/smarty/smarty/docs/designers/language-custom-functions/language-function-html-radios.md
Role: Example script
Content type: text/markdown
Description: Example script
Class: Xoops 2.5
Modular content management publication system
Author: By
Last change:
Date: 2 months ago
Size: 5,729 bytes
 

Contents

Class file image Download

{html_radios}

{html_radios} is a custom function that creates an HTML radio button group. It also takes care of which item is selected by default as well.

Attributes

| Attribute Name | Required | Description | |----------------|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | name | No | Name of radio list | | values | Yes, unless using options attribute | An array of values for radio buttons | | output | Yes, unless using options attribute | An array of output for radio buttons | | selected | No | The selected radio element | | options | Yes, unless using values and output | An associative array of values and output | | separator | No | String of text to separate each radio item | | assign | No | Assign radio tags to an array instead of output | | labels | No | Add <label>-tags to the output (defaults to true) | | label\_ids | No | Add id-attributes to <label\> and <input\> to the output (defaults to false) | | escape | No | Escape the output / content (values are always escaped) (defaults to true) | | strict | No | Will make the "extra" attributes disabled and readonly only be set, if they were supplied with either boolean TRUE or string "disabled" and "readonly" respectively (defaults to false) |

  • Required attributes are `values` and `output`, unless you use `options` instead.
  • All output is XHTML compliant.
  • All parameters that are not in the list above are output as name/value-pairs inside each of the created `<input>`-tags.

Examples

<?php

$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
                              'Joe Schmoe',
                              'Jack Smith',
                              'Jane Johnson',
                              'Charlie Brown')
                              );
$smarty->assign('customer_id', 1001);
  

Where template is:

{html_radios name='id' values=$cust_ids output=$cust_names
       selected=$customer_id separator='<br />'}

<?php
$smarty->assign('cust_radios', array(
                               1000 => 'Joe Schmoe',
                               1001 => 'Jack Smith',
                               1002 => 'Jane Johnson',
                               1003 => 'Charlie Brown'));
$smarty->assign('customer_id', 1001);

Where template is:


{html_radios name='id' options=$cust_radios
     selected=$customer_id separator='<br />'}
  

Both examples will output:

<label><input type="radio" name="id" value="1000" />Joe Schmoe</label><br />
<label><input type="radio" name="id" value="1001" checked="checked" />Jack Smith</label><br />
<label><input type="radio" name="id" value="1002" />Jane Johnson</label><br />
<label><input type="radio" name="id" value="1003" />Charlie Brown</label><br />
  

<?php

$sql = 'select type_id, types from contact_types order by type';
$smarty->assign('contact_types',$db->getAssoc($sql));

$sql = 'select contact_id, name, email, contact_type_id '
        .'from contacts where contact_id='.$contact_id;
$smarty->assign('contact',$db->getRow($sql));

The variable assigned from the database above would be output with the template:

{html_radios name='contact_type_id' options=$contact_types
     selected=$contact.contact_type_id separator='<br />'}

See also {html_checkboxes} and {html_options}