CONTENIDO_API 4.8.16 CL
Back to top  

Toggle button (on/off) with two different links

author Timo A. Hummel

 Methods

Constructor Function Initializes the SGML open/close tags

__construct() : void
Inherited

inherited_from \cHTML::__construct()
inherited_from \cHTMLSpan::__construct()
inherited_from \cWidgetButton::__construct()

_setContent: Sets the content of the object

_setContent(\$content $content) 
Inherited

inherited_from \cHTML::_setContent()
inherited_from \cHTMLSpan::_setContent()
inherited_from \cWidgetButton::_setContent()

Parameters

$content

\$content

string/object String with the content or an object to render.

addRequiredScript() 

addRequiredScript($script) 
Inherited

inherited_from \cHTML::addRequiredScript()
inherited_from \cHTMLSpan::addRequiredScript()
inherited_from \cWidgetButton::addRequiredScript()

Parameters

$script

advances to the next ID available in the system.

advanceID() 
Inherited

This function is useful if you need to use HTML elements in a loop, but don't want to re-create new objects each time.

inherited_from \cHTML::advanceID()
inherited_from \cHTMLSpan::advanceID()
inherited_from \cWidgetButton::advanceID()

attachEventDefinition: Attaches the code for an event

attachEventDefinition(\$sName $sName, \$sEvent $sEvent, \$sCode $sCode) 
Inherited

Example to attach an onClick handler: setEventDefinition("foo", "onClick", "alert('foo');");

inherited_from \cHTML::attachEventDefinition()
inherited_from \cHTMLSpan::attachEventDefinition()
inherited_from \cWidgetButton::attachEventDefinition()

Parameters

$sName

\$sName

string defines the name of the event

$sEvent

\$sEvent

string defines the event (e.g. onClick)

$sCode

\$sCode

string defines the code

attachStyleDefinition: Attaches a style definition.

attachStyleDefinition(\$sName $sName, \$sDefinition $sDefinition) : string
Inherited

This function is not restricted to a single style, e.g. you can set multiple style definitions as-is to the handler.

$example->attachStyle("myIdentifier", "border: 1px solid black; white-space: nowrap"); $example->attachStyle("myIdentifier2", "padding: 0px");

Results in:

style="border: 1px solid black; white-space: nowrap; padding: 0px;"

inherited_from \cHTML::attachStyleDefinition()
inherited_from \cHTMLSpan::attachStyleDefinition()
inherited_from \cWidgetButton::attachStyleDefinition()

Parameters

$sName

\$sName

string Name for a style definition

$sDefinition

\$sDefinition

string Definition for the given entity

Returns

stringfilled SGML closing skeleton

old Constructor

cHTML() 
Inherited

inherited_from \cHTML::cHTML()
inherited_from \cHTMLSpan::cHTML()
inherited_from \cWidgetButton::cHTML()

Constructor. Creates an HTML Span element.

cHTMLSpan(\$content $content) 
Inherited

inherited_from \cHTMLSpan::cHTMLSpan()
inherited_from \cWidgetButton::cHTMLSpan()

Parameters

$content

\$content

mixed String or object with the contents

Constructor Function

cWidgetButton(\$img $img, \$alt $alt, \$link $link) 
Inherited

inherited_from \cWidgetButton::cWidgetButton()

Parameters

$img

\$img

string Image location

$alt

\$alt

string Alternative text

$link

\$link

string Link

Constructor Function

cWidgetToggleButton(\$img $img, \$alt $alt, \$uplink $uplink, \$downlink $downlink) 

Parameters

$img

\$img

string Image location

$alt

\$alt

string Alternative text

$uplink

\$uplink

string Link when the button is turned off (=up)

$downlink

\$downlink

string Link when the button is turned on (=down)

fillCloseSkeleton: Fills the close skeleton

fillCloseSkeleton() : string
Inherited

inherited_from \cHTML::fillCloseSkeleton()
inherited_from \cHTMLSpan::fillCloseSkeleton()
inherited_from \cWidgetButton::fillCloseSkeleton()

