@elastic/eui/es/services/container_query/container_query_hook.js

Elastic UI Component Library

function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
/*
 * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
 * or more contributor license agreements. Licensed under the Elastic License
 * 2.0 and the Server Side Public License, v 1; you may not use this file except
 * in compliance with, at your election, the Elastic License 2.0 or the Server
 * Side Public License, v 1.
 */

import { useEffect, useState, useRef } from 'react';
import { matchContainer } from './match_container';

/**
 * React hook that subscribes to CSS container query changes.
 *
 * For this to work:
 * - a proper container (an element with e.g. `container-type: inline-size`) is needed, and
 * - the container MUST to be a parent of the element being observed
 *
 * @param containerCondition - A CSS `<container-condition>` string, e.g. `(width > 400px)` or `(min-width: 600px)`
 * @param name - Optional container name, e.g. `sidebar`
 * @returns An object containing:
 *   - `ref`: A ref to attach to the container element
 *   - `matches`: `true` if the container matches the condition, `false` otherwise
 *
 * @example
 * ```tsx
 * const { ref, matches } = useEuiContainerQuery('(width > 400px)');
 * return <div ref={ref}>{matches ? 'Wide' : 'Narrow'}</div>;
 * ```
 *
 * @see {@link https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@container | MDN: @container}
 * @beta
 */
export function useEuiContainerQuery(containerCondition, name) {
  var containerQueryString = name ? "".concat(name, " ").concat(containerCondition) : containerCondition;
  var ref = useRef(null);
  var _useState = useState(false),
    _useState2 = _slicedToArray(_useState, 2),
    matches = _useState2[0],
    setMatches = _useState2[1];
  useEffect(function () {
    if (!ref.current) return;
    var queryList = matchContainer(ref.current, containerQueryString);
    var handleChange = function handleChange() {
      setMatches(queryList.matches);
    };
    setMatches(queryList.matches);
    queryList.addEventListener('change', handleChange);
    return function () {
      queryList.removeEventListener('change', handleChange);
      queryList.dispose();
    };
  }, [ref, containerQueryString]);
  return {
    ref: ref,
    matches: matches
  };
}