Download the PHP package fabianmichael/kirby-template-attributes without Composer

On this page you can find all versions of the php package fabianmichael/kirby-template-attributes. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of fabianmichael/kirby-template-attributes

Informations about the package kirby-template-attributes

Kirby Template Attributes

Better attribute API for snippets and templates

This plugin brings Vue.js/Laravel-Blade-like attribute composition to the templates of your Kirby project. This is an exploration in search of better HTML attribute handling for nested snippets and components.

[!NOTE] This plugin is completely free and published under the MIT license. However, if you are using it in a commercial project and want to help me keep up with maintenance, please consider to ❤️ sponsor me for securing the continued development of the plugin.

Requirements

Installation

The recommended is installation via composer.

Alternatively, you can also download the plugin and install it manually by copying it to the site/plugins/ folder of your website.

Usage

Basic usage

Use the attributes() helper for generating a string of attributes:

You can also use named arguments if you prefer a leaner syntax. Be aware, that this only works as long as you don’t have dashes in your attribute names:

Or if all you have is an attributes string, you can also feed the that to the attributes() helper:

⚠️ If you need XML-compatible attributes, always call $attributes->toXml() instead of just echoing the Attributes object, because otherwise all attributes will be converted to lower-case.

In many cases, you need to set different classes. The classes() helper is a nice shortcut for improved readability:

The classes() helper is pretty flexible and also accepts multiple paramaters, each of those can eithe be a string or array (but please ensure to write readible code anyways):

Merging attributes

You can also use magic invoke method by calling the Attributes object like a function. This is basically syntactic sugar for passing-down attributes the snipept include chain:

This is the same as:

Output is:

Before/After

You can set $before and $after, just like for Kirby’s Html::attr() helper by using the corresponding methods:

Examples

A button component exists as a snippet in site/snippets/button.php:

A common situation would be the requirement to add attributes when calling the snippet('button') helper class, e.g. class, data-*, title, aria-* etc. Developers cannot handly every possible attribute for each component. The previous attributes() helper could help here:

This works better, but we still cannot extend the class attribute easily. Enter the new attributes() helper:

Even shorter:

This becomes even cooler, because the classes can be assigned conditionally as an array:

This is already cool and makes working with attributes for snippets much easier, e.g. is we use the button in site/snippets/menu.php:

Custom Snippet component

It makes a lot of sense to standardize the usage of this plugin across your project and to reduce boilerplate code. A custom snippet component can help with that by ensuring that the $attr variable is always available:

No longer do your snippets have to include something like $attr ??= [] at the top:

You can event take this a step further by invoking $attr() as a function, which ist a shortcut for attributes([…])->merge($attr):

License

MIT (but you are highly encouraged to ❤️ sponsor me, if this piece of software helps you to pay your bills).

All versions of kirby-template-attributes with dependencies

PHP Build Version
Package Version
Requires getkirby/composer-installer Version ^1.2
ext-dom Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package fabianmichael/kirby-template-attributes contains the following files

Loading the files please wait ...