superset-frontend/packages/superset-ui-core/src/components/Loading/index.tsx

/**
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

import cls from 'classnames';
import { styled, useTheme } from '@apache-superset/core/ui';
import { Loading as LoaderSvg } from '../assets';
import type { LoadingProps, SizeOption } from './types';

const SIZE_MAP: Record<SizeOption, string> = {
  s: '40px',
  m: '70px',
  l: '100px',
};

const LoaderWrapper = styled.div<{
  $spinnerWidth: string;
  $spinnerHeight: string;
  $opacity: number;
}>`
  z-index: 99;
  width: ${({ $spinnerWidth }) => $spinnerWidth};
  height: ${({ $spinnerHeight }) => $spinnerHeight};
  opacity: ${({ $opacity }) => $opacity};
  position: relative;
  margin: 0;
  padding: 0;

  & > svg,
  & > img {
    width: 100%;
    height: 100%;
  }

  &.inline-centered {
    margin: 0 auto;
    display: flex;
    align-items: center;
    justify-content: center;
  }
  &.floating {
    position: absolute;
    left: 50%;
    top: 50%;
    transform: translate(-50%, -50%);
  }
`;
export function Loading({
  position = 'floating',
  image,
  className,
  size = 'm',
  muted = false,
}: LoadingProps) {
  const theme = useTheme();

  // Determine size from size prop
  const spinnerSize = SIZE_MAP[size];

  // Opacity - muted reduces to 0.25, otherwise full opacity
  const opacity = muted ? 0.25 : 1.0;

  // Render spinner content
  const renderSpinner = () => {
    // Precedence: explicit image prop > brandSpinnerSvg > brandSpinnerUrl > default SVG
    if (image) {
      return <img src={image} alt="Loading..." />;
    }
    if (theme.brandSpinnerSvg) {
      const svgDataUri = `data:image/svg+xml;base64,${btoa(theme.brandSpinnerSvg)}`;
      return <img src={svgDataUri} alt="Loading..." />;
    }
    if (theme.brandSpinnerUrl) {
      return <img src={theme.brandSpinnerUrl} alt="Loading..." />;
    }
    // Default: use the imported SVG component
    return <LoaderSvg />;
  };

  return (
    <LoaderWrapper
      $spinnerWidth={spinnerSize}
      $spinnerHeight="auto"
      $opacity={opacity}
      className={cls('loading', position, className)}
      role="status"
      aria-live="polite"
      aria-label="Loading"
      data-test="loading-indicator"
    >
      {renderSpinner()}
    </LoaderWrapper>
  );
}

export type { LoadingProps };