letsjump / yii2-anchorjs
Add deep anchor links to your Yii docs
Requires
- bower-asset/anchor-js: 4.2.2
- yiisoft/yii2: ~2.0.0
This package is auto-updated.
Last update: 2024-12-16 18:27:53 UTC
README
Yii2 wrapper for AnchorJS that adds deep anchor links to your Yii docs.
Overview
AnchorJS lets you drop deep anchor links (like these) onto any webpage, and be on your way.
You don't need to set up IDs or worry about urls. AnchorJS will respect your IDs if you have them, and generate them if you don't.
It uses an attractive link icon by default, but you can customize the display via options and CSS styling. The examples demonstrate a few customization ideas.
Finally, AnchorJS is lightweight, accessible, and dependency-free.
Example: The bootstrap manual:
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist letsjump/yii2-anchorjs "*"
or add
"letsjump/yii2-anchorjs": "*"
to the require section of your composer.json file.
Usage
Once the extension is installed, simply add this in any view that need it. Please refer to the plugin documentation page for an extended usage guide
<?= \letsjump\AnchorJS\AnchorJS::widget([ 'add' => 'h1, h2', 'options' => [ 'placement'=>'right', 'icon'=>'', // ... refer to https://www.bryanbraun.com/anchorjs/#options for any option available ], ]); ?>
Application wide configuration
You can set an application wide configuration by adding its options to your /app/config/params.php
<?php return [ 'adminEmail' => 'admin@example.com', 'anchorjs' => [ 'placement' => 'left', 'icon' => '' // ... refer to https://www.bryanbraun.com/anchorjs/#options for any option available ], ];