Download the PHP package malven/craft-bits without Composer
On this page you can find all versions of the php package malven/craft-bits. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package craft-bits
Bits plugin for Craft CMS 3.x
A collection of simple, reusable components for use in your Craft Twig templates.
Requirements
This plugin requires Craft CMS 3.0.0-beta.23 or later.
Installation
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project
-
Then tell Composer to load the plugin:
composer require malven/craft-bits
- In the Control Panel, go to Settings → Plugins and click the “Install” button for Bits.
Components
Forms
Text
Textarea
Selectable
A selectable
renders either a checkbox
or radio
element, depending on the supplied type
.
Button
A btn
allows you to create either an a
or button
element that use the same underlying strucuture and can be styled identically.
Utilies
Validate Classes
When building complex sites using [BEM]() syntax for modifier classes (e.g. foo--large
) it can be helpful to define which modifiers can be used together and which must be exclusive.
The validateClasses
utility makes this easy by allowing you to define a simple array of exclusive class groups. Only one class in each group is allowed to be applied, otherwise a console error will be thrown. Console errors only display when craft.app.config.general.devMode
is enabled for performance reasons.
In the above example, you'll see the console error The following CSS classes cannot be combined on this element: "foo--alpha" and "foo--beta"
because those two classes are in the same group.
Customization
If you want to use Bits components directly as described in the examples above, that’s just fine. However, you may find it valuable to create your own custom components that provide a thin layer of abstraction over Bits, making them more plug-and-play for your project.
Here’s an example:
my-project/templates/_macros/forms.twig
my-project/templates/index.twig
Now every time you call your custom macro, you can pass it any of the same options you would pass directly to Bits, but you can be sure that it will always have the correct class and default options applied.
Brought to you by Chris Malven