@kuro-samurai/ngx-samurai-button NPM

Samurai Button

Make your app stylish with pre-styled buttons

Features Overview

This directive has:

3 Variations
3 Content Types
7 Hover Effects
3 Border Radius Styles
2 States
10 Pre-styled Buttons
Automatic text and icon and hover color detection
Support for Angular Internationalization
Support for ARIA
Material Icon Font (super light weight)

The style of the button is based on UI/UX guidelines. You can set
filled, outlined or texted variations for it or change content type
to text, text and icon or just icon to get the right attention and priority you need.

Installation

This directive supports Angular 16 and higher

Run the code below in your project terminal:

ng add @kuro-samurai/ngx-samurai-button

This command will install material icon font package.
The samurai-styles.css file will be created in the root
of your project and it will be added to your angular.json
project styles

Use

Selector: samuraiButton
Type: Standalone

Import the directive

If your component is standalone, import the directive to your
@Component decorator:

@Component({
  //...
  standalone: true,
  imports: [CommonModule, SamuraiButtonsComponent],
  //...
})

Else import it to your component's module:

@NgModule({
  //...
  imports: [CommonModule, SamuraiButtonsComponent],
  //...
})

Then in your component import class SamuraiButtonConfig and use its constructor:
```
public buttonConfig = new SamuraiButtonConfig()
```
In the parenthesis use shortcut ctrl + space or command + space to see available values.
All parameters have default values so you don't need to pass all values.
Note: Refer to properties table below for values and defaults.
You can either pass each property individually or pass
config object, If you do both, values in config object will overwrite
individual values!

Pass the config object to directive input:

<button samuraiButton [config]="buttonConfig">Samurai</button>

Button With Action

To make button do a certain action everytime user clicks on it,
you can pass a function to it like this:

Declare a method in parent component:

public foo = () => console.log("action foo")

Then pass it to property btnAction:

<button samuraiButton [config]="buttonConfig" [btnAction]="foo">Samurai</button>

If you have complex action to happen after button click,
bind your action to event click like this:

<button samuraiButton [config]="buttonConfig" (click)="foo()">Samurai</button>

Using Pre-Styled Button

Assign one of the values in properties table blow to property (input) preStyled:

<button samuraiButton preStyled="PRIMARY_TEXT">Samurai</button>

More pre-styled buttons will be added soon.

Warning: If you pass both preStyled and config, values in config has priority.

Note: you can overwrite styles with css or add additional styles to button like changing padding, shadow and .etc

Preview

For Live demo visit Github page for Samurai UI (Beta)

Properties (Inputs)

Related Resources

This directive is part of Samurai UI project.

Future Plans

The following features will be added soon:

Setting up a live demo ✅
A few pre-defined button styles to quickly choose between them ✅
Passing a single config object to button ✅
Passing a function to button that executes on button click ✅
Automatically detecting right text color for button based on background color ✅
Automatically detecting right hover effect color based on
color and background color ✅
Adding support for i18n (Internationalization) ✅
Implementing ARIA support for people using AT ✅
Transforming component to directive for better developer exprience ✅

Developer Words

I learned a lot from other developers on the web. Now I want to return
the love to software developers community. I plan to make a UI kit for
angular and this package is one of many packages I will publish on npm.