Ns formvalueput - Revision history

Rcobb: Added man page link as in the template / conventions, though it's a dead link.

2008-02-21T19:19:14Z

Added man page link as in the template / conventions, though it's a dead link.

Rcobb: typo

2008-02-08T21:55:45Z

typo

Rcobb: OK, I think it's correct now :-)

2008-02-08T21:54:48Z

OK, I think it's correct now :-)

Rcobb: Added examples. Noted a bunch of bugs. Will annotate ns_tagelement too.

2008-02-08T21:44:31Z

Added examples. Noted a bunch of bugs. Will annotate ns_tagelement too.

Rcobb: Oops. Testing examples found problems. THere will be more edits.

2008-02-08T19:09:29Z

Oops. Testing examples found problems. THere will be more edits.

Rcobb: Fixed typo

2008-02-08T19:02:27Z

Fixed typo

Rcobb: Framed the page in, documented what I could. Needs examples.

2008-02-08T19:01:44Z

Framed the page in, documented what I could. Needs examples.

New page

Man page: '''not in source tree'''

----

'''NAME'''

: ns_formvalueput - Sets the value of input elements in HTML documents

'''SYNOPSIS'''

: '''ns_formvalueput''' ''htmlpiece'' ''dataname'' ''datavalue''

'''DESCRIPTION'''

: This command sets the value of an HTML input element with NAME=''dataname'' (of any type) to the given value. In the following descriptions, all attribute names are handled in case-insensitive fashion (as required by HTML)
: The elements (tags) & types supported are:
:* INPUT
::;image: ignored
::;submit: ignored
::;reset: ignored
::;checkbox: will be checked if the NAME attribute matches the ''datavalue'' (case-insensitive)
::;radio: will be selected if the NAME attribute matches the ''datavalue'' (case-insensitive)
::;''any other'':If the NAME attribute matches the ''dataname'', the VALUE attribute will be set to the ''datavalue''
:* TEXTAREA
::If the NAME attribute matches the ''dataname'', all the enclosed text up to the next <nowiki></textarea></nowiki> tag will be replaced by the ''datavalue''.
:* SELECT
::If the NAME attribute of the SELECT tag matches the ''dataname'', this will find the first enclosed OPTION tag with a VALUE attribute that matches ''datavalue'', and set its SELECTED attribute. All other enclosed OPTION tags will have their SELECTED attribute removed.

'''EXAMPLES'''
<pre><nowiki>

</nowiki></pre>
'''NOTES'''
* This procedure requires that [[Ns_tagelement]] ''not'' return the trailing ''>'' for elements. That feature of [[Ns_tagelement]] sometimes confuses people.

----

[[Category Documentation]] - [[Category Core Tcl API]]

← Older revision		Revision as of 19:19, 21 February 2008
Line 1:		Line 1:
−	Man page: ~~'''not in source tree'''~~	+	Man page: http://aolserver.com/docs/tcl/ns_formvalueput.html

	----		----

@@ Line 51: / Line 51: @@
 <pre><nowiki>
    % set hidden {<input type="hidden" name="foo">}
-   <input type="hidden" name="foo"/>
+   <input type="hidden" name="foo">
    % ns_formvalueput $hidden foo bar

@@ Line 27: / Line 27: @@
 '''EXAMPLES'''
 Check box "a" from the set a, b:
 <pre><nowiki>
-% set checks {<form>
+  % set checks {<form>
-<input type="checkbox" name="ex" value="a">a</input>
+  <input type="checkbox" name="ex" value="a">a</input>
-<input type="checkbox" name="ex" value="b">b</input>
+  <input type="checkbox" name="ex" value="b">b</input>
-</form>
+  </form>
-−
+  }
-<form>
+  <form>
-<input type="checkbox" name="ex" value="a">a</input>
+  <input type="checkbox" name="ex" value="a">a</input>
-<input type="checkbox" name="ex" value="b">b</input>
+  <input type="checkbox" name="ex" value="b">b</input>
-</form>
+  </form>
-% ns_formvalueput $checks ex a
+  % ns_formvalueput $checks ex a
-<form>
+  <form>
-<input type="checkbox" name="ex" value="a" CHECKED>a</input>
+  <input type="checkbox" name="ex" value="a" CHECKED>a</input>
-<input type="checkbox" name="ex" value="b">b</input>
+  <input type="checkbox" name="ex" value="b">b</input>
-</form>]
+  </form>
 </nowiki></pre>
 Set the value of hidden form field "foo" to "bar"
 <pre><nowiki>
