@papillonbits/css 1.4.0 → 1.5.0

package/build/primer/forms/README.md

@@ -0,0 +1,20 @@
+---
+bundle: "forms"
+generated: true
+---
+
+# Primer CSS: `forms` bundle
+
+## Usage
+
+Primer CSS source files are written in [SCSS]. To include this Primer CSS module in your own build, ensure that your `node_modules` directory is listed in your Sass include paths, then import it with:
+
+```scss
+@import "@primer/css/forms/index.scss";
+```
+
+## Build
+
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/forms.css`.
+
+[scss]: https://sass-lang.com/documentation/syntax#scss

package/build/primer/forms/form-control.scss

@@ -0,0 +1,286 @@
+// Needs refactoring
+// stylelint-disable selector-no-qualifying-type, selector-max-compound-selectors
+// stylelint-disable selector-max-type
+// Base form controls
+//
+// Overrides for common inputs for easier styling.
+
+.form-control,
+.form-select {
+  // stylelint-disable-next-line primer/spacing
+  padding: 5px 12px;
+  // stylelint-disable-next-line primer/typography
+  font-size: $body-font-size;
+  // stylelint-disable-next-line primer/typography
+  line-height: 20px;
+  color: var(--fgColor-default, var(--color-fg-default));
+  vertical-align: middle;
+  background-color: var(--bgColor-default, var(--color-canvas-default));
+  background-repeat: no-repeat; // Repeat and position set for form states (success, error, etc)
+  background-position: right 8px center; // For form validation. This keeps images 8px from right and centered vertically.
+  // stylelint-disable-next-line primer/borders, primer/colors
+  border: $border-width $border-style var(--control-borderColor-rest, var(--color-border-default));
+  // stylelint-disable-next-line primer/borders
+  border-radius: $border-radius;
+  box-shadow: var(--shadow-inset, var(--color-primer-shadow-inset));
+  transition: 80ms cubic-bezier(0.33, 1, 0.68, 1);
+  transition-property: color, background-color, box-shadow, border-color;
+
+  &:focus {
+    @include focusBoxShadowInset;
+
+    // remove fallback :focus if :focus-visible is supported
+    &:not(:focus-visible) {
+      border-color: transparent;
+
+      @include focusBoxShadowInset(1px, transparent);
+    }
+  }
+
+  // default focus state
+  &:focus-visible {
+    @include focusBoxShadowInset;
+  }
+
+  // override form controls with no border in focused state
+  &.border-0 {
+    &:focus,
+    &:focus-visible {
+      // stylelint-disable-next-line primer/borders, primer/colors
+      border: $border-width $border-style var(--borderColor-accent-emphasis, var(--color-accent-fg)) !important;
+    }
+  }
+
+  &[disabled],
+  fieldset[disabled] & {
+    color: var(--control-fgColor-disabled, var(--color-primer-fg-disabled));
+    background-color: var(--control-bgColor-disabled, var(--color-input-disabled-bg));
+    border-color: var(--control-borderColor-disabled, var(--color-border-default));
+    -webkit-text-fill-color: var(--control-fgColor-disabled, var(--color-primer-fg-disabled)); // Fix for Safari
+    opacity: 1; // Fix for Safari iOS
+
+    &::placeholder {
+      color: var(--control-fgColor-disabled, var(--color-primer-fg-disabled));
+    }
+  }
+
+  // Ensures inputs don't zoom on mobile iPhone but are body-font size on iPad
+  @supports (-webkit-touch-callout: none) {
+    // stylelint-disable-next-line primer/typography
+    font-size: $h4-size;
+
+    @include breakpoint(md) {
+      // stylelint-disable-next-line primer/typography
+      font-size: $body-font-size;
+    }
+  }
+}
+
+// Textarea
+textarea.form-control {
+  padding-top: var(--base-size-8);
+  padding-bottom: var(--base-size-8);
+  // stylelint-disable-next-line primer/typography
+  line-height: $lh-default;
+}
+
+// Inputs with contrast for easy light gray backgrounds against white.
+.input-contrast {
+  background-color: var(--bgColor-muted, var(--color-canvas-inset));
+
+  &:focus {
+    background-color: var(--bgColor-default, var(--color-canvas-default));
+  }
+}
+
+// Mini inputs, to match .minibutton
+.input-sm {
+  min-height: $size-4;
+  // stylelint-disable-next-line primer/spacing
+  padding-top: 3px;
+  // stylelint-disable-next-line primer/spacing
+  padding-bottom: 3px;
+  // stylelint-disable-next-line primer/typography
+  font-size: $font-size-small;
+  // stylelint-disable-next-line primer/typography
+  line-height: 20px;
+}
+
+// Large inputs
+.input-lg {
+  // stylelint-disable-next-line primer/typography
+  font-size: $h4-size;
+}
+
+// Full-width inputs
+.input-block {
+  display: block;
+  width: 100%;
+}
+
+// Inputs with monospace text
+.input-monospace {
+  // stylelint-disable-next-line primer/typography
+  font-family: $mono-font;
+}
+
+// Hide the icon that tries to autofill contact info in webkit
+.input-hide-webkit-autofill {
+  &::-webkit-contacts-auto-fill-button {
+    position: absolute;
+    right: 0;
+    display: none !important;
+    pointer-events: none;
+    visibility: hidden;
+  }
+}
+
+// Checkboxes and Radiobuttons
+//
+// For checkboxes and radio button selections.
+.form-checkbox {
+  // stylelint-disable-next-line primer/spacing
+  padding-left: 20px;
+  // stylelint-disable-next-line primer/spacing
+  margin: 15px 0;
+  vertical-align: middle;
+
+  label {
+    em.highlight {
+      position: relative;
+      left: calc(var(--base-size-4) * -1);
+      // stylelint-disable-next-line primer/spacing
+      padding: 2px var(--base-size-4);
+      font-style: normal;
+      background: var(--bgColor-attention-muted, var(--color-attention-subtle));
+      // stylelint-disable-next-line primer/borders
+      border-radius: $border-radius;
+    }
+  }
+
+  input[type='checkbox'],
+  input[type='radio'] {
+    float: left;
+    // stylelint-disable-next-line primer/spacing
+    margin: 5px 0 0 -20px;
+    vertical-align: middle;
+  }
+
+  .note {
+    display: block;
+    margin: 0;
+    // stylelint-disable-next-line primer/typography
+    font-size: $font-size-small;
+    // stylelint-disable-next-line primer/typography
+    font-weight: $font-weight-normal;
+    color: var(--fgColor-muted, var(--color-fg-muted));
+  }
+}
+
+.form-checkbox-details {
+  display: none;
+}
+
+.form-checkbox-details-trigger {
+  &:checked {
+    // child of sibling or sibling
+    ~ * .form-checkbox-details,
+    ~ .form-checkbox-details {
+      display: block;
+    }
+  }
+}
+
+// Field groups
+//
+// Wrap field groups in `<div.hfields>` to lay them out horizontally - great for
+// the top of pages with autosave.
+.hfields {
+  // stylelint-disable-next-line primer/spacing
+  margin: 15px 0;
+
+  @include clearfix;
+
+  .form-group {
+    float: left;
+    // stylelint-disable-next-line primer/spacing
+    margin: 0 30px 0 0;
+
+    dt, // TODO: Deprecate
+    .form-group-header {
+      label {
+        display: inline-block;
+        // stylelint-disable-next-line primer/spacing
+        margin: 5px 0 0;
+        color: var(--fgColor-muted, var(--color-fg-muted));
+      }
+
+      img {
+        position: relative;
+        // stylelint-disable-next-line primer/spacing
+        top: -2px;
+      }
+    }
+  }
+
+  .btn {
+    float: left;
+    // stylelint-disable-next-line primer/spacing
+    margin: 28px 25px 0 -20px;
+  }
+
+  .form-select {
+    // stylelint-disable-next-line primer/spacing
+    margin-top: 5px;
+  }
+}
+
+// Hide the up/down buttons in <input type="number"> in the login form, the
+// input is used for two-factor auth codes, type="number" makes it more usable
+// on phones
+input::-webkit-outer-spin-button,
+input::-webkit-inner-spin-button {
+  margin: 0;
+  appearance: none;
+}
+
+// Input groups
+
+.form-actions {
+  @include clearfix;
+
+  .btn {
+    float: right;
+
+    + .btn {
+      // stylelint-disable-next-line primer/spacing
+      margin-right: 5px;
+    }
+  }
+}
+
+.form-warning {
+  // stylelint-disable-next-line primer/spacing
+  padding: var(--base-size-8) 10px;
+  // stylelint-disable-next-line primer/spacing
+  margin: 10px 0;
+  // stylelint-disable-next-line primer/typography
+  font-size: $h5-size;
+  color: var(--fgColor-attention, var(--color-attention-fg));
+  background: var(--bgColor-attention-muted, var(--color-attention-subtle));
+  // stylelint-disable-next-line primer/borders, primer/colors
+  border: $border-width $border-style var(--borderColor-attention-emphasis, var(--color-attention-emphasis));
+  // stylelint-disable-next-line primer/borders
+  border-radius: $border-radius;
+
+  p {
+    margin: 0;
+    // stylelint-disable-next-line primer/typography
+    line-height: $lh-default;
+  }
+
+  a {
+    // stylelint-disable-next-line primer/typography
+    font-weight: $font-weight-bold;
+  }
+}

package/build/primer/forms/form-group.scss

@@ -0,0 +1,297 @@
+// stylelint-disable selector-max-compound-selectors
+// stylelint-disable selector-max-type
+
+// Form groups
+//
+// Usage:
+//
+// <div class="form-group">
+//   <div class="form-group-header"> containing the label
+//   <div class="form-group-body"> containing the form elements
+// </div>
+
+.form-group {
+  // stylelint-disable-next-line primer/spacing
+  margin: 15px 0;
+
+  // Autocomplete with embedded icon
+  .form-control.autocomplete-embedded-icon-wrap {
+    &:focus-within {
+      background-color: var(--bgColor-default, var(--color-canvas-default));
+    }
+  }
+
+  // Text fields
+  .form-control {
+    // stylelint-disable-next-line primer/responsive-widths
+    width: 440px;
+    max-width: 100%;
+    // stylelint-disable-next-line primer/spacing
+    margin-right: 5px;
+    background-color: var(--bgColor-muted, var(--color-canvas-inset));
+
+    &:focus {
+      background-color: var(--bgColor-default, var(--color-canvas-default));
+    }
+
+    &.shorter {
+      width: 130px;
+    }
+
+    &.short {
+      width: 250px;
+    }
+
+    &.input-block,
+    &.long {
+      width: 100%;
+    }
+  }
+
+  // Textarea
+  // stylelint-disable selector-no-qualifying-type
+  textarea.form-control {
+    width: 100%;
+    height: 200px;
+    min-height: 200px;
+
+    &.short {
+      height: 50px;
+      min-height: 50px;
+    }
+  }
+  // stylelint-enable selector-no-qualifying-type
+
+  // The Label
+  dt, // TODO: Deprecate
+  .form-group-header {
+    // stylelint-disable-next-line primer/spacing
+    margin: 0 0 6px;
+  }
+
+  label {
+    // fix for chrome bug, see https://github.com/github/github/issues/53931
+    position: static;
+  }
+
+  &.flattened dt, // TODO: Deprecate
+  &.flattened .form-group-header {
+    float: left;
+    margin: 0;
+    // stylelint-disable-next-line primer/typography
+    line-height: 32px;
+  }
+
+  &.flattened dd, // TODO: Deprecate
+  &.flattened .form-group-body {
+    // stylelint-disable-next-line primer/typography
+    line-height: 32px;
+  }
+
+  //
+  // Form Elements
+  //
+  // stylelint-disable selector-no-qualifying-type
+  dd, // TODO: Deprecate
+  .form-group-body {
+    h4 {
+      margin: var(--base-size-4) 0 0;
+
+      &.is-error {
+        color: var(--fgColor-danger, var(--color-danger-fg));
+      }
+
+      &.is-success {
+        color: var(--fgColor-success, var(--color-success-fg));
+      }
+
+      + .note {
+        margin-top: 0;
+      }
+    }
+  }
+  // stylelint-enable selector-no-qualifying-type
+
+  //
+  // Variants
+  //
+
+  &.required {
+    dt label::after, // TODO: Deprecate
+    .form-group-header label::after {
+      // stylelint-disable-next-line primer/spacing
+      padding-left: 5px;
+      color: var(--fgColor-danger, var(--color-danger-fg));
+      content: '*';
+    }
+  }
+
+  // Form AJAX states
+  //
+  // Form fields that need feedback for AJAX loading, success
+  // states and errored states.
+  .success,
+  .error,
+  .indicator {
+    display: none;
+    // stylelint-disable-next-line primer/typography
+    font-size: $font-size-small;
+    // stylelint-disable-next-line primer/typography
+    font-weight: $font-weight-bold;
+  }
+
+  &.loading {
+    opacity: 0.5;
+
+    .indicator {
+      display: inline;
+    }
+
+    .spinner {
+      display: inline-block;
+      vertical-align: middle;
+    }
+  }
+
+  &.successful {
+    .success {
+      display: inline;
+      color: var(--fgColor-success, var(--color-success-fg));
+    }
+  }
+
+  // Form validation
+  //
+  // Our inline errors
+
+  &.successed,
+  &.warn,
+  &.errored {
+    .success,
+    .warning,
+    .error {
+      position: absolute;
+      z-index: 10;
+      display: block; // Show up in errored/warn state
+      max-width: 450px; // Keep our long errors readable
+      padding: var(--base-size-4) var(--base-size-8);
+      margin: var(--base-size-8) 0 0;
+      // stylelint-disable-next-line primer/typography
+      font-size: $font-size-small;
+      // stylelint-disable-next-line primer/typography
+      font-weight: $font-weight-normal;
+      // stylelint-disable-next-line primer/borders
+      border-style: $border-style;
+      // stylelint-disable-next-line primer/borders
+      border-width: $border-width;
+      // stylelint-disable-next-line primer/borders
+      border-radius: $border-radius;
+
+      &::after,
+      &::before {
+        position: absolute;
+        bottom: 100%;
+        // stylelint-disable-next-line primer/spacing
+        left: 10px;
+        z-index: 15;
+        width: 0;
+        height: 0;
+        pointer-events: none;
+        content: ' ';
+        // stylelint-disable-next-line primer/borders, primer/colors
+        border: $border-style transparent;
+      }
+
+      &::after {
+        // stylelint-disable-next-line primer/borders
+        border-width: 5px;
+      }
+
+      &::before {
+        // stylelint-disable-next-line primer/spacing
+        margin-left: -1px;
+        // stylelint-disable-next-line primer/borders
+        border-width: 6px;
+      }
+    }
+  }
+
+  &.successed {
+    .success {
+      color: var(--fgColor-default, var(--color-fg-default));
+      background-color: var(--bgColor-default, var(--color-canvas-default)); // Makes sure the background is opaque to cover any content underneath
+      background-image: linear-gradient(var(--bgColor-success-muted, var(--bgColor-success-muted, var(--color-success-subtle))), var(--color-success-subtle));
+      border-color: var(--borderColor-success-muted, var(--color-success-muted));
+
+      &::after {
+        border-bottom-color: var(--borderColor-success-muted, var(--color-success-muted));
+      }
+
+      &::before {
+        border-bottom-color: var(--borderColor-success-muted, var(--color-success-muted));
+      }
+    }
+  }
+
+  &.warn {
+    .form-control:not(:focus, :focus-visible) {
+      border-color: var(--borderColor-attention-emphasis, var(--color-attention-emphasis));
+    }
+
+    .warning {
+      color: var(--fgColor-default, var(--color-fg-default));
+      background-color: var(--bgColor-default, var(--color-canvas-default)); // Makes sure the background is opaque to cover any content underneath
+      background-image: linear-gradient(var(--bgColor-attention-muted, var(--bgColor-attention-muted, var(--color-attention-subtle))), var(--color-attention-subtle));
+      border-color: var(--borderColor-attention-muted, var(--color-attention-muted));
+
+      &::after {
+        border-bottom-color: var(--borderColor-attention-muted, var(--color-attention-muted));
+      }
+
+      &::before {
+        border-bottom-color: var(--borderColor-attention-muted, var(--color-attention-muted));
+      }
+    }
+  }
+
+  &.errored {
+    .form-control:not(:focus, :focus-visible) {
+      border-color: var(--borderColor-danger-emphasis, var(--color-danger-emphasis));
+    }
+
+    label {
+      color: var(--fgColor-danger, var(--color-danger-fg));
+    }
+
+    .error {
+      color: var(--fgColor-default, var(--color-fg-default));
+      background-color: var(--bgColor-default, var(--color-canvas-default)); // Makes sure the background is opaque to cover any content underneath
+      background-image: linear-gradient(var(--bgColor-danger-muted, var(--bgColor-danger-muted, var(--color-danger-subtle))), var(--color-danger-subtle));
+      border-color: var(--borderColor-danger-muted, var(--color-danger-muted));
+
+      &::after {
+        border-bottom-color: var(--borderColor-danger-muted, var(--color-danger-muted));
+      }
+
+      &::before {
+        border-bottom-color: var(--borderColor-danger-muted, var(--color-danger-muted));
+      }
+    }
+  }
+}
+
+// tooltip
+.note {
+  min-height: 17px;
+  // stylelint-disable-next-line primer/spacing
+  margin: var(--base-size-4) 0 2px;
+  // stylelint-disable-next-line primer/typography
+  font-size: $font-size-small;
+  color: var(--fgColor-muted, var(--color-fg-muted));
+
+  .spinner {
+    // stylelint-disable-next-line primer/spacing
+    margin-right: 3px;
+    vertical-align: middle;
+  }
+}

package/build/primer/forms/form-select.scss

@@ -0,0 +1,47 @@
+// Custom select
+//
+// Apply `.select` to any `<select>` element for custom styles.
+.form-select {
+  display: inline-block;
+  max-width: 100%;
+  height: $size-5;
+  padding-right: var(--base-size-24);
+  background-color: var(--bgColor-default, var(--color-canvas-default));
+  // SVG with fill: #586069 (--color-icon-secondary)
+  background-image: url('data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0iIzU4NjA2OSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJNNC40MjcgOS40MjdsMy4zOTYgMy4zOTZhLjI1MS4yNTEgMCAwMC4zNTQgMGwzLjM5Ni0zLjM5NkEuMjUuMjUgMCAwMDExLjM5NiA5SDQuNjA0YS4yNS4yNSAwIDAwLS4xNzcuNDI3ek00LjQyMyA2LjQ3TDcuODIgMy4wNzJhLjI1LjI1IDAgMDEuMzU0IDBMMTEuNTcgNi40N2EuMjUuMjUgMCAwMS0uMTc3LjQyN0g0LjZhLjI1LjI1IDAgMDEtLjE3Ny0uNDI3eiIgLz48L3N2Zz4=');
+  background-repeat: no-repeat;
+  background-position: right 4px center;
+  background-size: 16px;
+  appearance: none;
+
+  // Hides the default caret in IE11
+  &::-ms-expand {
+    opacity: 0;
+  }
+
+  &[multiple] {
+    height: auto;
+  }
+}
+
+@include color-mode(dark) {
+  .form-select {
+    // SVG with fill: #6e7681 (--color-icon-secondary)
+    background-image: url('data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0iIzZlNzY4MSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJNNC40MjcgOS40MjdsMy4zOTYgMy4zOTZhLjI1MS4yNTEgMCAwMC4zNTQgMGwzLjM5Ni0zLjM5NkEuMjUuMjUgMCAwMDExLjM5NiA5SDQuNjA0YS4yNS4yNSAwIDAwLS4xNzcuNDI3ek00LjQyMyA2LjQ3TDcuODIgMy4wNzJhLjI1LjI1IDAgMDEuMzU0IDBMMTEuNTcgNi40N2EuMjUuMjUgMCAwMS0uMTc3LjQyN0g0LjZhLjI1LjI1IDAgMDEtLjE3Ny0uNDI3eiIgLz48L3N2Zz4=');
+  }
+}
+
+.select-sm {
+  height: $size-4;
+  // stylelint-disable-next-line primer/spacing
+  padding-top: 3px;
+  // stylelint-disable-next-line primer/spacing
+  padding-bottom: 3px;
+  // stylelint-disable-next-line primer/typography
+  font-size: $font-size-small;
+
+  &[multiple] {
+    height: auto;
+    min-height: 0;
+  }
+}

package/build/primer/forms/index.scss

@@ -0,0 +1,6 @@
+@import '../support/index.scss';
+@import './form-control.scss';
+@import './form-select.scss';
+@import './form-group.scss';
+@import './input-group.scss';
+@import './radio-group.scss';