SharpStyles 1.0.5

SharpStyles

TDD-able Styles for Blazor

This library offers the capability to write CSS rules in C#. This capability allows C#.NET developers especially for Blazor applications to test-drive the CSS rules in their components effectively.

How to Use

To use SharpStyles; all you need to do is to inherit the SharpStyles model to your local Component Style models as follows:

⚠️ Important: .ToCss() is obsolete and only supports legacy nested style serialization. Use ToStyleCss() extension method instead.

Setup

public class MyComponentStyle: SharpStyle
{
	[CssElement]
	public SharpStyle Td {get; set;}
	
	[CssClass]
	public SharpStyle PrimaryButton {get; set;}

	[CssId]
	public SharpStyle SubmitButton {get; set;}
}

Now you can use MyComponentStyle as follows:

var myComponentStyle = new MyComponentStyle
{
	Td = new SharpStyle
	{
		BackgroundColor = "red"
	},

	PrimaryButton = new SharpStyle
	{
		BackgroundColor = "blue",
		Color = "white"
	},

	SubmitButton = new SharpStyle
	{
		Width = "12px"
	}
}

You can now use this object myComponentStyle to generate CSS rules for your Blazor component just as follows:

	myComponentStyle.ToStyleCss();

This code will generate the following rules:

td {
	background-color: "red";
}

.primary-button {
	background-color: "blue";
	color: "white";
}

#submit-button {
	width: "12px";
}

You can also customize your selectors as follows:

public class MyComponentStyle: SharpStyle
{
	[CssElement(Selector="my-custom-td")]
	public SharpStyle Td {get; set;}
	
	[CssClass(Selector=".my-custom-primary-button")]
	public SharpStyle PrimaryButton {get; set;}

	[CssId(Selector="#my-custom-submit-button")]
	public SharpStyle SubmitButton {get; set;}
}

which will produce the following CSS:

my-custom-td {
	background-color: "red";
}

.my-custom-primary-button {
	background-color: "blue";
	color: "white";
}

#my-custom-submit-button {
	width: "12px";
}

Media Query Support

SharpStyles also supports building CSS media queries using C# — allowing you to write responsive styles in a testable, fluent format.

Example Usage

var mediaQuery = new MediaQuery
{
    Only = true,
    MediaType = "screen",
    MaxWidth = 768,
    Styles = new SharpStyle
    {
        BackgroundColor = "red"
    }
};

string css = mediaQuery.ToStyleCss();

This generates the following CSS:

@media only screen and (max-width: 768px) {
	background-color: red;
}

You can also use additional features like min-width, not, or custom conditions such as orientation:

var mediaQuery = new MediaQuery
{
    MediaType = "screen",
    MinWidth = 600,
    MaxWidth = 1024,
    CustomFeature = "(orientation: landscape)",
    Styles = new SharpStyle
    {
        Color = "blue"
    }
};

Which generates the following CSS:

@media screen and (min-width: 600px) and (max-width: 1024px) and (orientation: landscape) {
  color: blue;
}

Support of Keyframes

Highlights

• New model types:
  • SharpKeyframes
  • SharpKeyframe
  • SharpKeyframeProperty
• Clean, valid @keyframes CSS generation
• Fully compatible with existing SharpStyles design
• Includes edge case validation
• Thorough unit test coverage

Example 1: Fade In Animation

var keyframes = new SharpKeyframes
{
    Name = "fadeIn",

    Keyframes = new List<SharpKeyframe>
    {
        new SharpKeyframe()
        {
            Selector = "from",

            Properties = new List<SharpKeyframeProperty>()
            {
                new SharpKeyframeProperty()
                {
                    Name = "opacity",
                    Value = "0"
                }
            }
        },
        new SharpKeyframe()
        {
            Selector = "to",

            Properties = new List<SharpKeyframeProperty>()
            {
                new SharpKeyframeProperty()
                {
                    Name = "opacity",
                    Value = "1"
                }
            }
        }
    }
};

string css = keyframes.ToStyleCss();

Generates:

@keyframes fadeIn {
  from {
    opacity: 0;
  }
  to {
    opacity: 1;
  }
}

Example 2: Pulse Animation

var keyframes = new SharpKeyframes
{
    Name = "pulse",

    Keyframes = new List<SharpKeyframe>
    {
        new SharpKeyframe()
        {
            Selector = "0%",

            Properties = new List<SharpKeyframeProperty>()
            {
                new SharpKeyframeProperty()
                {
                    Name = "transform",
                    Value = "scale(1)"
                },
                new SharpKeyframeProperty()
                {
                    Name = "opacity",
                    Value = "1"
                }
            }
        },
        new SharpKeyframe()
        {
            Selector = "50%",

            Properties = new List<SharpKeyframeProperty>()
            {
                new SharpKeyframeProperty()
                {
                    Name = "transform",
                    Value = "scale(1.1)"
                },
                new SharpKeyframeProperty()
                {
                    Name = "opacity",
                    Value = "0.7"
                }
            }
        },
        new SharpKeyframe()
        {
            Selector = "100%",

            Properties = new List<SharpKeyframeProperty>()
            {
                new SharpKeyframeProperty()
                {
                    Name = "transform",
                    Value = "scale(1)"
                },
                new SharpKeyframeProperty()
                {
                    Name = "opacity",
                    Value = "1"
                }
            }
        }
    }
};

Generates:

@keyframes pulse {
  0% {
    transform: scale(1);
    opacity: 1;
  }
  50% {
    transform: scale(1.1);
    opacity: 0.7;
  }
  100% {
    transform: scale(1);
    opacity: 1;
  }
}

Follow-up

Here's a video introduction to this library:

<br />

If you have any suggestions, comments or questions, please feel free to contact me on: <br /> Twitter: @hassanrezkhabib <br /> LinkedIn: hassanrezkhabib <br /> E-Mail: hassanhabib@live.com <br />