Ir ao contido principal Ir á navegación de documentos
in English

Compoñentes

Aprende como e por que construímos case todos os nosos compoñentes de forma sensible e con clases base e modificadora.

Clases básicas

Os compoñentes de Bootstrap constrúense en gran parte cunha nomenclatura de modificador de bases. Agrupamos tantas propiedades compartidas como sexa posible nunha clase base, como .btn, e despois agrupamos estilos individuais para cada variante en clases modificadoras, como .btn-primaryou .btn-success.

Para construír as nosas clases modificadoras, usamos os @eachbucles de Sass para iterar sobre un mapa de Sass. Isto é especialmente útil para xerar variantes dun compoñente polo noso $theme-colorse crear variantes sensibles para cada punto de interrupción. A medida que personalices estes mapas de Sass e recompiles, verás automaticamente os teus cambios reflectidos nestes bucles.

Consulta os nosos documentos de mapas e bucles de Sass para saber como personalizar estes bucles e estender o enfoque do modificador base de Bootstrap ao teu propio código.

Modificadores

Moitos dos compoñentes de Bootstrap están construídos cun enfoque de clase modificador base. Isto significa que a maior parte do estilo está contida nunha clase base (por exemplo, .btn) mentres que as variacións de estilo están limitadas a clases modificadoras (por exemplo, .btn-danger). Estas clases modificadoras constrúense a partir do $theme-colorsmapa para personalizar o número e o nome das nosas clases modificadoras.

Aquí tes dous exemplos de como recorremos o $theme-colorsmapa para xerar modificadores para os compoñentes .alerte .list-group.

// Generate contextual modifier classes for colorizing the alert.

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);
  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}
// List group contextual variants
//
// Add modifier classes to change text and background color on individual items.
// Organizationally, this must come after the `:hover` states.

@each $state, $value in $theme-colors {
  $list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);
  $list-group-variant-color: shift-color($value, $list-group-item-color-scale);
  @if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {
    $list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));
  }

  @include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);
}

Sensible

Estes bucles Sass tampouco se limitan a mapas de cores. Tamén pode xerar variacións sensibles dos seus compoñentes. Tome, por exemplo, a nosa aliñación sensible dos menús despregables onde mesturamos un @eachbucle para o $grid-breakpointsmapa Sass cunha consulta multimedia incluída.

// We deliberately hardcode the `bs-` prefix because we check
// this custom property in JS to determine Popper's positioning

@each $breakpoint in map-keys($grid-breakpoints) {
  @include media-breakpoint-up($breakpoint) {
    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);

    .dropdown-menu#{$infix}-start {
      --bs-position: start;

      &[data-bs-popper] {
        right: auto;
        left: 0;
      }
    }

    .dropdown-menu#{$infix}-end {
      --bs-position: end;

      &[data-bs-popper] {
        right: 0;
        left: auto;
      }
    }
  }
}

Se modificas o teu $grid-breakpoints, os teus cambios aplicaranse a todos os bucles que iteran sobre ese mapa.

$grid-breakpoints: (
  xs: 0,
  sm: 576px,
  md: 768px,
  lg: 992px,
  xl: 1200px,
  xxl: 1400px
);

Para obter máis información e exemplos sobre como modificar os nosos mapas e variables Sass, consulte a sección Sass da documentación de Grid .

Creando o teu propio

Animámosche a que adoptes estas directrices cando creas con Bootstrap para crear os teus propios compoñentes. Este enfoque estendemos nós mesmos aos compoñentes personalizados da nosa documentación e exemplos. Os compoñentes como as nosas chamadas están construídos igual que os nosos compoñentes proporcionados con clases base e modificadora.

Esta é unha chamada. Creámolo personalizado para os nosos documentos para que destaquen as nosas mensaxes para ti. Ten tres variantes mediante clases modificadoras.
<div class="callout">...</div>

No teu CSS, tes algo como o seguinte onde a maior parte do estilo realízase mediante .callout. Despois, os estilos únicos entre cada variante contrólanse mediante a clase modificadora.

// Base class
.callout {}

// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}

Para as chamadas, ese estilo único é só un border-left-color. Cando combinas esa clase base cunha desas clases modificadoras, obtén a túa familia de compoñentes completa:

Esta é unha chamada informativa. Texto de exemplo para mostralo en acción.
Esta é unha chamada de advertencia. Texto de exemplo para mostralo en acción.
Esta é unha chamada de perigo. Texto de exemplo para mostralo en acción.