Chore: Document _styleBeforeCompletion and _styleAfterClick (fixes #260)

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`.
 

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",

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",

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",