Custom element label column width: For all the group styles except flow-group and description-group we print the group element label in a separate column to align the fields (data). The default width of this is 35% of the available width and the rest goes to the data. But in some cases you have very long or very short labels and would like to change this. If
so just pass the option elementカスタム要素ラベルの列幅:flow-groupとdescription-groupを除くすべてのグループスタイルでは、フィールド (データ) を整列させるために、グループ要素のラベルを別の列に印刷します。
これのデフォルトの幅は利用可能な幅の 35% で、残りはデータに行きます。しかし、場合によっては、非常に長いラベルまたは非常に短いラベルがあり、この幅を変更する場合もあります。
その場合は、オプション要素-label-column-percentage-width=XX where XX is the percentage value for the column (do not include the %).
Column width when using multiple columns: If you have a flag or group XSL style with more than one column we adjust this up so that you get a larger % of the available group for the label. Two/three columns style is often used when you have many "simple" elements with e.g. numeric or check boxes, and you therefor need more space for labels (if you have default 35% of the page width for labels and you have a two column then there is only 17.5% of the page width for label). In the case of two/three columns where therefore "automatically" adjust this value. The algorithm we use for this is as follows:
two-columns: Label width を渡してください。XX は列のパーセンテージ値です (% は含まれません)。
複数の列を使用する場合の列幅: 複数の列を持つフラッグまたはグループXSLスタイルの場合、ラベルに使用可能なグループの % (割合)が大きくなるように調整します。
2/3 列のスタイルは、数値ボックスやチェック ボックスなどの "シンプルな"要素が多数あり、そのためにラベル用のスペースがさらに必要な場合
(デフォルトのページ幅の35%をラベルに使っていて、2列にした場合、ラベル用のページ幅は17.5%しかありません)。
2 / 3列の場合は、この値を " 自動的に" 調整します。そのためのアルゴリズムは以下の通りです:
two-columns (2 列): Label width (ラベルの幅)= (column-width) + ((column-width) * (100-column-width)%).
E.g. if column width is 35, then column width of two column = 35 例えば、カラム幅が35の場合、2列の列幅は35+35*65%= 58%. In other words - if you have a small percentage for column width then you get a relatively larger width in two columns (but the width in cm is still smaller) than if you already have a large percentage for the column width.
Specify columns for dynamic field table: When using dynamic field table the default behavior is to give each field the same relative width. E.g. if three columns they all get 1/3 each no matter if it is a checkbox or a text field. You can pass options to specify the relative size for each column using the option: 58%となります。つまり、列幅のパーセンテージが小さければ、列幅のパーセンテージが大きい場合よりも、
2列の列幅は相対的に大きくなります(ただし、cm単位の幅は小さくなります)。
動的フィールドテーブルの列を指定する:動的フィールド・テーブルを使用する場合、デフォルトの動作は各フィールドに同じ相対幅を与えることです。
例えば、3列の場合、チェックボックスでもテキストフィールドでも、すべて1/3ずつになります。
dyn-field-table-column-width-NN=XX. Here NN must be replaced with the column index and XX is the relative size.
If you use this option it is important that you specify enough values for the maximum number of columns that are going to be printed. If you e.g. have one element with four fields and one with three, you must specify four values. The element with three would then only use the first three.
Right align numeric data in dynamic field table: If using dynamic field table you can give an extra option: XXオプションを使用して、各列の相対サイズを指定するオプションを渡すことができます。
ここでNNは列のインデックスに置き換えなければならず、XXは相対サイズです。
このオプションを使用する場合は、印刷する列の最大数に十分な値を指定することが重要です。例えば、4つのフィールドを持つ要素と3つのフィールドを持つ要素がある場合、
4つの値を指定しなければなりません。その場合、3つのフィールドを持つ要素は最初の3つだけを使用することになります。
動的フィールドテーブルの数値データを右揃えにする: 動的フィールド・テーブルを使用する場合、追加オプションとして right-align-numeric-in-table=true to make right align numeric values in the column.
Important note for dynamic field table: The built in version of this style is much more fragile when it comes to using this style. It expects that all the elements in the group has the same number of fields - and if it does not it will crash. So use this style with care, and if you use it the built in reports might not work.
Indentation for disabled elements: In dRofus you can set up the dynamic GUI so that some fields are enabled or disabled depending on if a check box is checked or not. This is a quite common "pattern" and used e.g. to enable a description field. But sometime you also use this to enable/disable all the fields in another element. In that case the whole element is enabled/disabled by another field. In the default reports these elements are not printed at all unless the field is checked. But when using these building blocks they are.
The default style for this is that the label is grey (you can modify the style dyn-disabled- label in the CSS if you would like to show this in another way). But one thing you cannot control using this style is the indentation. To set indentation of elements that are enabled/disabled by a checkbox in another element set: elementtrueを指定することで、
カラム内の数値を右寄せにすることができます。
動的フィールドテーブルに関する重要な注意事項:このスタイルの内蔵バージョンは、このスタイルを使用することになるとはるかに壊れやすいです。
グループ内のすべての要素が同じ数のフィールドを持っていることを想定しているため、そうでない場合はクラッシュします。そのため、このスタイルの使用には注意が必要です。
また、このスタイルを使用すると、組み込まれたレポートが機能しなくなる可能性があります。
無効要素のインデント:dRofusでは、動的GUIを設定し、チェックボックスがチェックされているか否かに応じて、いくつかのフィールドが有効または無効になるようにすることができます。
これは非常に一般的な "パターン (pattern)"で、例えば説明フィールドを有効にするために使用します。しかし、別の要素のすべてのフィールドを有効/無効にするために、
この方法を使うこともあります。その場合、要素全体が別のフィールドによって有効/無効になります。デフォルトのレポートでは、フィールドがチェックされていない限り、
これらの要素はまったく印刷されません。しかし、これらのビルディング・ブロックを使えば、そうなります。
この場合のデフォルトのスタイルは、ラベルがグレー色になります (別の方法で表示したい場合は、CSSでスタイルdyn-disabled- labelを変更できます)。
しかし、このスタイルで制御できないことのひとつに、インデントがあります。別の要素セットのチェックボックスによって有効/無効にされる要素のインデントを設定するには:
element-is-disabled-bylabel- indent=XXyy. Note that this option not only need the value XX, but also the unit yy (e.g. mm, px, pt etc).
Show checkboxes in front of element label: If the first field of an element in dRofus is a checkbox, and this field does not have its own label one could say that the checkbox is for the element and not the field it selves. But in the client and the default layout in the reports is to show it after the element label.
You can overwrite this feature in the report by passing the option XXyy。このオプションは、値XXだけでなく、単位yyも必要であることに注意してください (例:mm、px、ptなど) 。
要素ラベルの前にチェックボックスを表示する:dRofusの要素の最初のフィールドがチェックボックスで、このフィールドに独自のラベルがない場合は、チェックボックスは要素のためのものであり、フィールド自身のためのものではない、と言うことができます。 しかし、クライアントやレポートのデフォルトのレイアウトでは、要素のラベルの後に表示されます。
レポート内でこの機能を上書きするには、show-checkbox-before- element-label=true. If the first field of an element is checkbox and the checkbox does not have its own label (or it has a label, but the option オプションを指定します。要素の最初のフィールドがチェック ボ ック スであって、チェック ボ ックス がそれ自身の ラ ベルを持たない (あるいはラベルは持っているが Show label= "Do not show label" ) then the checkbox is printed before the element label and excluded from the fields to print after.
A special note about using this style in combination with the two- or three-column-group xsl style: Normally when using two- or three-column group style we would split the elements into two or three parts and print each of them in a column using the group layout-style. But if show checkboxes in front option is set and we have a two- or three- column group we would print them using the flow-group style instead. This is because a normal pattern for using this is to have a lot of checkboxes in a group and optionally some text fields after the checkboxes. If we use the group style in a two or three column there is very limited space left for the content column (with fields). And we also do not need to align the checkboxes any more (they are in front) so any additional fields would just flow after the element label.
Control if group label should be printed: Default behavior is that before we print any of the elements in the group we print the group label if the group has any label. You can control the style (font/borders/colors etc.) in the style sheet, but using an option you can also control when it should be shown (or not).
You can pass the option オプシ ョンを指定 している) 場合、チェック ボ ック スは要素ラ ベルの前に印字され、その後に印字 されるフィールドから除外されます。
要素の最初のフィールドが checkbox (チェックボックス)で、チェックボックスに独自のラベルがない場合
(または、ラベルがあるが、Show label="ラベルを表示しない "というオプションがある場合)チェックボックスは要素ラベルの前に印刷され、その後に印刷されるフィールドからは除外されます。
このスタイルを2列または3列グループのxslスタイルと組み合わせて使用する際の注意点:通常、2列や 3列のグループ・スタイルを使用する場合、要素を2つまたは3つの部分に分割し、
グループ・レイアウト・スタイルを使用して各要素を1列に印刷します。しかし、チェックボックスを前面に表示するオプションが設定されていて、2列または3列のグループがある場合、
代わりにフローグループ・スタイルを使って印刷することになります。 これは、グループ内にたくさんのチェックボックスがあり、オプションでチェックボックスの後に、
いくつかのテキストフィールドがあるのが通常の使用パターンだからです。2 列または 3 列の列でグループ・スタイルを使用する場合 (フィールドを含む) 内容列のために残されたスペースは、
非常に限られています。また、チェックボックスの位置を揃える必要もなくなったので(チェックボックスは前面にあります)、追加フィールドは要素ラベルの後に流れるように配置されます。
グループラベルを印刷するかどうかを制御する:デフォルトの動作は、グループ内の要素を表示する前に、グループにラベルがあれば、そのラベルを表示します。
スタイルシートでスタイル (フォント/ボーダー/色など) をコントロールできますが、オプションを使って、いつ表示するか (または、表示させないか) を制御することもできます。
オプションshow-group-label=mode, where mode is one of:
- always: Will always make room for the group label even if the group does not have a label.
- nonempty: Will print the label if the group has any label (even if it is not shown in the client). This is the default behaviour.
- inclient: Will print the label only if the group has a label and it is also shown in the client (e.g. "Show border" is true for the group).
- never: Will never print the group label.
Using more than one option: More than one option can be given to the same parameter option, just comma separated.
Example: To give the element label column width of 25%, show checkboxes before elements, never show group label, indent disabled elements by 5mm and custom columns for the flow table - use the following option:を渡すことができます。モードは以下のいずれかです:
- always (常に):グループにラベルがない場合でも、常にグループラベルの余地を作ります。
- nonempty (空でない):グループにラベルがある場合 (クライアントに表示されていなくても) ラベルを印刷します。これがデフォルトの動作です。
- inclient (インクライアント):グループにラベルがあり、クライアントにも表示されている場合にのみラベルを印刷します (例:"Show border (ボーダーを表示)"はグループに対して有効)。
- never (絶対ない):グループラベルを印刷しない。
複数のオプションを使用する: 同じパラメータ・オプションに対して、カンマ区切りで複数のオプションを指定することができます。
例 要素ラベルの列幅を25%にし、要素の前にチェックボックスを表示し、グループラベルを表示せず、無効な要素を5mmずつインデントし、
フローテーブルの列をカスタム化するには、以下のオプションを使用します:
show-checkbox-before-element-label=true,element-is-disabled-by-label- indent=5mm,element-label-column-percentagewidth=25,show-group- label=never,dyn-field-table-column-width-1=1,dyn-field-table-column- width-2=2,dyn-field-table-column-width-3=12 |
---|
...