Global CSS API: Controls - Button
The following CSS custom properties are used for the button control UI.
Button Base
Properties used for base button control UI.
| Property | Description | Default |
|---|---|---|
| Border | ||
| --gf-ctrl-btn-radius | Border radius. | var(--gf-radius) |
| Effects | ||
| --gf-ctrl-btn-shadow | Box shadow. | 0 1px 4px rgba(18, 25, 97, 0.0779552) |
| --gf-ctrl-btn-shadow-hover | Box shadow when hovered. | var(--gf-ctrl-btn-shadow) |
| --gf-ctrl-btn-shadow-focus | Box shadow when focused. | var(--gf-ctrl-btn-shadow) |
| --gf-ctrl-btn-shadow-disabled | Box shadow when disabled. | var(--gf-ctrl-btn-shadow) |
| --gf-ctrl-btn-opacity | Opacity. | 1 |
| --gf-ctrl-btn-opacity-disabled | Opacity when disabled. | 0.5 |
| Sizing | ||
| --gf-ctrl-btn-size-xs | Extra small button size. | 30px |
| --gf-ctrl-btn-size-sm | Small button size. | var(--gf-ctrl-size-sm) |
| --gf-ctrl-btn-size-md | Medium button size. | var(--gf-ctrl-size-md) |
| --gf-ctrl-btn-size-lg | Large button size. | var(--gf-ctrl-size-lg) |
| --gf-ctrl-btn-size-xl | Extra large button size. | var(--gf-ctrl-size-xl) |
| --gf-ctrl-btn-size | Button size. | var(--gf-ctrl-btn-size-md) |
| Spacing | ||
| --gf-ctrl-btn-padding-x-xs | Horizontal (left/right) padding for extra small buttons. | 8px |
| --gf-ctrl-btn-padding-x-sm | Horizontal (left/right) padding for small buttons. | 12px |
| --gf-ctrl-btn-padding-x-md | Horizontal (left/right) padding for medium buttons. | 16px |
| --gf-ctrl-btn-padding-x-lg | Horizontal (left/right) padding for large buttons. | 20px |
| --gf-ctrl-btn-padding-x-xl | Horizontal (left/right) padding for extra large buttons. | 24px |
| --gf-ctrl-btn-padding-x | Horizontal (left/right) padding. | var(--gf-ctrl-btn-padding-x-md) |
| --gf-ctrl-btn-padding-y | Vertical (top/bottom) padding. | 0 |
| Typography | ||
| --gf-ctrl-btn-font-family | Font family. | var(--gf-font-family-base) |
| --gf-ctrl-btn-font-size-xs | Font size for extra small buttons. | 12px |
| --gf-ctrl-btn-font-size-sm | Font size for small buttons. | 14px |
| --gf-ctrl-btn-font-size-md | Font size for medium buttons. | 14px |
| --gf-ctrl-btn-font-size-lg | Font size for large buttons. | 16px |
| --gf-ctrl-btn-font-size-xl | Font size for extra large buttons. | 16px |
| --gf-ctrl-btn-font-size | Font size. | var(--gf-ctrl-btn-font-size-md) |
| --gf-ctrl-btn-font-style | Font style. | var(--gf-font-style-base) |
| --gf-ctrl-btn-font-weight | Font weight. | 500 |
| --gf-ctrl-btn-letter-spacing | Letter spacing. | var(--gf-letter-spacing-primary) |
| --gf-ctrl-btn-line-height | Line height. | 1 |
| --gf-ctrl-btn-text-decoration | Text decoration. | none |
| --gf-ctrl-btn-text-transform | Text transform. | none |
| Icon | ||
| --gf-ctrl-btn-icon | Icon. | none |
| --gf-ctrl-btn-icon-size | Icon size. | var(--gf-icon-font-size) |
| --gf-ctrl-btn-icon-gap | Gap between icon and text. | 6px |
| --gf-ctrl-btn-icon-transition | Icon transition. | var(--gf-ctrl-transition) |
Primary Button
Properties used for the primary button control UI.
| Property | Description | Default |
|---|---|---|
| Background | ||
| --gf-ctrl-btn-bg-color-primary | Background color. | var(--gf-color-primary) |
| --gf-ctrl-btn-bg-color-hover-primary | Background color when hovered. | var(--gf-color-primary-darker) |
| --gf-ctrl-btn-bg-color-focus-primary | Background color when focused. | var(--gf-ctrl-btn-bg-color-primary) |
| --gf-ctrl-btn-bg-color-disabled-primary | Background color when disabled. | var(--gf-ctrl-btn-bg-color-primary) |
| Border | ||
| --gf-ctrl-btn-border-color-primary | Border color. | transparent |
| --gf-ctrl-btn-border-color-hover-primary | Border color when hovered. | transparent |
| --gf-ctrl-btn-border-color-focus-primary | Border color when focused. | var(--gf-ctrl-btn-bg-color-hover-primary) |
| --gf-ctrl-btn-border-color-disabled-primary | Border color when disabled. | transparent |
| --gf-ctrl-btn-border-style-primary | Border style. | solid |
| --gf-ctrl-btn-border-width-primary | Border width. | 1px |
| Color | ||
| --gf-ctrl-btn-color-primary | Color. | var(--gf-color-primary-contrast) |
| --gf-ctrl-btn-color-hover-primary | Color when hovered. | var(--gf-ctrl-btn-color-primary) |
| --gf-ctrl-btn-color-focus-primary | Color when focused. | var(--gf-ctrl-btn-color-primary) |
| --gf-ctrl-btn-color-disabled-primary | Color when disabled. | var(--gf-ctrl-btn-color-primary) |
| Icon | ||
| --gf-ctrl-btn-icon-color-primary | Icon color. | var(--gf-ctrl-btn-color-primary) |
| --gf-ctrl-btn-icon-color-hover-primary | Icon color when hovered. | var(--gf-ctrl-btn-icon-color-primary) |
| --gf-ctrl-btn-icon-color-focus-primary | Icon color when focused. | var(--gf-ctrl-btn-icon-color-primary) |
| --gf-ctrl-btn-icon-color-disabled-primary | Icon color when disabled. | var(--gf-ctrl-btn-icon-color-primary) |
Secondary Button
Properties used for the secondary button control UI.
| Property | Description | Default |
|---|---|---|
| Background | ||
| --gf-ctrl-btn-bg-color-secondary | Background color. | var(--gf-color-secondary) |
| --gf-ctrl-btn-bg-color-hover-secondary | Background color when hovered. | var(--gf-color-secondary-darker) |
| --gf-ctrl-btn-bg-color-focus-secondary | Background color when focused. | var(--gf-ctrl-btn-bg-color-secondary) |
| --gf-ctrl-btn-bg-color-disabled-secondary | Background color when disabled. | var(--gf-ctrl-btn-bg-color-secondary) |
| Border | ||
| --gf-ctrl-btn-border-color-secondary | Border color. | var(--gf-color-in-ctrl-light-darker) |
| --gf-ctrl-btn-border-color-hover-secondary | Border color when hovered. | var(--gf-ctrl-btn-border-color-secondary) |
| --gf-ctrl-btn-border-color-focus-secondary | Border color when focused. | var(--gf-ctrl-btn-bg-color-hover-primary) |
| --gf-ctrl-btn-border-color-disabled-secondary | Border color when disabled. | var(--gf-ctrl-btn-border-color-secondary) |
| --gf-ctrl-btn-border-style-secondary | Border style. | solid |
| --gf-ctrl-btn-border-width-secondary | Border width. | 1px |
| Color | ||
| --gf-ctrl-btn-color-secondary | Color. | var(--gf-color-secondary-contrast) |
| --gf-ctrl-btn-color-hover-secondary | Color when hovered. | var(--gf-ctrl-btn-color-secondary) |
| --gf-ctrl-btn-color-focus-secondary | Color when focused. | var(--gf-ctrl-btn-color-secondary) |
| --gf-ctrl-btn-color-disabled-secondary | Color when disabled. | var(--gf-ctrl-btn-color-secondary) |
| Icon | ||
| --gf-ctrl-btn-icon-color-secondary | Icon color. | var(--gf-ctrl-icon-color) |
| --gf-ctrl-btn-icon-color-hover-secondary | Icon color when hovered. | var(--gf-ctrl-btn-icon-color-secondary) |
| --gf-ctrl-btn-icon-color-focus-secondary | Icon color when focused. | var(--gf-ctrl-btn-icon-color-secondary) |
| --gf-ctrl-btn-icon-color-disabled-secondary | Icon color when disabled. | var(--gf-ctrl-btn-icon-color-secondary) (var(--gf-ctrl-icon-color)) |
Control Button
Properties used for buttons inside of controls, such as the enhanced multi-file upload control UI.
| Property | Description | Default |
|---|---|---|
| Background | ||
| --gf-ctrl-btn-bg-color-ctrl | Background color. | var(--gf-color-in-ctrl-primary) |
| --gf-ctrl-btn-bg-color-hover-ctrl | Background color when hovered. | var(--gf-color-in-ctrl-primary-darker) |
| --gf-ctrl-btn-bg-color-focus-ctrl | Background color when focused. | var(--gf-ctrl-btn-bg-color-ctrl) |
| --gf-ctrl-btn-bg-color-disabled-ctrl | Background color when disabled. | var(--gf-ctrl-btn-bg-color-ctrl) |
| Border | ||
| --gf-ctrl-btn-border-color-ctrl | Border color. | transparent |
| --gf-ctrl-btn-border-color-hover-ctrl | Border color when hovered. | transparent |
| --gf-ctrl-btn-border-color-focus-ctrl | Border color when focused. | var(--gf-ctrl-btn-bg-color-hover-ctrl) |
| --gf-ctrl-btn-border-color-disabled-ctrl | Border color when disabled. | transparent |
| --gf-ctrl-btn-border-style-ctrl | Border style. | solid |
| --gf-ctrl-btn-border-width-ctrl | Border width. | 1px |
| Color | ||
| --gf-ctrl-btn-color-ctrl | Color. | var(--gf-color-in-ctrl-primary-contrast) |
| --gf-ctrl-btn-color-hover-ctrl | Color when hovered. | var(--gf-ctrl-btn-color-ctrl) |
| --gf-ctrl-btn-color-focus-ctrl | Color when focused. | var(--gf-ctrl-btn-color-ctrl) |
| --gf-ctrl-btn-color-disabled-ctrl | Color when disabled. | var(--gf-ctrl-btn-color-ctrl) |
| Icon | ||
| --gf-ctrl-btn-icon-color-ctrl | Icon color. | var(--gf-ctrl-btn-color-ctrl) |
| --gf-ctrl-btn-icon-color-hover-ctrl | Icon color when hovered. | var(--gf-ctrl-btn-icon-color-ctrl) |
| --gf-ctrl-btn-icon-color-focus-ctrl | Icon color when focused. | var(--gf-ctrl-btn-icon-color-ctrl) |
| --gf-ctrl-btn-icon-color-disabled-ctrl | Icon color when disabled. | var(--gf-ctrl-btn-icon-color-ctrl) |
Simple Button
Properties used for simple button control UI, such as the password field visibility toggle or file upload cancel button. This button variation has a transparent background, no border, and is visually an icon based button.
| Property | Description | Default |
|---|---|---|
| Background | ||
| --gf-ctrl-btn-bg-color-simple | Background color. | transparent |
| --gf-ctrl-btn-bg-color-hover-simple | Background color when hovered. | var(--gf-ctrl-btn-bg-color-simple) |
| --gf-ctrl-btn-bg-color-focus-simple | Background color when focused. | var(--gf-ctrl-btn-bg-color-simple) |
| --gf-ctrl-btn-bg-color-disabled-simple | Background color when disabled. | var(--gf-ctrl-btn-bg-color-simple) |
| Border | ||
| --gf-ctrl-btn-border-color-simple | Border color. | transparent |
| --gf-ctrl-btn-border-color-hover-simple | Border color when hovered. | var(--gf-ctrl-btn-border-color-simple) |
| --gf-ctrl-btn-border-color-focus-simple | Border color when focused. | var(--gf-ctrl-border-color-focus) |
| --gf-ctrl-btn-border-color-disabled-simple | Border color when disabled. | var(--gf-ctrl-btn-border-color-simple) |
| --gf-ctrl-btn-border-style-simple | Border style. | solid |
| --gf-ctrl-btn-border-width-simple | Border width. | 1px |
| Color | ||
| --gf-ctrl-btn-color-simple | Color. | rgba(var(--gf-color-out-ctrl-dark-rgb), 0.65) |
| --gf-ctrl-btn-color-hover-simple | Color when hovered. | var(--gf-color-out-ctrl-dark) |
| --gf-ctrl-btn-color-focus-simple | Color when focused. | var(--gf-ctrl-btn-color-hover-simple) |
| --gf-ctrl-btn-color-disabled-simple | Color when disabled. | var(--gf-ctrl-btn-color-simple) |
| Effects | ||
| --gf-ctrl-btn-shadow-simple | Box shadow. | none |
| --gf-ctrl-btn-shadow-hover-simple | Box shadow when hovered. | var(--gf-ctrl-btn-shadow-simple) |
| --gf-ctrl-btn-shadow-focus-simple | Box shadow when focused. | var(--gf-ctrl-btn-shadow-simple) |
| --gf-ctrl-btn-shadow-disabled-simple | Box shadow when disabled. | var(--gf-ctrl-btn-shadow-simple) |
| Sizing | ||
| --gf-ctrl-btn-size-simple | Size. | 24px |
| Icon | ||
| --gf-ctrl-btn-icon-color-simple | Icon color. | rgba(var(--gf-color-out-ctrl-dark-rgb), 0.9) |
| --gf-ctrl-btn-icon-color-hover-simple | Icon color when hovered. | var(--gf-ctrl-btn-color-hover-simple) |
| --gf-ctrl-btn-icon-color-focus-simple | Icon color when focused. | var(--gf-ctrl-btn-icon-color-focus-simple) |
| --gf-ctrl-btn-icon-color-disabled-simple | Icon color when disabled. | var(--gf-ctrl-btn-color-disabled-simple) |