Guile le 10 août 2025 à 09:14

2025-08-10T09:14:30Z

← Version précédente		Version du 10 août 2025 à 11:14
Ligne 2 :		Ligne 2 :
	In this tutorial, we'll see how to fill a label based on a dice roll result.		In this tutorial, we'll see how to fill a label based on a dice roll result.

	You will see that the solution can only be made with some script~~, using~~ a specific action button in the Dice Result.		You will see that the solution can only be made with some script. Here the solution uses a specific action button in the Dice Result.

	=== Step by step ===		=== Step by step ===

Guile : first tutorial

2025-05-08T21:35:24Z

first tutorial

Nouvelle page

=== Summary ===
In this tutorial, we'll see how to fill a label based on a dice roll result.

You will see that the solution can only be made with some script, using a specific action button in the Dice Result.

=== Step by step ===

# create an element that will trigger the dice roll. Ex: a label with the id <code>labelTriggeringDiceRoll</code>
# create an element that will receive the dice roll result (or anything based on the dice roll). Ex: a label with the id <code>labelReceivingDiceRoll</code>
# in the script, add an click event that rolls the dice you need by using <code>Dice.roll</code>
# <code>Dice.roll</code> accepts a list of action buttons as last parameter. This is an object whose keys are the Button label that will be shown in the Dice log and values are a function that is called when the button is clicked (see the [https://lets-role.com/help/en/documentation/v1/scripting/dice-api Actions section in the Dice API documentation]). The parameter given to the function is a [https://lets-role.com/help/en/documentation/v1/scripting/dice-result Dice Result].
# If correctly defined, the function can have an elegant access to the sheet.
# This access to the sheet is the main way to change the desired label.

=== Final code ===
Here is the code used in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo]
const labelToClick = sheet.get("labelTriggeringDiceRoll"); // get the label that will roll dice when clicked
labelToClick.on("click", function () { // handle the click event on the label
const actions = {}; // initiate the list of actions in dice result
actions[_("Apply to sheet")] = function (dice) { // add a translated button label
const labelToFill = sheet.get("labelReceivingDiceRoll"); // when click on the action button, the code can access to the label to change
labelToFill.value("Last roll was " + dice.total); // set anything in the label, based on dice
};
Dice.roll(sheet, "10+1D10", "Roll strength", "all", actions); // Roll the dice
});

=== Live example ===
You can see a live example in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo] in the tab "Fill with Dice Result" (you must run a table in order to have dice rolls, the sheet preview block dice rolls)

You can check the code in the function <code>initFillWithRoll</code> that illustrates what is described in this tutorial.

Put a dice roll result in the sheet - Historique des versions

Guile le 10 août 2025 à 09:14

Guile : first tutorial

Guile : first tutorial