Merge pull request #18 from WinterSilence/patch-1

ActiveField: add rangeInput(), colorInput() and switch mode to checkbox()
This commit is contained in:
simialbi 2021-11-25 10:24:43 +01:00 committed by GitHub
commit 1856e3a33d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 122 additions and 17 deletions

View File

@ -4,7 +4,7 @@ Yii Framework 2 bootstrap5 extension Change Log
2.0.3 under development 2.0.3 under development
----------------------- -----------------------
- no changes in this release. - Enh #18: Add rangeInput(), colorInput() and switch mode to checkbox() in class ActiveField (WinterSilence)
2.0.2 October 21, 2021 2.0.2 October 21, 2021

View File

@ -26,6 +26,11 @@ framework features. All widgets belong to `\yii\bootstrap5` namespace:
- [[yii\bootstrap5\Toast|Toast]] - [[yii\bootstrap5\Toast|Toast]]
- [[yii\bootstrap5\ToggleButtonGroup|ToggleButtonGroup]] - [[yii\bootstrap5\ToggleButtonGroup|ToggleButtonGroup]]
## ActiveField: additional fields <span id="additional-fields"></span>
- [Range](https://getbootstrap.com/docs/5.1/forms/range/): `$form->rangeInput(['min' => 0, 'max' => 100, 'step' => 1])`
- [Color picker](https://getbootstrap.com/docs/5.1/forms/form-control/#color): `$form->colorInput()`
- [Switch](https://getbootstrap.com/docs/5.1/forms/checks-radios/#switches): `$form->checkbox(['switch' => true])`
## Customizing widget CSS classes <span id="customizing-css-classes"></span> ## Customizing widget CSS classes <span id="customizing-css-classes"></span>

View File

@ -166,6 +166,10 @@ class ActiveField extends \yii\widgets\ActiveField
* @var string the template for checkboxes in default layout * @var string the template for checkboxes in default layout
*/ */
public $checkTemplate = "<div class=\"form-check\">\n{input}\n{label}\n{error}\n{hint}\n</div>"; public $checkTemplate = "<div class=\"form-check\">\n{input}\n{label}\n{error}\n{hint}\n</div>";
/**
* @var string the template forswitches (custom checkboxes) in default layout
*/
public $switchTemplate = "<div class=\"form-check form-switch\">\n{input}\n{label}\n{error}\n{hint}\n</div>";
/** /**
* @var string the template for radios in default layout * @var string the template for radios in default layout
* @since 2.0.5 * @since 2.0.5
@ -175,6 +179,10 @@ class ActiveField extends \yii\widgets\ActiveField
* @var string the template for checkboxes and radios in horizontal layout * @var string the template for checkboxes and radios in horizontal layout
*/ */
public $checkHorizontalTemplate = "{beginWrapper}\n<div class=\"form-check\">\n{input}\n{label}\n{error}\n{hint}\n</div>\n{endWrapper}"; public $checkHorizontalTemplate = "{beginWrapper}\n<div class=\"form-check\">\n{input}\n{label}\n{error}\n{hint}\n</div>\n{endWrapper}";
/**
* @var string the template for switches (custom checkboxes) in horizontal layout
*/
public $switchHorizontalTemplate = "{beginWrapper}\n<div class=\"form-check form-switch\">\n{input}\n{label}\n{error}\n{hint}\n</div>\n{endWrapper}";
/** /**
* @var string the template for checkboxes and radios in horizontal layout * @var string the template for checkboxes and radios in horizontal layout
* @since 2.0.5 * @since 2.0.5
@ -184,6 +192,10 @@ class ActiveField extends \yii\widgets\ActiveField
* @var string the `enclosed by label` template for checkboxes and radios in default layout * @var string the `enclosed by label` template for checkboxes and radios in default layout
*/ */
public $checkEnclosedTemplate = "<div class=\"form-check\">\n{beginLabel}\n{input}\n{labelTitle}\n{endLabel}\n{error}\n{hint}\n</div>"; public $checkEnclosedTemplate = "<div class=\"form-check\">\n{beginLabel}\n{input}\n{labelTitle}\n{endLabel}\n{error}\n{hint}\n</div>";
/**
* @var string tthe `enclosed by label` template for switches(custom checkboxes) in default layout
*/
public $switchEnclosedTemplate = "<div class=\"form-check form-switch\">\n{beginLabel}\n{input}\n{labelTitle}\n{endLabel}\n{error}\n{hint}\n</div>";
/** /**
* @var bool whether to render the error. Default is `true` except for layout `inline`. * @var bool whether to render the error. Default is `true` except for layout `inline`.
*/ */
@ -245,6 +257,8 @@ class ActiveField extends \yii\widgets\ActiveField
/** /**
* {@inheritdoc} * {@inheritdoc}
* Enable option `switch` to render as toggle switch.
* @see https://getbootstrap.com/docs/5.1/forms/checks-radios/#switches
*/ */
public function checkbox($options = [], $enclosedByLabel = false) public function checkbox($options = [], $enclosedByLabel = false)
{ {
@ -255,21 +269,31 @@ class ActiveField extends \yii\widgets\ActiveField
Html::removeCssClass($options, 'form-control'); Html::removeCssClass($options, 'form-control');
$this->labelOptions = ArrayHelper::merge($this->labelOptions, $labelOptions); $this->labelOptions = ArrayHelper::merge($this->labelOptions, $labelOptions);
$this->wrapperOptions = ArrayHelper::merge($this->wrapperOptions, $wrapperOptions); $this->wrapperOptions = ArrayHelper::merge($this->wrapperOptions, $wrapperOptions);
$switch = isset($options['switch']) && $options['switch'];
if ($switch) {
$this->addRoleAttributes($options, 'switch');
}
if (!isset($options['template'])) { if (!isset($options['template'])) {
$this->template = ($enclosedByLabel) ? $this->checkEnclosedTemplate : $this->checkTemplate; if ($switch) {
$this->template = $enclosedByLabel ? $this->switchEnclosedTemplate : $this->switchTemplate;
} else {
$this->template = $enclosedByLabel ? $this->checkEnclosedTemplate : $this->checkTemplate;
}
} else { } else {
$this->template = $options['template']; $this->template = $options['template'];
} }
if ($this->form->layout === ActiveForm::LAYOUT_HORIZONTAL) { if ($this->form->layout === ActiveForm::LAYOUT_HORIZONTAL) {
if (!isset($options['template'])) { if (!isset($options['template'])) {
$this->template = $this->checkHorizontalTemplate; $this->template = ($switch)
? $this->switchHorizontalTemplate
: $this->checkHorizontalTemplate;
} }
Html::removeCssClass($this->labelOptions, $this->horizontalCssClasses['label']); Html::removeCssClass($this->labelOptions, $this->horizontalCssClasses['label']);
Html::addCssClass($this->wrapperOptions, $this->horizontalCssClasses['offset']); Html::addCssClass($this->wrapperOptions, $this->horizontalCssClasses['offset']);
} }
Html::removeCssClass($this->labelOptions, 'form-label'); Html::removeCssClass($this->labelOptions, 'form-label');
unset($options['template']); unset($options['template'], $options['switch']);
if ($enclosedByLabel) { if ($enclosedByLabel) {
if (isset($options['label'])) { if (isset($options['label'])) {
@ -482,6 +506,41 @@ class ActiveField extends \yii\widgets\ActiveField
return parent::fileInput($options); return parent::fileInput($options);
} }
/**
* Renders a range (custom input).
*
* @param array $options the tag options in terms of name-value pairs:
*
* - 'min': min. value
* - 'max': max. value
* - 'step': range step, by default, 1
*
* @return $this
* @see https://getbootstrap.com/docs/5.1/forms/range/
*/
public function rangeInput(array $options = [])
{
Html::removeCssClass($options, 'form-control');
Html::addCssClass($options, ['widget' => 'form-range']);
return $this->input('range', $options);
}
/**
* Renders a color picker (custom input).
*
* @param array $options the tag options in terms of name-value pairs
* @return $this
* @see https://getbootstrap.com/docs/5.1/forms/form-control/#color
*/
public function colorInput(array $options = [])
{
Html::removeCssClass($options, 'form-control');
Html::addCssClass($options, ['widget' => 'form-control form-control-color']);
return $this->input('color', $options);
}
/** /**
* @param array $instanceConfig the configuration passed to this instance's constructor * @param array $instanceConfig the configuration passed to this instance's constructor
* @return array the layout specific default configuration for this instance * @return array the layout specific default configuration for this instance

View File

@ -28,7 +28,6 @@ class ActiveFieldTest extends TestCase
public function testFileInput() public function testFileInput()
{ {
Html::$counter = 0;
$html = $this->activeField->fileInput()->render(); $html = $this->activeField->fileInput()->render();
$expectedHtml = <<<HTML $expectedHtml = <<<HTML
@ -36,6 +35,38 @@ class ActiveFieldTest extends TestCase
<label class="form-label" for="dynamicmodel-attributename">Attribute Name</label> <label class="form-label" for="dynamicmodel-attributename">Attribute Name</label>
<input type="hidden" name="DynamicModel[attributeName]" value=""><input type="file" id="dynamicmodel-attributename" class="form-control" name="DynamicModel[attributeName]"> <input type="hidden" name="DynamicModel[attributeName]" value=""><input type="file" id="dynamicmodel-attributename" class="form-control" name="DynamicModel[attributeName]">
<div class="invalid-feedback"></div>
</div>
HTML;
$this->assertEqualsWithoutLE($expectedHtml, $html);
}
public function testRangeInput()
{
$html = $this->activeField->rangeInput()->render();
$expectedHtml = <<<HTML
<div class="mb-3 field-dynamicmodel-attributename">
<label class="form-label" for="dynamicmodel-attributename">Attribute Name</label>
<input type="range" id="dynamicmodel-attributename" class="form-range" name="DynamicModel[attributeName]">
<div class="invalid-feedback"></div>
</div>
HTML;
$this->assertEqualsWithoutLE($expectedHtml, $html);
}
public function testColorInput()
{
$html = $this->activeField->colorInput()->render();
$expectedHtml = <<<HTML
<div class="mb-3 field-dynamicmodel-attributename">
<label class="form-label" for="dynamicmodel-attributename">Attribute Name</label>
<input type="color" id="dynamicmodel-attributename" class="form-control form-control-color" name="DynamicModel[attributeName]">
<div class="invalid-feedback"></div> <div class="invalid-feedback"></div>
</div> </div>
HTML; HTML;
@ -45,7 +76,6 @@ HTML;
public function testRadioList() public function testRadioList()
{ {
Html::$counter = 0;
$html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render();
$expectedHtml = <<<HTML $expectedHtml = <<<HTML
@ -72,7 +102,6 @@ HTML;
public function testRadioError() public function testRadioError()
{ {
Html::$counter = 0;
$this->helperModel->addError($this->attributeName, 'Test print error message'); $this->helperModel->addError($this->attributeName, 'Test print error message');
$html = $this->activeField->radio()->render(); $html = $this->activeField->radio()->render();
@ -91,7 +120,6 @@ HTML;
public function testRadioListError() public function testRadioListError()
{ {
Html::$counter = 0;
$this->helperModel->addError($this->attributeName, 'Test print error message'); $this->helperModel->addError($this->attributeName, 'Test print error message');
$html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render();
@ -117,7 +145,6 @@ HTML;
public function testCheckboxList() public function testCheckboxList()
{ {
Html::$counter = 0;
$html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render();
$expectedHtml = <<<HTML $expectedHtml = <<<HTML
@ -135,6 +162,26 @@ HTML;
</div> </div>
</div> </div>
</div>
HTML;
$this->assertEqualsWithoutLE($expectedHtml, $html);
}
/**
* @test checkbox
*/
public function testCheckboxSwitch()
{
$html = $this->activeField->checkbox(['switch' => true])->render();
$expectedHtml = <<<HTML
<div class="mb-3 field-dynamicmodel-attributename">
<div class="form-check form-switch">
<input type="hidden" name="DynamicModel[attributeName]" value="0"><input type="checkbox" id="dynamicmodel-attributename" class="form-check-input" name="DynamicModel[attributeName]" value="1" role="switch">
<label class="form-check-label" for="dynamicmodel-attributename">Attribute Name</label>
<div class="invalid-feedback"></div>
</div>
</div> </div>
HTML; HTML;
$this->assertEqualsWithoutLE($expectedHtml, $html); $this->assertEqualsWithoutLE($expectedHtml, $html);
@ -142,7 +189,6 @@ HTML;
public function testCheckboxError() public function testCheckboxError()
{ {
Html::$counter = 0;
$this->helperModel->addError($this->attributeName, 'Test print error message'); $this->helperModel->addError($this->attributeName, 'Test print error message');
$html = $this->activeField->checkbox()->render(); $html = $this->activeField->checkbox()->render();
@ -161,7 +207,6 @@ HTML;
public function testCheckboxListError() public function testCheckboxListError()
{ {
Html::$counter = 0;
$this->helperModel->addError($this->attributeName, 'Test print error message'); $this->helperModel->addError($this->attributeName, 'Test print error message');
$html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render();
@ -187,7 +232,6 @@ HTML;
public function testRadioListInline() public function testRadioListInline()
{ {
Html::$counter = 0;
$this->activeField->inline = true; $this->activeField->inline = true;
$html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->radioList([1 => 'name1', 2 => 'name2'])->render();
@ -213,7 +257,6 @@ HTML;
public function testCheckboxListInline() public function testCheckboxListInline()
{ {
Html::$counter = 0;
$this->activeField->inline = true; $this->activeField->inline = true;
$html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render(); $html = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'])->render();
@ -238,12 +281,10 @@ HTML;
} }
/** /**
*
* @see https://github.com/yiisoft/yii2-bootstrap/issues/81 * @see https://github.com/yiisoft/yii2-bootstrap/issues/81
*/ */
public function testRadioListItemOptions() public function testRadioListItemOptions()
{ {
Html::$counter = 0;
$content = $this->activeField->radioList([1 => 'name1', 2 => 'name2'], [ $content = $this->activeField->radioList([1 => 'name1', 2 => 'name2'], [
'itemOptions' => [ 'itemOptions' => [
'data-attribute' => 'test' 'data-attribute' => 'test'
@ -259,7 +300,6 @@ HTML;
*/ */
public function testCheckboxListItemOptions() public function testCheckboxListItemOptions()
{ {
Html::$counter = 0;
$content = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'], [ $content = $this->activeField->checkboxList([1 => 'name1', 2 => 'name2'], [
'itemOptions' => [ 'itemOptions' => [
'data-attribute' => 'test' 'data-attribute' => 'test'
@ -274,9 +314,10 @@ HTML;
// dirty way to have Request object not throwing exception when running testHomeLinkNull() // dirty way to have Request object not throwing exception when running testHomeLinkNull()
$_SERVER['SCRIPT_FILENAME'] = "index.php"; $_SERVER['SCRIPT_FILENAME'] = "index.php";
$_SERVER['SCRIPT_NAME'] = "index.php"; $_SERVER['SCRIPT_NAME'] = "index.php";
parent::setUp(); parent::setUp();
Html::$counter = 0;
$this->helperModel = new DynamicModel(['attributeName']); $this->helperModel = new DynamicModel(['attributeName']);
ob_start(); ob_start();
$this->helperForm = ActiveForm::begin(['action' => '/something']); $this->helperForm = ActiveForm::begin(['action' => '/something']);