SafeSpace

Implementations

The component SafeSpace is available in the following technologies:

CSS Components

Web Components

Native

Parameters

Parameters

Make sure you have read about the parameters in here.

The parametrization of the component can be done with the following custom params or properties:

Name	Type	Slot	Description
config	string		The main parameter has two components following the pattern: <zLetterSize><?:size> where: zLetterSize: [number] defines the size of the letter inside the safe space. Possible values are: 2, 3, 4, 5. size: [number] defines the size of the safe space. Possible values are: 20, 25, 30, 35, 40, 45, 50 (rem).
image-src	string	✅	The image-src is the URL of the image to be used.
image-alt	string		Alternative text for image accessibility
cross-origin	string		The crossorigin attribute of the image. Provides support for CORS, defining how the element handles cross-origin requests, thereby enabling the configuration of the CORS requests for the element's fetched data.
custom	object		A record of key-value pairs to set the CSS custom tokens. It's a complex attribute set as an JS object in stringified JSON format. Example: <z-safe-space custom='{"fill":"#06e7a3"}' /> Check the available values in the customization section.
custom-str	string		The stringified version of the custom property. It follows the pattern key:value;key:value;, with the possibility of setting multiple values and spaces between the punctuation characters. Example: <z-safe-space custom-str="fill:#06e7a3" />
z-theme	string		Sets the theme of the component. The possible values are light and dark. <z-safe-space z-theme="dark" />

From Figma to code

You can check the Figma implementation here. The components is separated into two components:

• Safe space/Solid
• Safe space/Photo

Both share the same properties:

• Proportion select
• Size select

Customization

INFO

Check everything about the customization mechanics in the "How it works" documentation.

CSS Variable	Type	Description
--z-safe-space--bg	color	Background color
--z-safe-space--size	distance	Size of Safe Space
--z-safe-space--image-x	distance	Image x adjustment
--z-safe-space--image-y	distance	Image Y adjustment

The background color is customizable using the --z-safe-space--bg CSS custom property.

The size of the safe space can also be customized using the --z-safe-space--size CSS custom property.

You can determine the x and y position of the image inside the safe space using the --z-safe-space--image-x and --z-safe-space--image-y CSS custom properties.

Related components