Checkbox
A box to check, with its label: a click on either changes it.
import { Checkbox } from "x4js"
Change
change gives the new state in ev.value.
export function change( ) {
const state = new Label( { text: "" } );
return new HBox( { content: [
new Checkbox( { label: "Send me the news", change: ( ev ) => state.setText( `checked: ${ev.value}` ) } ),
state,
] } );
}
From the code
setCheck sets the state, toggle inverts it, getCheck reads it; none of them fires change.
export function fromCode( ) {
const bread = new Checkbox( { label: "Bread", checked: true } );
const milk = new Checkbox( { label: "Milk" } );
const eggs = new Checkbox( { label: "Eggs" } );
const result = new Label( { text: "" } );
return new VBox( { content: [
new HBox( { content: [ bread, milk, eggs ] } ),
new HBox( { content: [
new Button( { label: "All", click: ( ) => {
bread.setCheck( true );
milk.setCheck( true );
eggs.setCheck( true );
} } ),
new Button( { label: "Toggle", cls: "outline", click: ( ) => {
bread.toggle( );
milk.toggle( );
eggs.toggle( );
} } ),
new Button( { label: "getCheck", cls: "outline", click: ( ) => {
result.setText( `bread ${bread.getCheck( )}, milk ${milk.getCheck( )}, eggs ${eggs.getCheck( )}` );
} } ),
result,
] } ),
] } );
}
In a Form
Without a value the form reads a boolean; with one, the value when checked and null when not.
export function inForm( ) {
const result = new Label( { text: "" } );
// flex: none: a Form grows (flex) and would get no height in a box that has none
const form = new Form( { style: { flex: "none" }, content: [
new Checkbox( { label: "Newsletter", name: "news", checked: true } ),
new Checkbox( { label: "Pro plan", name: "plan", value: "pro" } ),
] } );
return new VBox( { content: [
form,
new HBox( { content: [
new Button( { label: "getValues", click: ( ) => result.setText( JSON.stringify( form.getValues( ) ) ) } ),
new Button( { label: "setValues", cls: "outline", click: ( ) => form.setValues( { news: false, plan: "pro" } ) } ),
result,
] } ),
] } );
}
Toggle buttons
A toggle button is a Checkbox with cls: "button". icon puts an icon before the label; without a label, the icon alone (with a tooltip), as in a toolbar; with danger, checked in red. Its icon is 24px: a class of the page sets --checkbox-button-icon-size (the last line, 16px).
export function icons( ) {
return new VBox( { cls: "checkbox-icons", content: [
new HBox( { content: [
new Checkbox( { cls: "button", icon: icon_star, tooltip: "Favourite", checked: true } ),
new Checkbox( { cls: "button", icon: icon_heart, tooltip: "Like" } ),
new Checkbox( { cls: "button", icon: icon_mail, tooltip: "Notify me" } ),
new Checkbox( { cls: "button danger", icon: icon_trash, tooltip: "Mark for deletion", checked: true } ),
] } ),
new HBox( { content: [
new Checkbox( { cls: "button", icon: icon_star, label: "Favourite", checked: true } ),
new Checkbox( { cls: "button", icon: icon_heart, label: "Like" } ),
new Checkbox( { cls: "button", icon: icon_mail, label: "Notify me" } ),
] } ),
new HBox( { content: [
new Checkbox( { cls: "button small-icon", icon: icon_star, label: "Favourite", checked: true } ),
new Checkbox( { cls: "button small-icon", icon: icon_heart, label: "Like" } ),
new Checkbox( { cls: "button small-icon", icon: icon_mail, label: "Notify me" } ),
] } ),
] } );
}
.checkbox-icons {
gap: 10px;
> .x4hbox {
gap: 12px;
}
// the size of the icon of a toggle button: its variable, set by a class of the page
.small-icon {
--checkbox-button-icon-size: 16px;
}
}
For an assistant: llms.txt, llms-full.txt.