diff --git a/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown-item/dropdown-item.component.ts b/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown-item/dropdown-item.component.ts index 93dd043f..5296f43d 100644 --- a/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown-item/dropdown-item.component.ts +++ b/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown-item/dropdown-item.component.ts @@ -45,7 +45,21 @@ export class ItDropdownItemComponent extends ItLinkComponent implements OnInit { @Input() iconPosition: 'left' | 'right' = 'right'; /** - * Dropdown mode + * Controls the CSS class applied to the inner link element of this dropdown item. + * + * - `'button'` (default): the item is styled as a standard dropdown entry (`dropdown-item` or `active`). + * + * - `'link'`: same visual as `'button'`; no additional CSS class is added. + * Use when the parent `` is in link mode. + * + * - `'nav'`: adds the `nav-link` class to the inner link, making the item suitable + * for navigation bars and headers. Typically set automatically by the parent + * `` when its own `mode` is `'nav'`. + * + * **Note:** you rarely need to set this manually — the parent `` component + * propagates its `mode` to all child items automatically. + * + * @default 'button' */ @Input() mode?: 'button' | 'link' | 'nav' = 'button'; diff --git a/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown/dropdown.component.ts b/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown/dropdown.component.ts index 428e9bbc..499bbd7d 100644 --- a/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown/dropdown.component.ts +++ b/projects/design-angular-kit/src/lib/components/core/dropdown/dropdown/dropdown.component.ts @@ -30,7 +30,22 @@ import { inputToBoolean } from '../../../../utils/coercion'; }) export class ItDropdownComponent extends ItAbstractComponent implements AfterViewInit, OnChanges { /** - * Dropdown mode + * Controls the rendering mode of the dropdown trigger element. + * + * - `'button'` (default): renders a `