adev/shared-docs/styles/docs/_code.scss - main - githubmirror/angular

adev/shared-docs/styles/docs/_code.scss
526 строк11 KB
Kam
fix(docs-infra): keep inline code in links as an atomic inline box
03 авг 2026, 19:20
03 авг 2026, 19:20efe1aae
$code-font-size: 0.875rem;

@mixin docs-theme {
  .docs-dark-mode .shiki {
    color: var(--shiki-dark);
    background-color: var(--shiki-dark-bg);

    span {
      color: var(--shiki-dark);
      background-color: var(--shiki-dark-bg);
      /* Optional, if you also want font styles */
      font-style: var(--shiki-dark-font-style);
      font-weight: var(--shiki-dark-font-weight);
    }

    .shiki-ln-line-highlighted,
    button:hover {
      span {
        background-color: inherit;
      }
    }
  }

  .shiki {
    &.cli {
      padding-inline-start: 1rem;
      padding-block: 1rem;
    }

    a {
      color: inherit;

      &:hover {
        text-decoration: underline;
      }
    }
  }

  .shiki.line.cli {
    span {
      color: var(--quaternary-contrast);
      font-family: var(--inter-font);
      font-weight: 600;
      font-size: 13px;
    }
  }

  .docs-light-mode .shiki {
    color: var(--shiki-light);
    background-color: var(--shiki-light-bg);

    span {
      color: var(--shiki-light);
      background-color: var(--shiki-light-bg);
      /* Optional, if you also want font styles */
      font-style: var(--shiki-light-font-style);
      font-weight: var(--shiki-light-font-weight);
    }

    .shiki-ln-line-highlighted,
    button:hover {
      span {
        background-color: inherit;
      }
    }
  }
}

