1.0.2 • Published 2 years ago

tailwind-column-rule v1.0.2

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

Tailwind CSS Column-Rule

This plugin adds utilities to use column-rule properties with Tailwind CSS.

Installation

Add this plugin to your project:

# Install using npm
npm install --save-dev tailwind-column-rule

Add the plugin to file config

// tailwind.config.js
{
  plugins: [
    require('tailwind-column-rule'),
  ],
}

This plugin adds utilities to use column-rule-width, column-rule-style, and column-rule-color properties with Tailwind CSS.

column-rule-width

The column-rule-width CSS property sets the width of the line drawn between columns in a multi-column layout.

By default the plugin uses the borderWidth properties from your theme to generate the utilities for controlling de line weight

ClassProperties
rule-w-0column-rule-width: 0px;
rule-w-2column-rule-width: 2px;
rule-w-4column-rule-width: 4px;
rule-w-8column-rule-width: 8px;
rule-wcolumn-rule-width: 1px;

Applying conditionally

You let conditionally apply utility classes in different states using variant modifiers.

<div class="hover:rule-w-0">
  <!-- ... -->
</div>

Breakpoints and media queries

You can also use variant modifiers to target media queries

<div class="md:rule-w-3">
  <!-- ... -->
</div>

Customizing your theme

By default, this plugin provides five border-width utilities. You change, add, or remove these by editing the theme.borderWidth section of your Tailwind config. Or the plugin theme.ruleWidth

// tailwind.config.js
{
  theme: {
    ruleWidth: {
        10: "10px",
    },
  plugins: [
    require('tailwind-column-rule'),
  ],
}

Arbitrary values

If you need to use a one-off rule-w-{width} value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

<div class="rule-w-[15px]">
  <!-- ... -->
</div>

column-rule-style

The column-rule-style CSS property sets the style of the line drawn between columns in a multi-column layout.

By default the plugin uses the ruleStyle properties from your theme to generate the utilities for controlling de line style.

ClassProperties
rule-style-solidcolumn-rule-style: solid;
rule-style-dashedcolumn-rule-style: dashed;
rule-style-dottedcolumn-rule-style: dotted;
rule-style-doublecolumn-rule-style: double;
rule-style-hiddencolumn-rule-style: hidden;
rule-style-nonecolumn-rule-style: none;

Applying conditionally

You let conditionally apply utility classes in different states using variant modifiers.

<div class="hover:rule-style-dotted">
  <!-- ... -->
</div>

Breakpoints and media queries

You can also use variant modifiers to target media queries

<div class="md:rule-style-double">
  <!-- ... -->
</div>

Customizing your theme

By default, this plugin provides five border-width utilities. You change, add, or remove these by editing the theme.ruleStyle section of your Tailwind config.

// tailwind.config.js
{
  theme: {
    ruleStyle: {
        "groove": "groove",
    },
  plugins: [
    require('tailwind-column-rule'),
  ],
}

column-rule-color

The column-rule-color CSS property sets the color of the line drawn between columns in a multi-column layout.

By default the plugin uses the colors properties from your theme to generate the utilities for controlling de line color.

ClassProperties
rule-color-inheritcolumn-rule-color: inherit;
rule-color-currentcolumn-rule-color: current;
rule-color-transparentcolumn-rule-color: transparent;
rule-color-blackcolumn-rule-color: rgb(0 0 0);
rule-color-whitecolumn-rule-color: rgb(255 255 255);
rule-color-slate-50column-rule-color: rgb(248 250 252);
Color paletteDefault color palette

Applying conditionally

You let conditionally apply utility classes in different states using variant modifiers.

<div class="hover:rule-color-red-800">
  <!-- ... -->
</div>

Breakpoints and media queries

You can also use variant modifiers to target media queries

<div class="md:rule-color-green-500">
  <!-- ... -->
</div>

Customizing your theme

By default, this plugin provides five border-width utilities. You change, add, or remove these by editing the theme.borderWidth section of your Tailwind config. Or maybe de plugin theme.ruleWidth

By default, this plugin makes the entire default color palette available as rule colors. You can customize your color palette by editing theme.colors or theme.extend.colors in your tailwind.config.js file. Or the plugin theme.ruleColor

// tailwind.config.js
{
  theme: {
      ruleColor: {
        red: "red",
      },
  plugins: [
    require('tailwind-column-rule'),
  ],
}

Arbitrary values

If you need to use a one-off rule-color-{color} value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

<div class="rule-color-[blue]">
  <!-- ... -->
</div>