summaryrefslogtreecommitdiffstats
path: root/site/layouts/partials/js-data-attributes.md
diff options
context:
space:
mode:
Diffstat (limited to 'site/layouts/partials/js-data-attributes.md')
-rw-r--r--site/layouts/partials/js-data-attributes.md3
1 files changed, 3 insertions, 0 deletions
diff --git a/site/layouts/partials/js-data-attributes.md b/site/layouts/partials/js-data-attributes.md
new file mode 100644
index 0000000..e99ff71
--- /dev/null
+++ b/site/layouts/partials/js-data-attributes.md
@@ -0,0 +1,3 @@
+As options can be passed via data attributes or JavaScript, you can append an option name to `data-bs-`, as in `data-bs-animation="{value}"`. Make sure to change the case type of the option name from "_camelCase_" to "_kebab-case_" when passing the options via data attributes. For example, use `data-bs-custom-class="beautifier"` instead of `data-bs-customClass="beautifier"`.
+
+As of Bootstrap 5.2.0, all components support an **experimental** reserved data attribute `data-bs-config` that can house simple component configuration as a JSON string. When an element has `data-bs-config='{"delay":0, "title":123}'` and `data-bs-title="456"` attributes, the final `title` value will be `456` and the separate data attributes will override values given on `data-bs-config`. In addition, existing data attributes are able to house JSON values like `data-bs-delay='{"show":0,"hide":150}'`.