The Shoes Manual


Check boxes are clickable square boxes than can be either checked or unchecked. A single checkbox usually asks a "yes" or "no" question. Sets of checkboxes are also seen in to-do lists.

Here's a sample checklist. do
   stack do
     flow { check; para "Frances Johnson" }
     flow { check; para "Ignatius J. Reilly" }
     flow { check; para "Winston Niles Rumfoord" }

You basically have two ways to use a check. You can attach a block to the check and it'll get called when the check gets clicked. And/or you can just use the checked? method to go back and see if a box has been checked or not.

Okay, let's add to the above example. do
   @list = ['Frances Johnson', 'Ignatius J. Reilly',
     'Winston Niles Rumfoord']
   stack do! do |name|
       flow { @c = check; para name }
       [@c, name]
     button "What's been checked?" do
       selected = { |c, name| name if c.checked? }.compact
       alert("You selected: " + selected.join(', '))

So, when the button gets pressed, each of the checks gets asked for its status, using the checked? method.

Button methods are listed below, but also see the list of Common methods, which all elements respond to.

checked?() » true or false

Returns whether the box is checked or not. So, true means "yes, the box is checked!"

Marks or unmarks the check box. Using checked = false, for instance, unchecks the box.

When the check is clicked, its click block is called. The block is handed self, which is the check object which was clicked.

Clicks are sent for both checking and unchecking the box.

focus() » self

Moves focus to the check. The check will be highlighted and, if the user hits Enter, the check will be toggled between its checked and unchecked states.

Next: EditBox