Detailed Usage Instructions for Functions in "clc_id_subfunc_2.js"

All functions in this file are of the form CLC_<Element>_Info2(DOM-Obj_Element). It is the responsiblity of whoever is using these functions to ensure that only the CORRECT DOM-Obj_Element is fed into these functions. There is no checking! These are very similar to the clc_id_subfunc_1.js functions except these provide secondary content (used for info query responses).

An example of using this would be taking a DOM-Obj with a tagName of "A" and an href value of "mailto:clc4tts@HotPop.com" and feeding this DOM-Obj into CLC_A_Info2 by using the following code (assuming that the DOM-Obj is called TARGETOBJ):

var link_info_string = CLC_A_Info2(TARGETOBJ);
alert(link_info_string);

The expected result would be that you get an alert box popup which says: "This is an E-mail link that points to clc4tts@HotPop.com"

CLC_<Element>_Info2 Functions
Function Name Message String in English Additional Notes
CLC_A_Info2 "Title: TITLE" or nothing followed by: "This is an E-mail link that points to EMAIL_ADDRESS" or
"The destination of this external link is HTTP_URL" or
"This is an internal link to section SECTION" or
"This link points to DEST" or
NULL_STRING
Much like the Info1 version, this will pick out the correct type of link that it is and respond appropriately. Before providing the URL, it will read out the TITLE if it exists. This is actually just a shell function that calls CLC_Link_Info2 and is only provided to allow for naming convention consistency.
CLC_Abbr_Info2 "Is an abbreviation" or
"Is an abbreviation which stands for TITLE"
"Is an abbreviation" is used when there is no title attribute. If there is a title attribute, the HTML standard is that the title is what the abbreviation stands for, so "Is an abbreviation which stands for TITLE" will be returned.
CLC_Acronym_Info2 "Is an acronym" or
"Is an acronym which stands for TITLE"
"Is an acronym" is used when there is no title attribute. If there is a title attribute, the HTML standard is that the title is what the acronym stands for, so "Is an acronym which stands for TITLE" will be returned.
CLC_Blockquote_Info2 "Block Quote" Uses the Info1 version of the function.
CLC_Body_Info2 "Body with X headings and Y links." Uses the Info1 version of the function.
CLC_Button_Info2 "Button" Uses the Info1 version of the function.
CLC_Caption_Info2 "Caption" Uses the Info1 version of the function.
CLC_Fieldset_Info2 "Fieldset Legend: X." or
"Fieldset has no legend."
Uses the Info1 version of the function.
CLC_Frame_Info1 "FRAME_TITLE FRAME_NAME CONTENT_TITLE"
"Untitled frame. Frame source: CONTENT_URL"
Uses the Info1 version of the function.
CLC_H1_Info2 "Heading level 1." Uses the Info1 version of the function.
CLC_H2_Info2 "Heading level 2." Uses the Info1 version of the function.
CLC_H3_Info2 "Heading level 3." Uses the Info1 version of the function.
CLC_H4_Info2 "Heading level 4." Uses the Info1 version of the function.
CLC_H5_Info2 "Heading level 5." Uses the Info1 version of the function.
CLC_H6_Info2 "Heading level 6." Uses the Info1 version of the function.
CLC_Html_Info2 "H T M L title. TITLE" or
"Untitled H T M L."
Uses the Info1 version of the function.
CLC_Img_Info2 "Graphic Title TITLE" or
"Graphic" or
NULL_STRING
Uses the TITLE attribute of the image if it exists.
CLC_Input_Info2 "Radio button STATUSINFO" or
"Text blank STATUSINFO" or
"Password blank STATUSINFO" or
"Submit button STATUSINFO" or
"Check box STATUSINFO" or
"Reset button STATUSINFO"
Uses the Info1 version of the function and also retrieves the status information of the object by using CLC_GetStatus.
CLC_Label_Info2 "Label X" X is the textContent of the label. It needs to be read in an announcement since labels are considered non-atomic (they have logical children - the inputs that they are a label for).
CLC_Legend_Info2 NULL_STRING There is no need to give any information for Legend elements since they can't even be part of the logical lineage. Their content will be read when their Fieldset element is read.
CLC_Li_Info2 "This is number X in an ordered list." or
"This is number X in an unnumbered list." or
"This is a bullet item."
Identifies the LI element's position in a list and identifies the type of list. If it is not in any list, then "This is a bullet item." is returned.
CLC_Link_Info2 "Title: TITLE" or nothing followed by: "This is an E-mail link that points to EMAIL_ADDRESS" or
"The destination of this external link is HTTP_URL" or
"This is an internal link to section SECTION" or
"This link points to DEST" or
NULL_STRING
Much like the Info1 version, this will pick out the correct type of link that it is and respond appropriately. Before providing the URL, it will read out the TITLE if it exists.
CLC_Ol_Info2 "Ordered list TITLE with X items" Uses the Info1 version of the function.
CLC_Select_Info2 "Select" Uses the Info1 version of the function.
CLC_Table_Info2 "Summary: SUMMARY. Table with X columns and Y rows" or
"Table with X columns and Y rows"
Uses the Info1 version of the function.
CLC_Textarea_Info2 "Text area" Uses the Info1 version of the function.
CLC_Th_Info1 "Column header" or
"COLUMN_INFO Row header"
Uses the Info1 version of the function.
CLC_Td_Info2 "This is a cell that is probably in a layout table. LOCATION_INFO" or
"Column heading is (guessed heading) COLHEADING. Row heading is (guessed heading) ROWHEADING. LOCATION_INFO"
Whether it says (guessed heading) or not depends on if TH is explicitly used. If it is, then it does not say guessed; else if it guesses that it is data, it will guess the most logical cell and state that it is a "guessed heading." LOCATION_INFO is provided for both layout and data tables, and it is "This cell is in column X, row Y."
CLC_Ul_Info2 "Unnumbered list TITLE with X items" Uses the Info1 version of the function.