Returns

stringfilled SGML closer skeleton

fillSkeleton: Fills the open SGML tag skeleton

fillSkeleton(\$attributes $attributes) : string
Inherited

fillSkeleton fills the SGML opener tag with the specified attributes. Attributes need to be passed in the stringyfied variant.

inherited_from \cHTML::fillSkeleton()
inherited_from \cHTMLSpan::fillSkeleton()
inherited_from \cWidgetButton::fillSkeleton()

Parameters

$attributes

\$attributes

string Attributes to set

Returns

stringfilled SGML opener skeleton

getID: returns the current ID

getID() : string
Inherited

inherited_from \cHTML::getID()
inherited_from \cHTMLSpan::getID()
inherited_from \cWidgetButton::getID()

Returns

stringcurrent ID

Render method

render() : string

Returns

stringRendered HTML

setAlt: sets the alt and title attributes

setAlt(\$alt $alt) 
Inherited

Sets the "alt" and "title" tags. Usually, "alt" is used for accessibility and "title" for mouse overs.

To set the text for all browsers for mouse over, set "alt" and "title". IE behaves incorrectly and shows "alt" on mouse over. Mozilla browsers only show "title" as mouse over.

inherited_from \cHTML::setAlt()
inherited_from \cHTMLSpan::setAlt()
inherited_from \cWidgetButton::setAlt()

Parameters

$alt

\$alt

string Text to set as the "alt" attribute

setAttribte: Sets a specific attribute

setAttribute(\$sAttributeName $sAttributeName, \$sValue $sValue) 
Inherited

inherited_from \cHTML::setAttribute()
inherited_from \cHTMLSpan::setAttribute()
inherited_from \cWidgetButton::setAttribute()

Parameters

$sAttributeName

\$sAttributeName

string Name of the attribute

$sValue

\$sValue

string Value of the attribute

sets the border width

setBorder(\$border $border) 
Inherited

inherited_from \cWidgetButton::setBorder()

Parameters

$border

\$border

integer border size

sets the CSS class

setClass(\$class $class) 
Inherited

inherited_from \cHTML::setClass()
inherited_from \cHTMLSpan::setClass()
inherited_from \cWidgetButton::setClass()

Parameters

$class

\$class

string Text to set as the "alt" attribute

setContent: Sets the div's content

setContent(\$content $content) 
Inherited

inherited_from \cHTMLSpan::setContent()
inherited_from \cWidgetButton::setContent()

Parameters

$content

\$content

string/object String with the content or an object to render.

setContentlessTag() 

setContentlessTag(\type $contentlessTag) 
Inherited

inherited_from \cHTML::setContentlessTag()
inherited_from \cHTMLSpan::setContentlessTag()
inherited_from \cWidgetButton::setContentlessTag()

Parameters

$contentlessTag

\type

adds an "onXXX" javascript event handler

setEvent(\$event $event, \$action $action) 
Inherited

example: $item->setEvent("change","document.forms[0].submit");

inherited_from \cHTML::setEvent()
inherited_from \cHTMLSpan::setEvent()
inherited_from \cWidgetButton::setEvent()

Parameters

$event

\$event

string Type of the event

$action

\$action

string Function or action to call (JavaScript Code)

Sets wether the button should be hovered

setHover(\$hover $hover) 
Inherited

inherited_from \cWidgetButton::setHover()

Parameters

$hover

\$hover

boolean True if hovering should be used

sets the ID class

setID(\$class $id) 
Inherited

inherited_from \cHTML::setID()
inherited_from \cHTMLSpan::setID()
inherited_from \cWidgetButton::setID()

Parameters

$id

\$class

string Text to set as the "id"

Sets wether the button should be indented when clicking

setIndent(\$indent $indent) 
Inherited

inherited_from \cWidgetButton::setIndent()

Parameters

$indent

\$indent

boolean True if indenting should be used