-% set hidden {<input type="hidden" name="foo">}
+  % set hidden {<input type="hidden" name="foo">}
-<input type="hidden" name="foo"/>
+  <input type="hidden" name="foo"/>
-% ns_formvalueput $hidden foo bar
+  % ns_formvalueput $hidden foo bar
-<input type="hidden" name="foo" value="bar">
+  <input type="hidden" name="foo" value="bar">
 </nowiki></pre>
 Set the value of textarea "textarea" to "new value":
 <pre><nowiki>
-% set ta {<form>
+  % set ta {<form>
-<textarea name=textarea>Old value</textarea>
+  <textarea name=textarea>Old value</textarea>
-</form>}
+  </form>}
-<form>
+  <form>
-<textarea name=textarea>Old value</textarea>
+  <textarea name=textarea>Old value</textarea>
-</form>
+  </form>
-% ns_formvalueput $ta textarea {new value}
+  % ns_formvalueput $ta textarea {new value}
-<form>
+  <form>
-<textarea name=textarea>new value</textarea>
+  <textarea name=textarea>new value</textarea>
-</form>
+  </form>
 </nowiki></pre>
 '''NOTES'''
-In AOLServer 4.5.0 (and all previous versions):
+:In AOLServer 4.5.0 (and all previous versions):
-* Checkboxes are treated exactly like radio buttons. That is, all other boxes with the same name are unchecked.
+:* Checkboxes are treated exactly like radio buttons. That is, all other boxes with the same name are unchecked.
-* There is no mechanism for explicitly unchecking a checkbox.
+:* There is no mechanism for explicitly unchecking a checkbox.
-* In part because [[ns_tagelement]] does not strip single quotes from attribute values, the type, name, and value attribute values for each element must be either bare or enclosed by double quotes.
+:* In part because [[ns_tagelement]] does not strip single quotes from attribute values, the type, name, and value attribute values for each element must be either bare or enclosed by double quotes.
-* [[Ns_formvalueput]] cannot be used with or to create well-formed XHTML 1.0 documents:
+:* [[Ns_formvalueput]] cannot be used with well-formed XHTML 1.0 documents, nor will it create them:
-** The CHECKED and SELECTED attributes are minimized (i.e., have no value) and are always in upper case.
+:** The CHECKED and SELECTED attributes are minimized (i.e., have no value) and are always in upper case.
-** <nowiki><input></nowiki> elements encoded using the XML syntax <nowiki><input </nowiki>'''/>'''  will cause syntax errors in the output.
+:** <nowiki><input></nowiki> elements encoded using the XML syntax <nowiki><input </nowiki>'''/>''' will cause syntax errors in the output (the value attribute is inserted between the trailing '''/''' and the trailing '''>''').
 ----
 [[Category Documentation]] - [[Category Core Tcl API]]

@@ Line 19: / Line 19: @@
 ::;submit: ignored
 ::;reset: ignored
-::;checkbox: will be checked if the NAME attribute matches the ''datavalue'' (case-insensitive)
+::;checkbox: will be checked if the NAME attribute matches the ''dataname'' (case insensitive) and the VALUE attribute matches the ''datavalue'' (case-sensitive)
-::;radio: will be selected if the NAME attribute matches the ''datavalue'' (case-insensitive)
+::;radio: will be checked if the NAME attribute matches the ''dataname'' (case insensitive) and the VALUE attribute matches the ''datavalue'' (case-sensitive)
 :* TEXTAREA
 ::If the NAME attribute matches the ''dataname'', all the enclosed text up to the next <nowiki></textarea></nowiki> tag will be replaced by the ''datavalue''.

@@ Line 13: / Line 13: @@
 '''DESCRIPTION'''
-: This command sets the value of an HTML input element with NAME=''dataname'' (of any type) to the given value. In the following descriptions, all attribute names are handled in case-insensitive fashion (as required by HTML)
+: This command sets the value of an HTML input element with NAME=''dataname'' (of any type) to the given ''datavalue''. In the following descriptions, all attribute names are handled in case-insensitive fashion (as required by HTML)
 : The elements (tags) & types supported are:
 :* INPUT