argra****@users*****
argra****@users*****
2011年 7月 6日 (水) 03:51:28 JST
Index: docs/modules/libwww-perl-5.813/HTML/Form.pod diff -u docs/modules/libwww-perl-5.813/HTML/Form.pod:1.3 docs/modules/libwww-perl-5.813/HTML/Form.pod:1.4 --- docs/modules/libwww-perl-5.813/HTML/Form.pod:1.3 Mon Mar 21 04:05:04 2011 +++ docs/modules/libwww-perl-5.813/HTML/Form.pod Wed Jul 6 03:51:28 2011 @@ -38,10 +38,8 @@ C<E<lt>formE<gt> ... E<lt>/formE<gt>> 実体を表現します。 一つのフォームは、普通は名前の付いている、様々な値を取ることができる いくつかの入力で構成されます。 -フォームの状態は can be tweaked and it can then be -asked to provide C<HTTP::Request> objects that can be passed to the -request() method of C<LWP::UserAgent>. -(TBT) +フォームの状態は修正でき、それから C<LWP::UserAgent> の request() メソッドに +渡せる C<HTTP::Request> オブジェクトを取得できます。 =begin original @@ -68,11 +66,10 @@ =end original -parse() クラスメソッドは will parse an HTML document and build up -C<HTML::Form> objects for each <form> element found. +parse() クラスメソッドは HTML 文書をパースして、<form> 要素が見つかる毎に +C<HTML::Form> オブジェクトを構築します。 スカラコンテキストで呼び出すと、最初の <form> だけが返されます。 フォームが見つからなかった場合は空リストが返されます。 -(TBT) =begin original @@ -371,11 +368,9 @@ =end original -If called with a single argument then it returns the value or values -of inputs with the given name. If called in scalar context only the -first value is returned. If no input exists with the given name, then -C<undef> is returned. -(TBT) +引数一つで呼び出されると、与えられた名前の入力の値を返します。 +スカラコンテキストで呼び出されると、最初の値のみが返されます。 +与えられた名前の入力がない場合は、C<undef> が返されます。 =begin original @@ -387,12 +382,11 @@ =end original -If called with 2 or more arguments then it will set values of the -named inputs. This form will croak if no inputs have the given name -or if any of the values provided does not fit. Values can also be -provided as a reference to an array. This form will allow unsetting -all values with the given name as well. -(TBT) +2 以上の引数で呼び出されると、名前のある入力の値を設定します。 +この形式は、もし与えられた名前がなかったり、提供された値が適合しない場合は +croak します。 +値は配列へのリファレンスででも提供できます。 +この形式は与えられた名前の全ての値をクリアすることも出来ます。 =begin original @@ -401,9 +395,7 @@ =end original -This interface resembles that of the param() function of the CGI -module. -(TBT) +このインターフェースは CGI モジュールの param() 関数と似ています。 =item $form->try_others( \&callback ) @@ -417,12 +409,11 @@ =end original -This method will iterate over all permutations of unvisited enumerated -values (<select>, <radio>, <checkbox>) and invoke the callback for -each. The callback is passed the $form as argument. The return value -from the callback is ignored and the try_others() method itself does -not return anything. -(TBT) +このメソッドはまだ訪れていない列挙値 (<select>, <radio>, <checkbox>) の +順列に対して反復し、それぞれに対して callback を起動します。 +callback は引数として $form が渡されます。 +callback からの返り値は無視され、try_others() メソッド自身は何も +返しません。 =item $request = $form->make_request @@ -433,9 +424,8 @@ =end original -Will return an C<HTTP::Request> object that reflects the current setting -of the form. You might want to use the click() method instead. -(TBT) +フォームの現在の設定を反映した C<HTTP::Request> を返します。 +代わりに click() メソッドを使いたいかも知れません。 =item $request = $form->click @@ -454,11 +444,10 @@ =end original -Will "click" on the first clickable input (which will be of type -C<submit> or C<image>). The result of clicking is an C<HTTP::Request> -object that can then be passed to C<LWP::UserAgent> if you want to -obtain the server response. -(TBT) +クリックできる入力 (型が C<submit> または C<image> のもの) を +「クリック」します。 +クリックの結果は、もしサーバレスポンスがほしい場合は後で C<LWP::UserAgent> に +渡せる C<HTTP::Request> オブジェクトです。 =begin original @@ -471,13 +460,13 @@ =end original -If a $name is specified, we will click on the first clickable input -with the given name, and the method will croak if no clickable input -with the given name is found. If $name is I<not> specified, then it -is ok if the form contains no clickable inputs. In this case the -click() method returns the same request as the make_request() method -would do. -(TBT) +$name が指定されると、与えられた名前を持つ最初のクリック可能な入力が +クリックされ、もし与えられた名前のクリック可能な入力が見付からなかった場合は +croak します。 +$name が指定 I<されない> 場合は、フォームにクリック可能な入力がなくても +問題ありません。 +この場合、click() メソッドは make_request() メソッドと同じリクエストを +返します。 =begin original @@ -489,12 +478,11 @@ =end original -If there are multiple clickable inputs with the same name, then there -is no way to get the click() method of the C<HTML::Form> to click on -any but the first. If you need this you would have to locate the -input with find_input() and invoke the click() method on the given -input yourself. -(TBT) +同じ名前で複数のクリック可能な入力がある場合、最初のもの以外が +クリックされたことを C<HTML::Form> の click() メソッドで知る方法は +ありません。 +これが必要なら、find_input() で入力の位置を探して、得られた入力自身に +対して click() メソッドを起動する必要があります。 =begin original @@ -506,12 +494,12 @@ =end original -A click coordinate pair can also be provided, but this only makes a -difference if you clicked on an image. The default coordinate is -(1,1). The upper-left corner of the image is (0,0), but some badly -coded CGI scripts are known to not recognize this. Therefore (1,1) was -selected as a safer default. -(TBT) +クリック座標の組も提供されますが、画像をクリックされたときにのみ +違いがあります。 +デフォルトの座標は (1,1) です。 +画像の左上の隅は (0,0) ですが、間違ってコーディングされた CGI スクリプトには +これを認識しないことが知られています。 +従って (1,1) はより安全なデフォルトとして選択されました。 =item @kw = $form->form @@ -606,12 +594,11 @@ オブジェクトに提供されます。 radio 入力オブジェクトの数は E<lt>input type="radio"E<gt> 要素で使われている 異なる名前の数と同じです。 -For a E<lt>selectE<gt> element -without the C<multiple> attribute there will be one input object of -type of "option". For a E<lt>select multipleE<gt> element there will -be one input object for each contained E<lt>optionE<gt> element. Each -one of these option objects will have the same name. -(TBT) +C<multiple> 属性のない E<lt>selectE<gt> 要素の場合、"option" 型の +一つの入力オブジェクトです。 +E<lt>select multipleE<gt> 要素の場合、それぞれに E<lt>optionE<gt> 要素を +含んだ一つの入力オブジェクトです。 +これらの option オブジェクトのそれぞれは同じ名前を持ちます。 =begin original @@ -789,10 +776,8 @@ 一部の入力はオン/オフできるトグルを表現しています。 これは "checkbox" と "option" を含みます。 -Calling this method turns -this input on without having to know the value name. +このメソッドを呼び出すと、この入力の現在の値を知らなくてもオンになります。 入力が既にオンなら、何も起きません。 -(TBT) =begin original
