Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 166 lines (153 sloc) 4.667 kb
a0f2502 @docelic A large commit with many enhancements:
docelic authored
1 __NAME__ purpose
2 create HTML or JavaScript form submit button
3 __END__
4
5
6 __NAME__ synopsis2
7 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
8 <entry><arg choice='plain'>name</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
9 <entry>Yes</entry><entry></entry>
10 <entry><literal>mv_click</literal></entry>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
11 <entry>Button name.</entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
12 </row>
13 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
14 <entry><arg choice='plain'>src</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
15 <entry>Yes</entry><entry></entry>
16 <entry></entry>
17 <entry>
18 Image file to use. If the value starts with <literal>http</literal>,
19 it is used <emphasis>as-is</emphasis>. Otherwise the tag makes sure the
6445a04 @docelic Large commit.
docelic authored
20 image file is reachable. Requires &glos-js;.
a0f2502 @docelic A large commit with many enhancements:
docelic authored
21 </entry>
22 </row>
23 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
24 <entry><arg choice='plain'>text</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
25 <entry>Yes</entry><entry></entry>
26 <entry></entry>
27 <entry>
6445a04 @docelic Large commit.
docelic authored
28 Button text. &glos-scratch; variable
087ca8c @docelic Not a large commit: just looks big.
docelic authored
29 of the same name is also created to
a0f2502 @docelic A large commit with many enhancements:
docelic authored
30 hold the code associated with the button.
31 </entry>
32 </row>
33 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
34 <entry><arg choice='plain'>wait-text</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
35 <entry></entry><entry></entry>
36 <entry></entry>
37 <entry>
38 Button text to show while the next page is being loaded.
087ca8c @docelic Not a large commit: just looks big.
docelic authored
39 If defined, this is used for the
6445a04 @docelic Large commit.
docelic authored
40 &glos-scratch; variable name instead of the
41 <arg choice='plain'>text</arg> argument value. Requires &glos-js;.
a0f2502 @docelic A large commit with many enhancements:
docelic authored
42 </entry>
43 </row>
44 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
45 <entry><arg choice='plain'>form</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
46 <entry></entry><entry></entry>
47 <entry>First form on the page (document.forms[0])</entry>
48 <entry>Form name that this button will submit.</entry>
49 </row>
50 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
51 <entry><arg choice='plain'>confirm</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
52 <entry></entry><entry></entry>
53 <entry></entry>
54 <entry>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
55 Text for the "Yes/No" confirmation window that will show up before
a0f2502 @docelic A large commit with many enhancements:
docelic authored
56 the client's browser starts with form submission.
6445a04 @docelic Large commit.
docelic authored
57 Requires &glos-js;.
087ca8c @docelic Not a large commit: just looks big.
docelic authored
58 </entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
59 </row>
60 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
61 <entry><arg choice='plain'>getsize</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
62 <entry></entry><entry></entry>
63 <entry>0</entry>
64 <entry>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
65 Use <classname>Image::Size</classname> Perl module to determine image size and
fdd48ed @docelic - Makefile: add filters to REFS
docelic authored
66 add <arg choice='plain'>width</arg> and <arg choice='plain'>height</arg>
14db9de @docelic - Wording fix only: s/parameter/attribute/ where appropriate
docelic authored
67 attributes to the image definition?
a0f2502 @docelic A large commit with many enhancements:
docelic authored
68 </entry>
69 </row>
70 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
71 <entry><arg choice='plain'>alt</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
72 <entry></entry><entry></entry>
fdd48ed @docelic - Makefile: add filters to REFS
docelic authored
73 <entry>Value of the <arg choice='plain'>text</arg> parameter.</entry>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
74 <entry>Alternate text for the browser status bar (window.status)
a341a44 @docelic - refs/*: Some news regarding (especially glossary) linking:
docelic authored
75 and <olink targetdoc='glossary' targetptr='balloon'>balloons</olink>.
087ca8c @docelic Not a large commit: just looks big.
docelic authored
76 </entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
77 </row>
78 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
79 <entry><arg choice='plain'>anchor</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
80 <entry></entry><entry></entry>
81 <entry>Value of <arg choice='plain'>text</arg></entry>
66d60e0 @docelic - Little improvements on Makefile and refs/*.
docelic authored
82 <entry>HTML &glos-anchor; name.
087ca8c @docelic Not a large commit: just looks big.
docelic authored
83 </entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
84 </row>
85 <row>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
86 <entry><arg choice='plain'>hidetext</arg></entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
87 <entry></entry><entry></entry>
88 <entry>0</entry>
087ca8c @docelic Not a large commit: just looks big.
docelic authored
89 <entry>Hide button text?</entry>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
90 </row>
a23b3b8 @docelic - docbook/literals.ent:
docelic authored
91 &ROW_EXTRA_none;
92 &ROW_HTML_std;
93 &ROW_CSS_std;
6ec10b8 @docelic * fix interpolate/reparse attributes for about the first
docelic authored
94 &TAG_CONTAINER;
a0f2502 @docelic A large commit with many enhancements:
docelic authored
95 __END__
96
97
98 __NAME__ see also
99 env
100 __END__
101
102
8aa4197 @docelic Little fixes, some more docs, nice series altogether.
docelic authored
103 __NAME__ notes
104 The &tag-button; tag can work with unnamed forms.
105 __END__
106
107
a0f2502 @docelic A large commit with many enhancements:
docelic authored
108 __NAME__ description
a23b3b8 @docelic - docbook/literals.ent:
docelic authored
109 This tag creates a <mv>mv_click</mv> HTML form submit button.
a0f2502 @docelic A large commit with many enhancements:
docelic authored
110 </para><para>
111 Standard, text-only submit button is output in the form of
112 <![CDATA[<input type='submit' ...>]]>.
113 </para><para>
6445a04 @docelic Large commit.
docelic authored
114 &glos-js; submit button can contain an image in place of the standard
a0f2502 @docelic A large commit with many enhancements:
docelic authored
115 button text and is output as a combination of
116 <![CDATA[<a href=...>]]> and
117 <![CDATA[<img src=...>]]> HTML tags.
118 It can also produce other enhancements to the plain submit button, such
119 as confirmation popup windows.
120 </para><para>
121 See <xref linkend='button_examples'/> for illustrative presentation.
122 __END__
123
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
124 __NAME__ example: Submit button with an image and confirmation window
125 Notice the tags used in the button body:
126 <programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
127 [button text="Delete item" confirm="Are you sure?" src="delete.gif"]
128 [comment]
129 [button] element's body specifies the action code. It is what you would
130 put inside [set Delete item][/set] if you were creating the button
131 manually.
132 [/comment]
133 [mvtag] Use any Interchange tag here, i.e. ....[/mvtag]
134 [perl] # code to delete item [/perl]
135 [/button]
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
136 </programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
137 __END__
138
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
139 __NAME__ example-inp: Creating the submit button manually
140 We are here to discuss the usage of the <tag>button</tag> tag, but let's
141 take a look at an
142 example equivalent to the one above, except that we create the button
143 manually:
144 <programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
145 [set Delete item]
146 [comment]
147 [button] element's body specifies the action code.
148 [/comment]
149 [mvtag] Use any Interchange tag here, i.e. ....[/mvtag]
150 [perl] # code to delete item [/perl]
151 [/set]
152 <![CDATA[
153 <input type='submit' name='mv_click' value='Delete item'>
154 ]]>
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
155 </programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
156 __END__
157
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
158 __NAME__ example-js: Simple button with an embedded custom JavaScript code
159 <programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
160 [button text="Click me"]
161 [javascript]onClick="myOwnOnClickFunction(this);"[/javascript]
162 [/button]
a23806c @docelic Fix the rest of items to adhere to new syntax in Example sections
docelic authored
163 </programlisting>
a0f2502 @docelic A large commit with many enhancements:
docelic authored
164 __END__
165
Something went wrong with that request. Please try again.