README

简单双向列表框用于Yii框架2.0或更高版本

描述

edwinhaq\simpleduallistbox\SimpleDualListbox小部件是一种简单的方式来控制列表框项目

要求

• Yii版本2.0.0或更高

安装

通过composer安装此扩展是首选方式。

运行以下命令之一

php composer.phar require --prefer-dist edwinhaq/yii2-simple-dual-listbox "*"

或

"edwinhaq/yii2-simple-dual-listbox": "*"

将以下内容添加到您的composer.json文件的require部分。

用法

一旦安装了此扩展，只需在您的代码中使用它即可

	use edwinhaq\simpleduallistbox\SimpleDualListbox;

	// ... Form definition

	$items = ['1' => 'Item1', '2' => 'Item2', '3' => 'Item3',];

	$options = [];
	$options['size'] = 10;
	$options['style'] = 'width:200px';
	$options['options'] = [];		// If 'title' not defined SimpleDualListbox defines it for each option item

	$clientOptions = [];
	$clientOptions['availableListboxPosition'] = "left"; 	// options: left (default), right
	$clientOptions['availableListSort'] = SimpleDualListbox::$SORT_NUM_ASC;
	$clientOptions['upButtonText'] = "UP";
	$clientOptions['addButtonText'] = "ADD";
	$clientOptions['addAllButtonText'] = "ADDALL";
	$clientOptions['remAllButtonText'] = "REMALL";
	$clientOptions['remButtonText'] = "REM";
	$clientOptions['downButtonText'] =  "DOWN";
	$clientOptions['selectedLabel'] =  "Selected";
	$clientOptions['availableLabel'] = "Available";

	$widgetOptions = [];
	$widgetOptions['label'] = 'InputLabel'; // Ignored when model is used
	$widgetOptions['name'] = 'InputName'; // Ignored when model is used
	$widgetOptions['hint'] = 'Hint'; // Ignored when model is used
	$widgetOptions['selection'] = [1,2]; // Ignored when model is used
	$widgetOptions['id'] = 'Input ID'; // Optional
	$widgetOptions['template'] = '{label}{listbox}{hint}'; // Used to generate element, by default '{label}{listbox}{hint}'
	$widgetOptions['useGroupDiv'] = true; // true by default. Wrap element in a div tag: <div class="form-group"> ... </div>,
	$widgetOptions['items'] = $items;
	$widgetOptions['options'] = $options;
	$widgetOptions['clientOptions'] = $clientOptions;

	/*
	* With model
	*/
	$model->attribute = [1,2];

	$field = $form->field($model, 'attribute')->widget(SimpleDualListbox::className(), $widgetOptions);

	/*
	* Without model
	*/

	echo SimpleDualListbox::widget($widgetOptions);

	// ... End form definition

历史记录

• 版本1.0.0 (2017-05-28)
  • 在Yii 2.0.6上测试
• 版本1.0.1 (2017-10-31)
  • 在Yii 2.0.12上测试
• 版本1.0.2 (2018-02-28)
  • 在Yii 2.0.13.1上测试
• 版本1.0.3 (2018-03-22)
  • 在Yii 2.0.15.1上测试