@ui5/webcomponents-react
Version:
React Wrapper for UI5 Web Components and additional components
158 lines (157 loc) • 11.6 kB
TypeScript
import '@ui5/webcomponents-fiori/dist/DynamicPageTitle.js';
import type { CommonProps, Ui5DomRef, UI5WCSlotsNode } from '@ui5/webcomponents-react-base';
import type { ReactNode } from 'react';
interface DynamicPageTitleAttributes {
}
interface DynamicPageTitleDomRef extends Required<DynamicPageTitleAttributes>, Ui5DomRef {
}
interface DynamicPageTitlePropTypes extends DynamicPageTitleAttributes, Omit<CommonProps, 'actionsBar' | 'breadcrumbs' | 'children' | 'heading' | 'navigationBar' | 'snappedHeading' | 'snappedSubheading' | 'snappedTitleOnMobile' | 'subheading'> {
/**
* Defines the bar with actions in the Dynamic page title.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="actionsBar"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
actionsBar?: UI5WCSlotsNode;
/**
* Defines the content of the breadcrumbs inside Dynamic Page Title.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="breadcrumbs"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
breadcrumbs?: UI5WCSlotsNode;
/**
* Defines the content of the Dynamic page title.
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
children?: ReactNode | ReactNode[];
/**
* Defines the content of the Heading of the Dynamic Page.
*
* The font size of the title within the `heading` slot can be adjusted to the recommended values using the following CSS variables:
*
* **Expanded:** `var(--sapObjectHeader_Title_FontSize)`
*
* **Collapsed:** `var(--sapObjectHeader_Title_SnappedFontSize)`
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="heading"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
heading?: UI5WCSlotsNode;
/**
* Defines the bar with navigation actions in the Dynamic page title.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="navigationBar"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<Toolbar>`
*/
navigationBar?: UI5WCSlotsNode;
/**
* Defines the heading that is shown only when the header is snapped.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="snappedHeading"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
snappedHeading?: UI5WCSlotsNode;
/**
* Defines the content of the title that is shown only when the header is snapped.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="snappedSubheading"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
snappedSubheading?: UI5WCSlotsNode;
/**
* Defines the content of the snapped title on mobile devices.
*
* This slot is displayed only when the `DynamicPageTitle` is in the snapped state on mobile devices.
* It should be used to provide a simplified, single-line title that takes up less space on smaller screens.
*
* **Note:**
* - The content set in this slot **overrides** all other content set in the `DynamicPageTitle` slots when displayed.
* - The slot is intended for a single `ui5-title` component.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="snappedTitleOnMobile"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* **Note:** Available since [v2.3.0](https://github.com/UI5/webcomponents/releases/tag/v2.3.0) of **@ui5/webcomponents-fiori**.
*
* __Supported Node Type/s:__ `Array<Title>`
*/
snappedTitleOnMobile?: UI5WCSlotsNode;
/**
* Defines the content of the title that is shown only when the header is not snapped.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="subheading"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*
* __Supported Node Type/s:__ `Array<HTMLElement>`
*/
subheading?: UI5WCSlotsNode;
}
/**
* Title of the `DynamicPage`.
*
* The `DynamicPageTitle` component is part of the `DynamicPage`
* family and is used to serve as title of the `DynamicPage`.
*
* ### Usage
*
* The `DynamicPageTitle` can hold any component and displays the most important
* information regarding the object that will always remain visible while scrolling.
*
* **Note:** The `actions` slot accepts any UI5 web component, but it's
* recommended to use `ui5-toolbar`.
*
* The user can switch between the expanded/collapsed states of the
* `DynamicPage` by clicking on the `DynamicPageTitle`
* or by using the expand/collapse visual indicators, positioned at the bottom of the
* `DynamicPageTitle` and the `DynamicPageHeader` inside `DynamicPageHeaderActions`.
*
* ### Responsive Behavior
*
* The responsive behavior of the `DynamicPageTitle` depends on the behavior of the
* content that is displayed.
*
* __Note:__ This is a UI5 Web Component! [DynamicPageTitle UI5 Web Component Documentation](https://ui5.github.io/webcomponents/components/fiori/DynamicPageTitle) | [Repository](https://github.com/UI5/webcomponents)
*
* @since [2.0.0](https://github.com/UI5/webcomponents/releases/tag/v2.0.0) of __@ui5/webcomponents-fiori__.
*/
declare const DynamicPageTitle: import("react").ForwardRefExoticComponent<DynamicPageTitlePropTypes & import("@ui5/webcomponents-react-base").WithWebComponentPropTypes & import("react").RefAttributes<DynamicPageTitleDomRef>>;
export { DynamicPageTitle };
export type { DynamicPageTitleDomRef, DynamicPageTitlePropTypes };