diff --git a/packages/documentation/docs/design-kit/design-kit.md b/packages/documentation/docs/design-kit/design-kit.md index 8b8afea3bc..ed93a97c2a 100644 --- a/packages/documentation/docs/design-kit/design-kit.md +++ b/packages/documentation/docs/design-kit/design-kit.md @@ -17,6 +17,7 @@ The Siemens brand library contains Siemens specific brand elements and is only a › [Get more information here](https://siemens-ix.code.siemens.io/ix-brand-theme/) +We leverage the power of Figma tokens to provide you with a seamless and customizable experience when working with our themes. For detailed instructions on how to modify theme variables and select themes using the Figma Siemens Brand library, please visit the [Theme Switching](../guidelines/theme-switching.md) page. Discover the ease and flexibility of designing in Figma with Siemens Industrial Experience. ## Figma classic theme library (Open Source) Will be available soon. diff --git a/packages/documentation/docs/guidelines/_theme-switching_code.md b/packages/documentation/docs/guidelines/_theme-switching_code.md new file mode 100644 index 0000000000..7af341d271 --- /dev/null +++ b/packages/documentation/docs/guidelines/_theme-switching_code.md @@ -0,0 +1,15 @@ +import { ApiTableSinceTag } from '@site/src/components/ApiTableTag'; +import PlaygroundV2 from '@site/src/components/PlaygroundV2'; + +# Theme switching + +## Working with themes during runtime + + + + + diff --git a/packages/documentation/docs/guidelines/_theme-switching_styleguide.md b/packages/documentation/docs/guidelines/_theme-switching_styleguide.md new file mode 100644 index 0000000000..0056bec631 --- /dev/null +++ b/packages/documentation/docs/guidelines/_theme-switching_styleguide.md @@ -0,0 +1,33 @@ +# Changing Theme Variables + +![Changing theme variables](https://www.figma.com/file/wEptRgAezDU1z80Cn3eZ0o/iX-Pattern-Illustrations?type=design&node-id=2232-101&mode=design&t=C6IjeY71MP4uA7vZ-4) + +Follow these steps to modify the colors and other values of a theme within the Figma Siemens Brand library: + +1. Import the "iX Foundation Brand" file into your Figma workspace. +2. In the top-right corner of the Figma interface, you'll find a button labeled "Open settings" with a settings icon. Click on it to open the variables dialog. +3. Within the variables dialog, navigate to the desired collection, such as the "iX Colors" collection located at the top-left corner. +4. From there, you can easily change the values of the variables to adjust the appearance of the theme. + +The different themes are organized into columns, allowing you to switch between them effortlessly. + +# Selecting a Theme for Designing + +When working with the Figma Siemens Brand library, you can apply a theme to either an entire page or an individual element, such as a frame or component: + +![Applying a theme](https://www.figma.com/file/wEptRgAezDU1z80Cn3eZ0o/iX-Pattern-Illustrations?type=design&node-id=2232-192&mode=design&t=C6IjeY71MP4uA7vZ-4) +## Applying a Theme to a whole Page + +Ensure that no elements are selected on the page. If any elements are selected, press the "Esc" key to deselect them. +1. In the right panel, you'll find a button with a hexagon symbol on the right side of the "Page" section. Click on it to open the theme selection dropdown. +2. From the dropdown, you can select the desired theme colors to apply them to the entire page. + +## Applying a Theme to an Element + +Select the specific element, such as a frame or component, to which you want to apply a theme. +1. In the right panel, you'll find a button with a hexagon symbol on the right side of the "Layer" section. Click on it to open the theme selection dropdown. +2. From the dropdown, you can choose the desired theme colors to apply them to the selected element. + +Remember, when you apply a theme to an individual element, it will override the page-level theme. + +For more information see the official [Figma documentation](https://help.figma.com/hc/en-us/articles/15339657135383-Guide-to-variables-in-Figma). \ No newline at end of file diff --git a/packages/documentation/docs/guidelines/theme-switching.md b/packages/documentation/docs/guidelines/theme-switching.md index 67458d273f..fa79f6f780 100644 --- a/packages/documentation/docs/guidelines/theme-switching.md +++ b/packages/documentation/docs/guidelines/theme-switching.md @@ -1,18 +1,12 @@ --- sidebar_position: 2 --- -import { ApiTableSinceTag } from '@site/src/components/ApiTableTag'; -import PlaygroundV2 from '@site/src/components/PlaygroundV2'; -# Theme switching +import DocsTabs from '@site/src/components/DocsTabs'; -## Working with themes during runtime +import DocsUx from './\_theme-switching_styleguide.md'; +import DocsCode from './\_theme-switching_code.md'; - +# Theme Switching - - +