sets the CSS style

setStyle(\$class $style) 
Inherited

inherited_from \cHTML::setStyle()
inherited_from \cHTMLSpan::setStyle()
inherited_from \cWidgetButton::setStyle()

Parameters

$style

\$class

string Text to set as the "alt" attribute

addStyleDefinition

setStyleDefinition(\$entity $entity, \$definition $definition) : string
Inherited

inherited_from \cHTML::setStyleDefinition()
inherited_from \cHTMLSpan::setStyleDefinition()
inherited_from \cWidgetButton::setStyleDefinition()

Parameters

$entity

\$entity

string Entity to define

$definition

\$definition

string Definition for the given entity

Returns

stringfilled SGML closing skeleton

Renders the SPAN element

toHTML() : string
Inherited

inherited_from \cHTMLSpan::toHTML()
inherited_from \cWidgetButton::toHTML()

Returns

stringRendered HTML

removes an event handler

unsetEvent(\$event $event) 
Inherited

example: $item->unsetEvent("change");

inherited_from \cHTML::unsetEvent()
inherited_from \cHTMLSpan::unsetEvent()
inherited_from \cWidgetButton::unsetEvent()

Parameters

$event

\$event

string Type of the event

 Properties

 

Defines which JS events contain which scripts

$_aEventDefinitions 
Inherited

inherited_from \cHTML::$$_aEventDefinitions
inherited_from \cHTMLSpan::$$_aEventDefinitions
inherited_from \cWidgetButton::$$_aEventDefinitions
 

Style definitions

$_aStyleDefinitions 
Inherited

inherited_from \cHTML::$$_aStyleDefinitions
inherited_from \cHTMLSpan::$$_aStyleDefinitions
inherited_from \cWidgetButton::$$_aStyleDefinitions
 

The content itself

$_content 
Inherited

inherited_from \cHTML::$$_content
inherited_from \cHTMLSpan::$$_content
inherited_from \cWidgetButton::$$_content
 

Defines if the current tag is a contentless tag

$_contentlessTag : boolean
Inherited

access private
inherited_from \cHTML::$$_contentlessTag
inherited_from \cHTMLSpan::$$_contentlessTag
inherited_from \cWidgetButton::$$_contentlessTag
 

Storage of the image object

$_img : object
Inherited

access private
inherited_from \cWidgetButton::$$_img
 

Storage of the link object

$_link : object
Inherited

access private
inherited_from \cWidgetButton::$$_link
 

Defines all scripts which are required by the current element

$_requiredScripts : array
Inherited

access private
inherited_from \cHTML::$$_requiredScripts
inherited_from \cHTMLSpan::$$_requiredScripts
inherited_from \cWidgetButton::$$_requiredScripts
 

Storage of the close SGML tag

$_skeleton_close : string
Inherited

access private
inherited_from \cHTML::$$_skeleton_close
inherited_from \cHTMLSpan::$$_skeleton_close
inherited_from \cWidgetButton::$$_skeleton_close
 

Storage of the open SGML tag template

$_skeleton_open : string
Inherited

access private
inherited_from \cHTML::$$_skeleton_open
inherited_from \cHTMLSpan::$$_skeleton_open
inherited_from \cWidgetButton::$$_skeleton_open
 

Storage of a single SGML tag template

$_skeleton_single : string
Inherited

access private
inherited_from \cHTML::$$_skeleton_single
inherited_from \cHTMLSpan::$$_skeleton_single
inherited_from \cWidgetButton::$$_skeleton_single
 

Defines the style definitions

$_styledefs : string
Inherited

access private
inherited_from \cHTML::$$_styledefs
inherited_from \cHTMLSpan::$$_styledefs
inherited_from \cWidgetButton::$$_styledefs
 

Defines which tag to use

$_tag : string
Inherited

access private
inherited_from \cHTML::$$_tag
inherited_from \cHTMLSpan::$$_tag
inherited_from \cWidgetButton::$$_tag