cvs: peardoc /ja/package/html/html-table faq.xml /ja/package/php/php-codesniffer advanced-usage.xml config-options.xml usage.xml /ja/package/structures structures-datagrid.xml /ja/package/structures/structures-datagrid/structures-datagrid seturlformat.xml /ja/package/structures/structures-datagrid/structures-datagrid-column setformatter.xml /ja/package/validate validate.xml
[email protected] ("TAKAGI Masahiro")
| Newsgroups | php.pear.doc |
|---|---|
| Message-ID | <cvstakagi1194648213@cvsserver> |
takagi Fri Nov 9 22:43:33 2007 UTC
Added files:
/peardoc/ja/package/structures/structures-datagrid/structures-datagrid
seturlformat.xml
Modified files:
/peardoc/ja/package/validate validate.xml
/peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column
setformatter.xml
/peardoc/ja/package/structures structures-datagrid.xml
/peardoc/ja/package/php/php-codesniffer usage.xml
config-options.xml
advanced-usage.xml
/peardoc/ja/package/html/html-table faq.xml
Log:
sync with en.
takagi-20071109224333.txt
(text/plain, 26.5 KB)
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/validate/validate.xml?r1=1.2&r2=1.3&diff_format=u
Index: peardoc/ja/package/validate/validate.xml
diff -u peardoc/ja/package/validate/validate.xml:1.2 peardoc/ja/package/validate/validate.xml:1.3
--- peardoc/ja/package/validate/validate.xml:1.2 Sat Jun 16 14:10:21 2007
+++ peardoc/ja/package/validate/validate.xml Fri Nov 9 22:43:32 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready -->
<sect1 id="package.validate.validate">
<title>Validate (本体パッケージ)</title>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml?r1=1.7&r2=1.8&diff_format=u
Index: peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml
diff -u peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml:1.7 peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml:1.8
--- peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml:1.7 Fri Jul 27 03:18:47 2007
+++ peardoc/ja/package/structures/structures-datagrid/structures-datagrid-column/setformatter.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.15 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.16 Maintainer: takagi Status: ready -->
<refentry id="package.structures.structures-datagrid.structures-datagrid-column.setformatter">
<refnamediv>
<refname>
@@ -34,6 +34,24 @@
<para>
このカラムに適用する書式設定用のコールバックを、引数とともに定義します。
</para>
+ <para>
+ コールバック関数の最初の引数には、次のような配列が渡されます。
+ <programlisting role="php">
+<![CDATA[ array(
+ 'record' => このレコードの全フィールドの値を含む連想配列,
+ 'fieldName' => このカラムのフィールド名,
+ 'columnName' => このカラムのラベル (ヘッダ),
+ 'orderBy' => このカラムをソートするフィールド名,
+ 'attribs' => このカラムの属性,
+ 'currRow' => ゼロから始まる行インデックス,
+ 'currCol' => ゼロから始まるカラムインデックス,
+ );]]>
+ </programlisting>
+ </para>
+ <para>
+ オプションのパラメータ $arguments を setFormatter() に渡すと、
+ コールバック関数の 2 番目の引数としてそれが渡されます。
+ </para>
</refsect1>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid-column.setformatter.param">
&title.param;
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/structures/structures-datagrid.xml?r1=1.8&r2=1.9&diff_format=u
Index: peardoc/ja/package/structures/structures-datagrid.xml
diff -u peardoc/ja/package/structures/structures-datagrid.xml:1.8 peardoc/ja/package/structures/structures-datagrid.xml:1.9
--- peardoc/ja/package/structures/structures-datagrid.xml:1.8 Fri Jul 27 03:18:47 2007
+++ peardoc/ja/package/structures/structures-datagrid.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.44 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.45 Maintainer: takagi Status: ready -->
<sect1 id="package.structures.structures-datagrid">
<title>Structures_DataGrid</title>
<!--
@@ -83,6 +83,7 @@
&package.structures.structures-datagrid.structures-datagrid.setrendereroption;
&package.structures.structures-datagrid.structures-datagrid.setrendereroptions;
&package.structures.structures-datagrid.structures-datagrid.setrequestprefix;
+&package.structures.structures-datagrid.structures-datagrid.seturlformat;
&package.structures.structures-datagrid.structures-datagrid.sortrecordset;
</sect2>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/php/php-codesniffer/usage.xml?r1=1.7&r2=1.8&diff_format=u
Index: peardoc/ja/package/php/php-codesniffer/usage.xml
diff -u peardoc/ja/package/php/php-codesniffer/usage.xml:1.7 peardoc/ja/package/php/php-codesniffer/usage.xml:1.8
--- peardoc/ja/package/php/php-codesniffer/usage.xml:1.7 Sat Sep 22 02:24:20 2007
+++ peardoc/ja/package/php/php-codesniffer/usage.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.7 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.9 Maintainer: takagi Status: ready -->
<refentry id="package.php.php-codesniffer.usage">
<refnamediv>
<refname>使用法</refname>
@@ -18,11 +18,12 @@
<para>
<screen>
<![CDATA[
-Usage: phpcs [-nlvi] [--report=<report>] [--standard=<standard>]
- [--config-set key value] [--config-show]
+Usage: phpcs [-nwlvi] [--report=<report>] [--standard=<standard>]
+ [--config-set key value] [--config-delete key] [--config-show]
[--generator=<generator>] [--extensions=<extensions>]
[--ignore=<patterns>] <file> ...
-n Do not print warnings
+ -w Print both warnings and errors (on by default)
-l Local directory only, no recursion
-v[v][v] Print verbose output
-i Show a list of installed coding standards
@@ -34,9 +35,12 @@
<patterns> A comma separated list of patterns that are used
to ignore directories and files
<standard> The name of the coding standard to use
- <generator> The name of a doc genertor to use
+ <generator> The name of a doc generator to use
(forces doc generation instead of checking)
- <report> Print either the "full", "xml" or "summary" report
+ <report> Print either the "full", "xml", "checkstyle",
+ "csv" or "summary" report
+ (the "full" report is printed by default)
+
]]>
</screen>
</para>
@@ -54,7 +58,7 @@
</refsect1>
- <refsect1>
+ <refsect1 id="package.php.php-codesniffer.usage.checking-files-folders">
<title>ファイルおよびフォルダのチェック</title>
<para>
PHP_CodeSniffer のもっともシンプルな使用法は、PHP_CodeSniffer
@@ -150,7 +154,7 @@
</refsect1>
- <refsect1>
+ <refsect1 id="package.php.php-codesniffer.usage.summary-report">
<title>概要レポートの表示</title>
<para>
デフォルトでは、PHP_CodeSniffer は見つかったエラーや警告の完全な一覧を表示します。
@@ -203,61 +207,7 @@
</refsect1>
- <refsect1>
- <title>XML でのレポートの表示</title>
- <para>
- PHP_CodeSniffer は、結果を XML 形式で出力することもできます。
- これを使用すると、自作のスクリプトで結果を利用するのが簡単になります。
- XML 形式のレポートを表示するには、コマンドライン引数
- <literal>--report=xml</literal> を指定します。出力は、次のようになります。
- </para>
- <example>
- <title>PHP_CodeSniffer の XML 出力の例</title>
- <screen>
-<![CDATA[
-$ phpcs --report=xml /path/to/code
-
-<?xml version="1.0" encoding="UTF-8"?>
-<phpcs>
- <file name="/path/to/code/myfile.php" errors="5" warnings="1">
- <error line="2">Missing file doc comment</error>
- <error line="20">PHP keywords must be lowercase; expected "false" but found "FALSE"</error>
- <error line="47">Line not indented correctly; expected 4 spaces but found 1</error>
- <warning line="47">Equals sign not aligned with surrounding assignments</warning>
- <error line="51">Missing function doc comment</error>
- <error line="88">Line not indented correctly; expected 9 spaces but found 6</error>
- </file>
-</phpcs>
-]]>
- </screen>
- </example>
- <para>
- 完全なレポートだけでなく、警告を非表示にしたレポートも作成することができます。
- この場合は、コマンドライン引数 <literal>-n</literal> を使用します。
- </para>
- <example>
- <title>PHP_CodeSniffer の XML 出力で、警告を出力しない例</title>
- <screen>
-<![CDATA[
-$ phpcs --report=xml /path/to/code
-
-<?xml version="1.0" encoding="UTF-8"?>
-<phpcs>
- <file name="/path/to/code/myfile.php" errors="5" warnings="0">
- <error line="2">Missing file doc comment</error>
- <error line="20">PHP keywords must be lowercase; expected "false" but found "FALSE"</error>
- <error line="47">Line not indented correctly; expected 4 spaces but found 1</error>
- <error line="51">Missing function doc comment</error>
- <error line="88">Line not indented correctly; expected 9 spaces but found 6</error>
- </file>
-</phpcs>
-]]>
- </screen>
- </example>
- </refsect1>
-
-
- <refsect1>
+ <refsect1 id="package.php.php-codesniffer.usage.verbose-output">
<title>詳細な出力の表示</title>
<para>
デフォルトでは PHP_CodeSniffer は何も言わずに動作し、
@@ -290,7 +240,7 @@
</refsect1>
- <refsect1>
+ <refsect1 id="package.php.php-codesniffer.usage.coding-standard">
<title>コーディング規約の指定</title>
<para>
PHP_CodeSniffer は、複数のプロジェクトで使用するために、
@@ -317,7 +267,7 @@
</refsect1>
- <refsect1>
+ <refsect1 id="package.php.php-codesniffer.usage.installed-standards">
<title>インストールされているコーディング規約一覧の表示</title>
<para>
PHP_CodeSniffer は、インストールされているコーディング規約を一覧表示することができます。
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/php/php-codesniffer/config-options.xml?r1=1.1&r2=1.2&diff_format=u
Index: peardoc/ja/package/php/php-codesniffer/config-options.xml
diff -u peardoc/ja/package/php/php-codesniffer/config-options.xml:1.1 peardoc/ja/package/php/php-codesniffer/config-options.xml:1.2
--- peardoc/ja/package/php/php-codesniffer/config-options.xml:1.1 Sat Sep 22 02:24:20 2007
+++ peardoc/ja/package/php/php-codesniffer/config-options.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.php.php-codesniffer.config-options">
<refnamediv>
<refname>設定オプション</refname>
@@ -31,6 +31,34 @@
</example>
</refsect2>
+ <refsect2 id="package.php.php-codesniffer.config-options.php-codesniffer.show-warnings">
+ <title>警告をデフォルトで隠す</title>
+ <para>
+ デフォルトでは、PHP_CodeSniffer はコードのエラーと警告の両方を表示します。
+ 特定のスクリプトで警告を表示しないようにするにはコマンドライン引数
+ <literal>-n</literal> を実行しますが、
+ もしお望みならこれをデフォルトの設定にすることもできます。
+ デフォルトで警告を隠すようにするには、設定オプション
+ <literal>show_warnings</literal> を <literal>0</literal> に設定します。
+ </para>
+ <example>
+ <title>警告をデフォルトで隠す</title>
+ <screen>
+ <userinput>
+<![CDATA[
+$ phpcs --config-set show_warnings 0
+]]>
+ </userinput>
+ </screen>
+ </example>
+ <note>
+ <simpara>
+ デフォルトで警告を隠す設定にしたときに、特定のスクリプトで警告を表示させるには
+ コマンドライン引数 <literal>-w</literal> を使用します。
+ </simpara>
+ </note>
+ </refsect2>
+
</refsect1>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/php/php-codesniffer/advanced-usage.xml?r1=1.4&r2=1.5&diff_format=u
Index: peardoc/ja/package/php/php-codesniffer/advanced-usage.xml
diff -u peardoc/ja/package/php/php-codesniffer/advanced-usage.xml:1.4 peardoc/ja/package/php/php-codesniffer/advanced-usage.xml:1.5
--- peardoc/ja/package/php/php-codesniffer/advanced-usage.xml:1.4 Sat Sep 22 02:24:20 2007
+++ peardoc/ja/package/php/php-codesniffer/advanced-usage.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.5 Maintainer: takagi Status: ready -->
<refentry id="package.php.php-codesniffer.advanced-usage">
<refnamediv>
<refname>高度な使用法</refname>
@@ -103,6 +103,165 @@
</refsect1>
+ <refsect1 id="package.php.php-codesniffer.advanced-usage.xml-report">
+ <title>XML でのレポートの表示</title>
+ <para>
+ PHP_CodeSniffer は、結果を XML 形式で出力することもできます。
+ これを使用すると、自作のスクリプトで結果を利用するのが簡単になります。
+ XML 形式のレポートを表示するには、コマンドライン引数
+ <literal>--report=xml</literal> を指定します。出力は、次のようになります。
+ </para>
+ <example>
+ <title>PHP_CodeSniffer の XML 出力の例</title>
+ <screen>
+<![CDATA[
+$ phpcs --report=xml /path/to/code
+
+<?xml version="1.0" encoding="UTF-8"?>
+<phpcs version="1.0.0">
+ <file name="/path/to/code/myfile.php" errors="5" warnings="1">
+ <error line="2" column="1">Missing file doc comment</error>
+ <error line="20" column="43">PHP keywords must be lowercase; expected "false" but found "FALSE"</error>
+ <error line="47" column="1">Line not indented correctly; expected 4 spaces but found 1</error>
+ <warning line="47" column="20">Equals sign not aligned with surrounding assignments</warning>
+ <error line="51" column="4">Missing function doc comment</error>
+ <error line="88" column="1">Line not indented correctly; expected 9 spaces but found 6</error>
+ </file>
+</phpcs>
+]]>
+ </screen>
+ </example>
+ <para>
+ 完全なレポートだけでなく、警告を非表示にしたレポートも作成することができます。
+ この場合は、コマンドライン引数 <literal>-n</literal> を使用します。
+ </para>
+ <example>
+ <title>PHP_CodeSniffer の XML 出力で、警告を出力しない例</title>
+ <screen>
+<![CDATA[
+$ phpcs -n --report=xml /path/to/code
+
+<?xml version="1.0" encoding="UTF-8"?>
+<phpcs version="1.0.0">
+ <file name="/path/to/code/myfile.php" errors="5" warnings="0">
+ <error line="2" column="1">Missing file doc comment</error>
+ <error line="20" column="43">PHP keywords must be lowercase; expected "false" but found "FALSE"</error>
+ <error line="47" column="1">Line not indented correctly; expected 4 spaces but found 1</error>
+ <error line="51" column="4">Missing function doc comment</error>
+ <error line="88" column="1">Line not indented correctly; expected 9 spaces but found 6</error>
+ </file>
+</phpcs>
+]]>
+ </screen>
+ </example>
+ </refsect1>
+
+
+ <refsect1 id="package.php.php-codesniffer.advanced-usage.checkstyle-report">
+ <title>Checkstyle でのレポートの表示</title>
+ <para>
+ PHP_CodeSniffer は、結果を <ulink url="http://checkstyle.sourceforge.net/">Checkstyle</ulink>
+ 形式の XML で出力することができます。これを使用すると、
+ Checkstyle 形式をサポートしているアプリケーションやスクリプトで
+ その出力結果を使用することができます。Checkstyle 形式のレポートを表示するには、
+ コマンドライン引数 <literal>--report=checkstyle</literal> を使用します。出力は、次のようになります。
+ </para>
+ <example>
+ <title>PHP_CodeSniffer の Checkstyle 出力の</title>
+ <screen>
+<![CDATA[
+$ phpcs --report=checkstyle /path/to/code
+
+<?xml version="1.0" encoding="UTF-8"?>
+<checkstyle version="1.0.0">
+ <file name="/path/to/code/myfile.php">
+ <error line="2" column="1" severity="error" message="Missing file doc comment"/>
+ <error line="20" column="43" severity="error" message="PHP keywords must be lowercase; expected "false" but found "FALSE""/>
+ <error line="47" column="1" severity="error" message="Line not indented correctly; expected 4 spaces but found 1"/>
+ <error line="47" column="20" severity="warning" message="Equals sign not aligned with surrounding assignments"/>
+ <error line="51" column="4" severity="error" message="Missing function doc comment"/>
+ <error line="88" column="1" severity="error" message="Line not indented correctly; expected 9 spaces but found 6"/>
+ </file>
+</checkstyle>
+]]>
+ </screen>
+ </example>
+ <para>
+ As with the full report, you can suppress the printing of warnings with the <literal>-n</literal> command line argument.
+ </para>
+ <example>
+ <title>Sample PHP_CodeSniffer Checkstyle output with no warnings</title>
+ <screen>
+<![CDATA[
+$ phpcs -n --report=checkstyle /path/to/code
+
+<?xml version="1.0" encoding="UTF-8"?>
+<checkstyle version="1.0.0">
+ <file name="/path/to/code/myfile.php">
+ <error line="2" column="1" severity="error" message="Missing file doc comment"/>
+ <error line="20" column="43" severity="error" message="PHP keywords must be lowercase; expected "false" but found "FALSE""/>
+ <error line="47" column="1" severity="error" message="Line not indented correctly; expected 4 spaces but found 1"/>
+ <error line="51" column="4" severity="error" message="Missing function doc comment"/>
+ <error line="88" column="1" severity="error" message="Line not indented correctly; expected 9 spaces but found 6"/>
+ </file>
+</checkstyle>
+]]>
+ </screen>
+ </example>
+ </refsect1>
+
+
+ <refsect1 id="package.php.php-codesniffer.advanced-usage.csv-report">
+ <title>CSV でのレポートの表示</title>
+ <para>
+ PHP_CodeSniffer は、結果を CSV 形式のレポートとして出力することもできます。
+ これを使用すると、自作のスクリプトで結果を利用するのが簡単になります。
+ CSV 形式のレポートを表示するには、コマンドライン引数
+ <literal>--report=csv</literal> を使用します。出力は、次のようになります。
+ </para>
+ <example>
+ <title>PHP_CodeSniffer の CSV 出力の例</title>
+ <screen>
+<![CDATA[
+$ phpcs --report=csv /path/to/code
+
+File,Line,Column,Severity,Message
+"/path/to/code/myfile.php",2,1,error,"Missing file doc comment"
+"/path/to/code/myfile.php",20,43,error,"PHP keywords must be lowercase; expected \"false\" but found \"FALSE\""
+"/path/to/code/myfile.php",47,1,error,"Line not indented correctly; expected 4 spaces but found 1"
+"/path/to/code/myfile.php",47,20,warning,"Equals sign not aligned with surrounding assignments"
+"/path/to/code/myfile.php",51,4,error,"Missing function doc comment"
+"/path/to/code/myfile.php",88,1,error,"Line not indented correctly; expected 9 spaces but found 6"
+]]>
+ </screen>
+ </example>
+ <para>
+ 完全なレポートだけでなく、警告を非表示にしたレポートも作成することができます。
+ この場合は、コマンドライン引数 <literal>-n</literal> を使用します。
+ </para>
+ <example>
+ <title>PHP_CodeSniffer の CSV 出力で、警告を出力しない例</title>
+ <screen>
+<![CDATA[
+$ phpcs -n --report=csv /path/to/code
+
+File,Line,Column,Severity,Message
+"/path/to/code/myfile.php",2,1,error,"Missing file doc comment"
+"/path/to/code/myfile.php",20,43,error,"PHP keywords must be lowercase; expected \"false\" but found \"FALSE\""
+"/path/to/code/myfile.php",47,1,error,"Line not indented correctly; expected 4 spaces but found 1"
+"/path/to/code/myfile.php",51,4,error,"Missing function doc comment"
+"/path/to/code/myfile.php",88,1,error,"Line not indented correctly; expected 9 spaces but found 6"
+]]>
+ </screen>
+ </example>
+ <note>
+ <simpara>
+ CSV 出力の最初の行は、情報の並び順を表します。
+ CSV 出力を使用する際は、このヘッダ行の情報をもとにしてデータを取得するようにしましょう。
+ CSV の書式が替わったり、新たな情報が追加されたりする可能性もあります。
+ </simpara>
+ </note>
+ </refsect1>
<refsect1 id="package.php.php-codesniffer.advanced-usage.config-set">
@@ -129,7 +288,27 @@
</refsect1>
-
+ <refsect1 id="package.php.php-codesniffer.advanced-usage.config-delete">
+ <title>設定オプションの削除</title>
+ <para>
+ PHP_CodeSniffer では、任意の設定オプションを削除してデフォルト値に戻すことができます。
+ <link linkend="package.php.php-codesniffer.config-options">設定オプションの全一覧はこちらです</link>。
+ </para>
+ <para>
+ 設定オプションを削除するには、コマンドライン引数
+ <literal>--config-delete</literal> を使用します。
+ </para>
+ <example>
+ <title>設定オプションの削除</title>
+ <screen>
+ <userinput>
+<![CDATA[
+$ phpcs --config-delete <option>
+]]>
+ </userinput>
+ </screen>
+ </example>
+ </refsect1>
<refsect1 id="package.php.php-codesniffer.advanced-usage.config-show">
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/html/html-table/faq.xml?r1=1.3&r2=1.4&diff_format=u
Index: peardoc/ja/package/html/html-table/faq.xml
diff -u peardoc/ja/package/html/html-table/faq.xml:1.3 peardoc/ja/package/html/html-table/faq.xml:1.4
--- peardoc/ja/package/html/html-table/faq.xml:1.3 Sat Oct 27 14:37:57 2007
+++ peardoc/ja/package/html/html-table/faq.xml Fri Nov 9 22:43:33 2007
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.6 Maintainer: takagi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.8 Maintainer: takagi Status: ready -->
<refentry id="package.html.html-table.faq">
<refnamediv>
<refname>FAQ</refname>
@@ -89,6 +89,9 @@
Stuart Langridge が開発した JavaScript クラスである <ulink
url="&url.html_table.javascript.sorting;">SortTable</ulink>
を用いると、ソート機能を非常に簡単にテーブルに追加できるようになります。
+ あるいは、<ulink
+ url="&url.html_table.javascript.sorting2;">Standardista Table
+ Sorting</ulink> というクラスを使うこともできます。
</para>
</answer>
</qandaentry>
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/structures/structures-datagrid/structures-datagrid/seturlformat.xml?view=markup&rev=1.1
Index: peardoc/ja/package/structures/structures-datagrid/structures-datagrid/seturlformat.xml
+++ peardoc/ja/package/structures/structures-datagrid/structures-datagrid/seturlformat.xml
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.structures.structures-datagrid.structures-datagrid.seturlformat">
<refnamediv>
<refname>
<function>Structures_DataGrid::setUrlFormat</function>
</refname>
<refpurpose>URL のマッピングを有効にし、設定する</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>require_once 'Structures/DataGrid.php';</funcsynopsisinfo>
<funcprototype>
<funcdef>
void
<function>Structures_DataGrid::setUrlFormat</function>
</funcdef>
<paramdef>
string
<parameter>$format</parameter>
</paramdef>
<paramdef>
string
<parameter>
<optional>$prefix = &null;</optional>
</parameter>
</paramdef>
<paramdef>
string
<parameter>
<optional>$scriptname = &null;</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid.seturlformat.desc">
&title.desc;
<para>
これを設定すると、GET/POST の代わりにパースされます。
これは PHP5 でのみサポートされています。というのも
Net_URL_Mapper を使用しているからです。
</para>
<para>
プレースホルダとして :pager、:orderBy および :direction
の 3 種類が使用できます。
:page あるいは (:orderBy および :direction) は個別に使用できます。
</para>
<para>
複数の DataGrid のインスタンスを同一のページで使用するには、
それぞれ別のプレフィックスを使用します。
</para>
</refsect1>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid.seturlformat.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$format</parameter>
</term>
<listitem>
<para>URL の書式。例を参照ください。</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$prefix</parameter>
</term>
<listitem>
<para>URL のプレフィックスを設定します。</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$scriptname</parameter>
</term>
<listitem>
<para>mod_rewrite が使用できない場合に用いるスクリプト名を設定します。</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid.seturlformat.throws">
&title.throws;
<para>
Net_URL_Mapper_InvalidException をスローします。
</para>
</refsect1>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid.seturlformat.example">
<title>例</title>
<para>
<example>
<title>URL の書式の設定</title>
<programlisting role="php">
<![CDATA[<?php
// どちらも同じことです。たとえば /page/5/foo/ASC のようになります
$datagrid->setUrlFormat('/page/:page/:orderBy/:direction');
$datagrid->setUrlFormat('/:page/:orderBy/:direction', 'page');
// /page がない場合、たとえば /5/foo/ASC など
$datagrid->setUrlFormat('/:page/:orderBy/:direction');
// ページングを行わない場合、たとえば /sort/foo/ASC など
$datagrid->setUrlFormat('/:orderBy/:direction', 'sort');
// スクリプト名を使用する場合、たとえば /index.php/5/foo/ASC など
$datagrid->setUrlFormat('/:page/:orderBy/:direction', 'page', 'index.php');
?>]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 id="package.structures.structures-datagrid.structures-datagrid.seturlformat.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>