CKCheckbox

チェックボックスを表示します。

必須属性: selectionとvalue, またはchecked

CKCheckboxとCKRadioButtonは、フィールドより少し複雑になります。これらのエレメントは「checked属性」か「value属性とselection属性」のどちらかの組み合わせを使います。

checked属性

checked属性を使う場合は、単純にオン／オフのみでチェックボックスを操作します。つまり、１つのチェックボックスにつき１つの変数を割り当てることになります。

<cgikit name=Form>
<cgikit name=Checkbox1>One</cgikit>
<cgikit name=Checkbox2>Two</cgikit>
<cgikit name=Checkbox3>Three</cgikit>
<cgikit name=Submit/>
</cgikit>

Form : CKForm {
}

Checkbox1 : CKCheckbox {
  checked = checkedOne;
}

Checkbox2 : CKCheckbox {
  checked = checkedTwo;
}

Checkbox3 : CKCheckbox {
  checked = checkedThree;
}

Submit : CKSubmitButton {
}

class Checkbox < CKComponent
  attr_accessor :checkedOne, :checkedTwo, :checkedThree
end

このようにchecked属性にそれぞれ別の変数を割り当てて、どのチェックボックスがチェックされているか判断します。チェックされると、変数にはtrueが代入されます。

value属性とselection属性

value属性にチェックボックスのデータを設定すると、そのデータがチェックしたときselection属性に代入されます。また、value属性とselection属性のデータが同じであればチェックボックスはオンになります。

基本的な動作はchecked属性を使う場合と変わりませんが、チェック時に代入されるデータが異なります。checked属性ではtrueが代入されますが、この場合value属性で設定したデータが代入されることになります。

<cgikit name=Form>
<cgikit name=Checkbox1>One</cgikit>
<cgikit name=Checkbox2>Two</cgikit>
<cgikit name=Checkbox3>Three</cgikit>
<cgikit name=Submit></cgikit>
</cgikit>

Form : CKForm {
}

Checkbox1 : CKCheckbox {
  value = "One";
  selection = checkedOne;
}

Checkbox2 : CKCheckbox {
  value = "Two";
  selection = checkedTwo;
}

Checkbox3 : CKCheckbox {
  value = "Three";
  selection = checkedThree;
}

Submit : CKSubmitButton {
}

class Checkbox < CKComponent
  attr_accessor :checkedOne, :checkedTwo, :checkedThree
end