OverlayMask

Beta

OverlayMask create a highlight area on some DOM element with overlay.

install	yarn add @clayui/core
version
use	import {OverlayMask} from '@clayui/core';

Example

import {Provider, Button, OverlayMask} from '@clayui/core';
import React, {useState} from 'react';

import '@clayui/css/lib/css/atlas.css';

export default function App() {
	const [visible, setVisible] = useState(false);

	return (
		<Provider spritemap="/public/icons.svg">
			<div className="p-4">
				<Button.Group spaced>
					<Button
						displayType="secondary"
						borderless
						onClick={() => setVisible(!visible)}
					>
						Open overlay
					</Button>
					<OverlayMask
						onClick={() => setVisible(false)}
						visible={visible}
					>
						<Button>Button</Button>
					</OverlayMask>
				</Button.Group>
			</div>
		</Provider>
	);
}

Introduction

Create a highlight area for some element in the DOM. The component can place the highlight automatically when passing a component with forwardRef support as children, it is also possible to set the highlighted area if there is no children component.

Area highlight

React component

There are two different ways to create the highlighted area for a component, this allows the component to determine the highlight area and keep updating when there is scroll on the page. The first, set the component as the component’s children.

<OverlayMask>
	<ClayButton>Button</ClayButton>
</OverlayMask>

Another option is for cases where it is not possible to define the component as the only child of the <OverlayMask />, define the children as a function and the ref object is passed via render props to add to the element that should get the highlight.

<OverlayMask>
	{(ref) => (
		<>
			<ClayButton>Button A</ClayButton>
			<ClayButton ref={ref}>Button B</ClayButton>
		</>
	)}
</OverlayMask>

Non-React component

The component can be controlled ie define a highlight area for a non-React element that is not managed by React, the difference is that you need to keep the area (bounds) updated if the page exists scroll.

const logo = document.body.querySelector('.logo');
const {height, width, x, y} = logo.getBoundingClientRect();

<OverlayMask
	defaultBounds={{
		height,
		width,
		x,
		y,
	}}
	visible
/>;

// or

const [bounds, setBounds] = useState({
	height: 0,
	width: 0,
	x: 0,
	y: 0,
});

useEffect(() => {}, []);

<OverlayMask bounds={bounds} onBoundsChange={setBounds} visible />;