/tailwindcss-full-bleed

A tailwindcss plugin that provides utilities for extended backgrounds and borders.

Primary LanguageJavaScriptMIT LicenseMIT

tailwindcss-full-bleed

A plugin that provides utilities for extended backgrounds and borders.

Installation

Install the plugin from npm:

npm install -D tailwindcss-full-bleed

or

yarn add -D tailwindcss-full-bleed

Then add the plugin to your tailwind.config.js file:

// tailwind.config.js
module.exports = {
  theme: {
    // ...
  },
  plugins: [
    require('tailwindcss-full-bleed'),
    // ...
  ],
}

Usage

Class Description
bleed-{color} Any tailwind color to specify the bleed color.
bleed-bg A background that extends to the left and right.
bleed-bg-l A background that extends to the left.
bleed-bg-r A background that extends to the right.
bleed-border 1px top and bottom border that extends to the left and right.
bleed-border-t 1px top border that extends to the left and right.
bleed-border-b 1px bottom border that extends to the left and right.
bleed-border-l 1px top and bottom border that extends to the left.
bleed-border-r 1px top and bottom border that extends to the right.
bleed-border-tl 1px top border that extends to the left.
bleed-border-tr 1px top border that extends to the right.
bleed-border-bl 1px bottom border that extends to the left.
bleed-border-br 1px bottom border that extends to the right.
bleed-border-br-2 2px bottom border that extends to the right.
bleed-border-br-4 4px bottom border that extends to the right.
bleed-border-br-8 8px bottom border that extends to the right.
bleed-border-br-[14px] 14px bottom border that extends to the right.
bleed-none To remove any full-bleeding.

Extending the Plugin

bleed-{color} and bleed-border-{borderWidth} values are using Tailwind's colors and borderWidth configuration. If you want to extend the classes provided by this plugin, you will need to extend the colors (or bleedColors) and borderWidth (or bleedBorderWidth) utilities in your tailwind.config.js file.

For example, to add a new color to the bleed-{color} utility, add the color to your colors configuration:

module.exports = {
  theme: {
    extend: {
      colors: {
        primary: {
          DEFAULT: '#4f46e5'
        }
      }
    }
  },
  // ...
}

Similarly, to add a new border width to the bleed-border utility, add the width to your borderWidth configuration:

module.exports = {
  theme: {
    extend: {
      borderWidth: {
        10: '10px'
      }
    }
  },
  // ...
}

If you want to add colors that only apply to bleed utilities, use bleedColors property instead:

module.exports = {
  theme: {
    extend: {
      bleedColors: {
        primary: {
          DEFAULT: '#4f46e5' // <- only avaiable for bleed-{color} classes
        }
      }
    }
  },
  // ...
}

If the same color is avaiable in colors, bleedColors will override the color value for bleed-{color} classes. Use bleedBorderWidth property for bleed only border widths as well.