dap-design-system 0.57.10 → 0.57.11

package/dist/components/sidenav/sidenav.component.d.ts

@@ -1,5 +1,10 @@
 import { PropertyValueMap } from 'lit';
 import { DdsElement } from '../../internal/dds-hu-element';
+declare const LANDMARK_TAGS: {
+    readonly aside: import('lit-html/static.js').StaticValue;
+    readonly nav: import('lit-html/static.js').StaticValue;
+};
+export type SideNavLandmark = keyof typeof LANDMARK_TAGS;
 /**
  * `dap-ds-sidenav`
  * @summary Side navigation is a list of links that are used to navigate to different sections of a page.
@@ -20,6 +25,18 @@ export default class DapDSSideNav extends DdsElement {
     activeHref: string;
     /** The size of the side navigation */
     size: 'xs' | 'sm' | 'lg';
+    /**
+     * The landmark element to render. `aside` exposes a complementary landmark; `nav`
+     * exposes a navigation landmark, so the sidenav is listed when a screen-reader user
+     * asks for the page's navigation.
+     *
+     * Defaults to `aside` because that is what this component has always rendered, and
+     * changing the landmark of every existing sidenav is not this component's call: a
+     * sidenav that is genuinely a sidebar should stay complementary. Set `nav` when the
+     * sidenav is the primary way to move around the view.
+     * @type {'aside' | 'nav'}
+     */
+    landmark: SideNavLandmark;
     static readonly styles: import('lit').CSSResult;
     protected firstUpdated(_changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
     attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
@@ -28,3 +45,4 @@ export default class DapDSSideNav extends DdsElement {
     private handleClick;
     render(): import('lit-html').TemplateResult;
 }
+export {};