diff --git a/docs/reference/glossary.md b/docs/reference/glossary.md index 110d5514beb..b0480f64c53 100644 --- a/docs/reference/glossary.md +++ b/docs/reference/glossary.md @@ -67,6 +67,31 @@ title: Glossary

+
+ +

Bubbling

+
+

+ Bubbling is a way of propagating events in the DOM. With bubbling, the event is first captured by the innermost + element and then propagated upwards. +

+

+ Many Ionic components emit events of the same name that also bubble. For example, ionChange is an event + emitted by several components such as ion-radio-group, ion-input, and more. Developers can + check the target property on the event to see the component that the event originated from. +

+

+ See{' '} + + MDN's Introduction to events guide + {' '} + for more information on bubbling. +

+
+

Bundling

diff --git a/plugins/docusaurus-plugin-ionic-component-api/index.js b/plugins/docusaurus-plugin-ionic-component-api/index.js index 21578910eda..68eae58eed0 100644 --- a/plugins/docusaurus-plugin-ionic-component-api/index.js +++ b/plugins/docusaurus-plugin-ionic-component-api/index.js @@ -168,7 +168,7 @@ function renderEvents({ events }) { } return ` -| Name | Description | Bubbles | +| Name | Description | [Bubbles](../reference/glossary#bubbling) | | --- | --- | --- | ${events.map((event) => `| \`${event.event}\` | ${formatMultiline(event.docs)} | \`${event.bubbles}\` |`).join('\n')}`; }