PHPFUI/InstaDoc
 
Copied!
<?php

namespace PHPFUI;

/**
 * Wrapper for a carousel http://kenwheeler.github.io/slick/
 *
 * To use, you will need to add the correct css and fonts from the subtrees/kenwheeler/slick directory
 */
class SlickSlider extends \PHPFUI\HTML5Element
	{
	use \PHPFUI\Traits\Page;

	/** @var array<string, string> */
	private array $attributes = [];

	/** @var array<string, string> */
	private array $slides = [];

	/**
	 * @param \PHPFUI\Interfaces\Page $page to add JS
	 */
	public function __construct(protected \PHPFUI\Interfaces\Page $page)
		{
		parent::__construct('div');
		$this->addClass('slick-slider');
		$page->addStyleSheet('slick/slick.css');
		$page->addTailScript('slick/slick.min.js');
		}

	/**
	 * Add an image and alt text to the slider
	 *
	 * @param string $image path/filename of image to add
	 * @param string $alt caption
	 */
	public function addImage(string $image, string $alt = '') : SlickSlider
		{
		$extra = '';

		if (empty($alt))
			{
			$alt = $image;
			}
		else
			{
			$extra = "<div>{$alt}</div>";
			}

		return $this->addSlide("<img src='{$image}' alt='{$alt}'>{$extra}");
		}

	/**
	 * Add a free form slide of html
	 */
	public function addSlide(string $html) : static
		{
		$this->slides[] = $html;

		return $this;
		}

	/**
	 * Add an attribute as defined by the slider
	 *
	 * @param mixed $value of any type
	 */
	public function addSliderAttribute(string $attribute, mixed $value = '') : static
		{
		$this->attributes[$attribute] = $value;

		return $this;
		}

	/**
	 * Return the number of slides
	 *
	 */
	public function count() : int
		{
		return \count($this->slides);
		}

	protected function getBody() : string
		{
		$active = ' class="slick-slide slick-current slick-active" aria-hidden="false"';
		$output = '';

		foreach ($this->slides as $slide)
			{
			$output .= "<div{$active}>{$slide}</div>";
			$active = ' class="slick-slide" aria-hidden="true"';
			}

		return $output;
		}

	protected function getStart() : string
		{
		$js = '$("#' . $this->getId() . '").slick(' . \PHPFUI\TextHelper::arrayToJS($this->attributes) . ');$("#' . $this->getId() . '").show();';
		$this->page->addJavaScript($js);

		return parent::getStart();
		}
	}
© 2026 Bruce Wells
Search Namespaces \ Classes
Configuration