t:SWITCH Element | switch Object

HTML (DHTML)

t:SWITCH Element | switch Object

Enables you to provide several choices and display content depending on which choice is true on the user's computer.

Members Table

The following table lists the members exposed by the switch object. Click a tab on the left to choose the type of member you want to view.
Attributes/Properties
Attribute Property Description
hasMedia Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.
systemBitrate Retrieves the approximate bandwidth available to the system in bits-per-second.
systemCaptions Indicates whether or not to display a text equivalent of the audio portion of the presentation.
systemLanguage Indicates whether a given language is selected in a user's system preferences.
systemOverdubOrSubtitle Specifies whether overdubs or subtitles render during a presentation.

Attribute	Property	Description
	hasMedia	Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.
systemBitrate		Retrieves the approximate bandwidth available to the system in bits-per-second.
systemCaptions		Indicates whether or not to display a text equivalent of the audio portion of the presentation.
systemLanguage		Indicates whether a given language is selected in a user's system preferences.
systemOverdubOrSubtitle		Specifies whether overdubs or subtitles render during a presentation.

Remarks

Use the t:SWITCH element to decide which content to display based on the value of test attributes such as systemCaptions, systemBitrate, systemOverdubOrSubtitle, and systemLanguage.
This example detects the system language setting from the Regional Options in Control Panel and displays a text fragment in Spanish, Portuguese, or English, depending on the system language setting.
<t:switch>
<span class="time" systemLanguage="es" >Somos interdependientes (Espanol)</span>
<span class="time" systemLanguage="pt" >Nos somos interdependentes (Portuguese)</span>
<span class="time" systemLanguage="en" >We are interdependent (English)</span>
<span class="time">None of the above</span>
</t:switch>
Although different media-based elements exist, there is no functional difference in their current implementation. However, you are encouraged to use elements such as t:ANIMATION, t:AUDIO, t:IMG, t:MEDIA, t:REF, and t:VIDEO for improved document readability and enhanced support.
The prefix t: is used to associate this element with an Extensible Markup Language (XML) namespace. You must declare the XML namespace in the html tag of your document when using this element.
<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
You must then import the tag definitions from the time2 behavior by using the IMPORT processing instructions.
<?IMPORT namespace="t" implementation="#default#time2">
Within a switch block, all tags (including tags such as HR and BR) resolve true if they don't have valid test attributes. This has a couple of implications.
The switch element is not effective as a time container for multiple elements because it stops rendering children after the first child resolves true. For this reason, the timeContainer attribute is ignored by the switch element.
HTML comment tags always resolve true. To incorporate HTML comment tags in switch blocks, you must wrap them in another container, such as a DIV or t:PAR. The following code fragment demonstrates how to do this.
<t:switch>
<div systemLanguage="en" >

...
</div>
<t:par>

</t:par>
</t:switch>
This element is not rendered.
This element requires a closing tag.