@mixin docs-code-block {
  // code across docs, inline, blocks, shell, example viewer, etc.
  code {
    font-family: var(--code-font);
    border-radius: 0.25rem;
    font-weight: 400;
    // Create a new stacking context to allow for the psuedo element content to be placed behind the
    // text so that the text is properly selectable by the user.
    isolation: isolate;

    // Inline code only
    &:not(pre *) {
      position: relative;
      padding: 0 0.3rem;
      background: var(--subtle-purple);
      color: var(--hot-pink);
      max-width: max-content;
      border-radius: 0.25rem;
      width: 100%;

      a:not(.docs-anchor) > & {
        display: inline-block;
        position: relative;
        padding: 0 0.3rem;
        white-space: nowrap;
        background: var(--purple-to-blue-horizontal-gradient);
        background-clip: text;
        -webkit-background-clip: text;
        color: transparent;
        max-width: max-content;

        &::before {
          content: '';
          position: absolute;
          inset: 0;
          width: 100%;
          height: 100%;
          background: var(--subtle-purple);
          border-radius: 0.25rem;
          transition: background 0.3s ease;
          z-index: -1;
        }

        &:hover {
          background: var(--vivid-pink);
          background-clip: text;
          -webkit-background-clip: text;
          color: transparent;
          max-width: max-content;
        }
      }
    }

    // render inline code emjois without gradient
    .docs-emoji {
      color: initial;
    }
  }

  pre {
    white-space: pre;
  }

  // render inline code emjois without gradient
  .docs-emoji {
    color: inherit;
  }

  // docs-code shell, multifile, mermaid diagrams
  .docs-code {
    .docs-viewer & {
      margin-block: 1rem;
    }
    display: block;
    position: relative;
    border: 1px solid var(--senary-contrast);
    border-radius: 0.25rem;
    background: var(--octonary-contrast);
    overflow: hidden;
    transition:
      background 0.3s ease,
      border-color 0.3s ease;
    container: codeblock / inline-size;

    &.compact {
      code {
        max-height: 300px;
      }
    }

    &.embedded {
      border-width: 0;
      border-radius: 0;
    }

    &.docs-code-avoid {
      --style-color: var(--hot-red);
    }

    &.docs-code-prefer {
      --style-color: var(--symbolic-green);
    }
    &.docs-code-avoid,
    &.docs-code-prefer {
      border-color: color-mix(in srgb, var(--style-color) 40%, var(--senary-contrast));
    }
  }

  .shiki {
    code {
      width: 100%;
      overflow: auto;
      padding-block: 1rem;
      display: flex;
      flex-direction: column;
      font-size: $code-font-size;
      counter-reset: line;
    }

    &.compact {
      pre {
        max-height: 300px;
      }
    }
  }

  // shell doesn't have a header, for commands only
  .shell {
    pre {
      white-space: nowrap;
    }

    &:not([hideDollar]) {
      .shiki {
        .line:not(:empty)::before {
          content: '$';
          padding-inline-end: 0.5rem;
        }
      }
    }

    .shiki {
      .line {
        display: block;

        &.hidden {
          display: none;
        }
      }
    }
  }

  // copy code button
  button[docs-copy-source-code] {
    padding: 0.375rem 0.4rem 0.15rem 0.5rem;
    position: absolute;
    top: 3.1rem;
    right: 0.2rem;
    border-radius: 0.25rem;
    cursor: pointer;
    z-index: var(--z-index-icon);
    opacity: 0;
    pointer-events: none;
    background-color: var(--octonary-contrast);
    border: 1px solid var(--senary-contrast);
    transition:
      background-color 0.3s ease,
      border-color 0.3s ease,
      opacity 0.3s ease;

    .docs-icon {
      transition: opacity 0.3s ease-out;
    }
    .docs-copy {
      opacity: 1;
      path {
        transition: fill 0.3s ease;
        fill: var(--quaternary-contrast);
      }
    }
    .docs-check {
      opacity: 0;
      color: var(--primary-contrast);
      position: absolute;
      inset: 0;
      top: 0.35rem;
      path {
        transition: fill 0.3s ease;
      }
    }

    &.docs-copy-source-code-button-success {
      opacity: 1;
      pointer-events: auto;

      .docs-copy {
        opacity: 0;
      }
      .docs-check {
        opacity: 1;
      }
    }

    &:hover {
      .docs-copy {
        path {
          fill: var(--primary-contrast);
        }
      }
    }
  }

  .docs-code:hover,
  .docs-code:focus-within,
  .docs-example-viewer-code-wrapper:hover,
  .docs-example-viewer-code-wrapper:focus-within {
    > button[docs-copy-source-code] {
      opacity: 1;
      pointer-events: auto;
    }
  }

  button[docs-copy-source-code]:focus-visible,
  button[docs-copy-source-code].docs-copy-source-code-button-failed {
    opacity: 1;
    pointer-events: auto;
  }

  .docs-code:has(.docs-code-header) {
    button[docs-copy-source-code] {
      top: 0.26rem;
    }

    .docs-code-header {
      padding-inline-end: 3rem;
    }
  }

  .docs-code .docs-code-header {
    position: relative;
    h3 {
      background-image: var(--purple-to-blue-horizontal-gradient);
      background-clip: text;
      -webkit-background-clip: text;
      color: transparent;
      font-size: $code-font-size;
      font-style: normal;
      font-weight: 400;
      line-height: 1.4rem;
      letter-spacing: -0.00875rem;
      margin: 0;
      word-wrap: break-word;
      width: fit-content;
    }
  }

  .docs-code-header {
    display: flex;
    align-items: center;
    box-sizing: border-box;
    height: 2.9rem;
    padding: 0.75rem;

    background: var(--subtle-purple);
    border-radius: 0.25rem 0.25rem 0 0;
    transition: background 0.3s ease;

    .docs-code-avoid &,
    .docs-code-prefer & {
      background: color-mix(in srgb, var(--style-color) 15%, var(--octonary-contrast));
      box-shadow: inset 0 -1px 0 color-mix(in srgb, var(--style-color) 35%, transparent);
      h3 {
        color: color-mix(in srgb, var(--style-color) 60%, var(--primary-contrast));
        font-weight: 700;
      }
    }

    .docs-code-header-style {
      display: inline-flex;
      align-items: center;
      gap: 0.4rem;
      padding: 0.25rem 0.6rem;
      border-radius: 6px;
      background: color-mix(in srgb, var(--style-color) 20%, transparent);
      font-size: 0.72rem;
      font-weight: 600;
      text-transform: uppercase;
      letter-spacing: 0.03em;
      color: color-mix(in srgb, var(--style-color) 55%, var(--primary-contrast));

      &:not(:last-child) {
        margin-inline-end: 0.7rem;
      }

      &::before {
        color: var(--style-color);
        font-family: var(--icons);
        font-size: 0.9rem;
        letter-spacing: normal;
        text-transform: none;
      }
    }

    .docs-code-header-style {
      .docs-code-prefer & {
        &::before {
          content: 'check';
        }
      }
    }

    .docs-code-header-style {
      .docs-code-avoid & {
        &::before {
          content: 'close';
        }
      }
    }
  }

  // Single line docs-code elements, without headers, shell code
  .docs-code:not(:has(.docs-code-header)) {
    button[docs-copy-source-code] {
      top: 0.2rem;
      right: 0.2rem;
    }
  }

  .docs-code[mermaid] {
    border: 0;
    width: 100%;
    background-color: transparent;
  }

  // Line numbers styling: Add a grid, if there are line numbers
  .docs-code:not([mermaid]),
  .docs-example-viewer-code-wrapper {
    code:has(.shiki-ln-number) {
      display: grid;
      grid-template-columns: min-content 1fr;
      height: 100%;
    }

    pre {
      display: flex;
      flex-direction: column;
      align-items: start;
    }
  }

  .docs-example-viewer-code-wrapper {
    .docs-code-header {
      display: none;
    }
  }

  .shiki {
    .shiki-ln-number.shiki-ln-number.shiki-ln-number {
      border-inline-end: 1px solid var(--senary-contrast);
      padding-inline-start: 0.75rem;
      padding-inline-end: 0.5rem;
      color: var(--quaternary-contrast);
      font-size: $code-font-size;
      text-align: right;
      padding-block: 0.25rem;
    }

    .line {
      &.highlighted {
        background-color: color-mix(in srgb, var(--bright-blue) 9%, var(--page-background));
        color: color-mix(in srgb, var(--bright-blue) 60%, var(--full-contrast));

        span {
          background-color: inherit;
        }
      }
    }

    .hidden {
      display: none;
    }
  }
}

