From 2a8d2d858269cdd848acbf7728546d325aef2e10 Mon Sep 17 00:00:00 2001 From: Brad Simpson Date: Fri, 22 May 2026 14:20:42 -0600 Subject: [PATCH 1/2] Document _isFullWidth override of _styleAfterClick (fixes #260) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0348c12..30e3b97 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,7 @@ The attributes listed below are properly formatted as JSON in [*example.json*](h >>**\_styleBeforeCompletion** (string): Determines whether the Trickle button is visible even while subsequent sections of the page remain inaccessible. Acceptable values are `"hidden"`, `"disabled"`, and `"visible"`. The default is `"hidden"`. ->>**\_styleAfterClick** (string): Determines the properties of the Trickle button after it has been clicked. Acceptable values are `"hidden"`, `"disabled"`, and `"visible"`. `"hidden"` hides the button. `"disabled"` applies the "disabled" CSS class. The value `"visible"` will cause the button to maintain its visibility allowing the user an alternative method for scrolling down the page by using the button (even after all sections have been revealed). The default is `"hidden"`. +>>**\_styleAfterClick** (string): Determines the properties of the Trickle button after it has been clicked. Acceptable values are `"hidden"`, `"disabled"`, and `"visible"`. `"hidden"` hides the button. `"disabled"` applies the "disabled" CSS class. The value `"visible"` will cause the button to maintain its visibility allowing the user an alternative method for scrolling down the page by using the button (even after all sections have been revealed). The default is `"hidden"`. Note: when **\_isFullWidth** is `true`, the button is always hidden after completion regardless of this setting, to prevent stacked absolutely-positioned buttons. >>**\_isFullWidth** (boolean): Will position the button fixed to the bottom of the window. This option will force to `true` **\_isEnabled** in the **\_stepLocking** attribute group (**\_stepLocking.\_isEnabled: true**). When **\_autoHide** is set to `true`, the button will fade-out when the learner scrolls up, away from the button. The default is `true`. From 9303e9ac9644662e00d986007b04845fd3193e33 Mon Sep 17 00:00:00 2001 From: Brad Simpson Date: Fri, 22 May 2026 14:25:06 -0600 Subject: [PATCH 2/2] Add schema descriptions for _styleBeforeCompletion and _styleAfterClick --- properties.schema | 8 ++++---- schema/article.schema.json | 2 ++ schema/block.schema.json | 2 ++ 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/properties.schema b/properties.schema index 2c59209..fc57b48 100644 --- a/properties.schema +++ b/properties.schema @@ -142,7 +142,7 @@ "title": "Initial Visibility", "inputType": {"type": "Select", "options":["hidden", "visible", "disabled"]}, "validators": ["required"], - "help": "Set button visibility before completion" + "help": "Button visibility before step completion. Default: hidden." }, "_styleAfterClick": { "type": "string", @@ -152,7 +152,7 @@ "title": "Final Visibility", "inputType": {"type": "Select", "options":["hidden", "visible", "disabled"]}, "validators": ["required"], - "help": "Set button visibility after completion" + "help": "Button visibility after step completion. Default: hidden. Ignored when Full Width is true; the button is always hidden after completion to prevent stacked buttons." }, "_isFullWidth": { "type": "boolean", @@ -398,7 +398,7 @@ "default": "hidden", "title": "Initial Visibility", "inputType": {"type": "Select", "options":["hidden", "visible", "disabled"]}, - "help": "Set button visibility before completion" + "help": "Button visibility before step completion. Default: hidden." }, "_styleAfterClick": { "type": "string", @@ -407,7 +407,7 @@ "default": "hidden", "title": "Final Visibility", "inputType": {"type": "Select", "options":["hidden", "visible", "disabled"]}, - "help": "Set button visibility after completion" + "help": "Button visibility after step completion. Default: hidden. Ignored when Full Width is true; the button is always hidden after completion to prevent stacked buttons." }, "_isFullWidth": { "type": "boolean", diff --git a/schema/article.schema.json b/schema/article.schema.json index 824c718..400eb55 100644 --- a/schema/article.schema.json +++ b/schema/article.schema.json @@ -72,6 +72,7 @@ "_styleBeforeCompletion": { "type": "string", "title": "Visibility before completion", + "description": "Button visibility before step completion. Default: hidden.", "default": "hidden", "enum": [ "hidden", @@ -83,6 +84,7 @@ "_styleAfterClick": { "type": "string", "title": "Visibility after completion", + "description": "Button visibility after step completion. Default: hidden. Ignored when Full Width is true; the button is always hidden after completion to prevent stacked buttons.", "default": "hidden", "enum": [ "hidden", diff --git a/schema/block.schema.json b/schema/block.schema.json index b1ec7c6..08982fd 100644 --- a/schema/block.schema.json +++ b/schema/block.schema.json @@ -67,6 +67,7 @@ "_styleBeforeCompletion": { "type": "string", "title": "Visibility before completion", + "description": "Button visibility before step completion. Default: hidden.", "default": "hidden", "enum": [ "hidden", @@ -78,6 +79,7 @@ "_styleAfterClick": { "type": "string", "title": "Visibility after completion", + "description": "Button visibility after step completion. Default: hidden. Ignored when Full Width is true; the button is always hidden after completion to prevent stacked buttons.", "default": "hidden", "enum": [ "hidden",