@mixin docs-syntax-highlighting {
  .shiki .line {
    min-height: 1.375em;
    padding-inline: 1rem;
    color: var(--tertiary-contrast);
    display: block;
    font-size: $code-font-size;
    font-family: var(--code-font);
    font-weight: 400;
    text-align: left;
    padding-block: 0.25rem;

    &.hidden {
      display: none;
    }

    // Hide the last line if it's empty
    &:last-child:empty {
      display: none;
    }

    span:last-child {
      margin-inline-end: 4rem;
    }
  }

  .shiki-ln-group {
    display: flex;
    flex-direction: column;
    margin: 1rem 0;
  }

  .shiki-deprecated {
    text-decoration: line-through;
  }

  .gap {
    color: var(--quaternary-contrast);
  }

  .hljs-constructor {
    color: var(--symbolic-cyan);
  }

  .hljs-params {
    color: var(--bright-blue);
  }
}

@mixin docs-code-editor {
  .cm-tooltip-hover {
    display: flex;
    flex-direction: column-reverse;
    padding: 0.75rem;

    &::-webkit-scrollbar-track {
      background: rgba(0, 0, 0, 0);
    }

    &::-webkit-scrollbar {
      width: 6px;
      height: 6px;
    }

    &::-webkit-scrollbar-thumb {
      background-color: var(--senary-contrast);
      border-radius: 10px;
    }

    &::-webkit-scrollbar-thumb:hover {
      background-color: var(--quinary-contrast);
    }
  }
}