Browse Source
* upstream: Fixes issue #320: Module::createController() will fail with a route with trailing slash. Fixed test break about AssetController. requirements css.php twitter bootstrap update to 2.3.2 Twitter bootstrap updated to 2.3.2 Modified the IAssetConvert interface. hashing the key for registerCss and registerJs. Update AccessRule.php refactored code after feedback Fixed framework path. Added support for View::POS_READY. new proposed structure remove from master (update track) made some changes, fix some pitfalls, remove PHP_EOL #20 proposed architecture for bootstrap Conflicts: yii/helpers/base/Inflector.phptags/2.0.0-alpha
Antonio Ramirez
12 years ago
15 changed files with 3115 additions and 2691 deletions
@ -0,0 +1,286 @@
|
||||
<?php |
||||
/** |
||||
* @link http://www.yiiframework.com/ |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yii\bootstrap; |
||||
|
||||
use Yii; |
||||
use yii\helpers\Html; |
||||
use yii\helpers\ArrayHelper; |
||||
|
||||
/** |
||||
* Modal renders a bootstrap modal on the page for its use on your application. |
||||
* |
||||
* Basic usage: |
||||
* |
||||
* ```php |
||||
* $this->widget(Modal::className(), array( |
||||
* 'id' => 'myModal', |
||||
* 'header' => 'Modal Heading', |
||||
* 'content' => '<p>One fine body...</p>', |
||||
* 'footer' => 'Modal Footer', |
||||
* // if we wish to display a modal button |
||||
* 'buttonOptions' => array( |
||||
* 'label' => 'Show Modal', |
||||
* 'class' => 'btn btn-primary' |
||||
* ) |
||||
* )); |
||||
* ``` |
||||
* @see http://twitter.github.io/bootstrap/javascript.html#modals |
||||
* @author Antonio Ramirez <amigo.cobos@gmail.com> |
||||
* @since 2.0 |
||||
*/ |
||||
class Modal extends Widget |
||||
{ |
||||
/** |
||||
* @var array The additional HTML attributes of the button that will show the modal. If empty array, only |
||||
* the markup of the modal will be rendered on the page, so users can easily call the modal manually with their own |
||||
* scripts. The following special attributes are available: |
||||
* <ul> |
||||
* <li>label: string, the label of the button</li> |
||||
* </ul> |
||||
* |
||||
* For available options of the button trigger, see http://twitter.github.com/bootstrap/javascript.html#modals. |
||||
*/ |
||||
public $buttonOptions = array(); |
||||
|
||||
/** |
||||
* @var boolean indicates whether the modal should use transitions. Defaults to 'true'. |
||||
*/ |
||||
public $fade = true; |
||||
|
||||
/** |
||||
* @var bool $keyboard, closes the modal when escape key is pressed. |
||||
*/ |
||||
public $keyboard = true; |
||||
|
||||
/** |
||||
* @var bool $show, shows the modal when initialized. |
||||
*/ |
||||
public $show = false; |
||||
|
||||
/** |
||||
* @var mixed includes a modal-backdrop element. Alternatively, specify `static` for a backdrop which doesn't close |
||||
* the modal on click. |
||||
*/ |
||||
public $backdrop = true; |
||||
|
||||
/** |
||||
* @var mixed the remote url. If a remote url is provided, content will be loaded via jQuery's load method and |
||||
* injected into the .modal-body of the modal. |
||||
*/ |
||||
public $remote; |
||||
|
||||
/** |
||||
* @var string a javascript function that will be invoked immediately when the `show` instance method is called. |
||||
*/ |
||||
public $onShow; |
||||
|
||||
/** |
||||
* @var string a javascript function that will be invoked when the modal has been made visible to the user |
||||
* (will wait for css transitions to complete). |
||||
*/ |
||||
public $onShown; |
||||
|
||||
/** |
||||
* @var string a javascript function that will be invoked immediately when the hide instance method has been called. |
||||
*/ |
||||
public $onHide; |
||||
|
||||
/** |
||||
* @var string a javascript function that will be invoked when the modal has finished being hidden from the user |
||||
* (will wait for css transitions to complete). |
||||
*/ |
||||
public $onHidden; |
||||
|
||||
/** |
||||
* @var string[] the Javascript event handlers. |
||||
*/ |
||||
protected $events = array(); |
||||
|
||||
/** |
||||
* @var array $pluginOptions the plugin options. |
||||
*/ |
||||
protected $pluginOptions = array(); |
||||
|
||||
/** |
||||
* @var string |
||||
*/ |
||||
public $closeText = '×'; |
||||
|
||||
/** |
||||
* @var string header content. Header can also be a path to a view file. |
||||
*/ |
||||
public $header; |
||||
|
||||
/** |
||||
* @var string body of modal. Body can also be a path to a view file. |
||||
*/ |
||||
public $content; |
||||
|
||||
/** |
||||
* @var string footer content. Content can also be a path to a view file. |
||||
*/ |
||||
public $footer; |
||||
|
||||
/** |
||||
* Widget's init method |
||||
*/ |
||||
public function init() |
||||
{ |
||||
parent::init(); |
||||
|
||||
$this->name = 'modal'; |
||||
|
||||
$this->defaultOption('id', $this->getId()); |
||||
|
||||
$this->defaultOption('role', 'dialog'); |
||||
$this->defaultOption('tabindex', '-1'); |
||||
|
||||
$this->addClassName('modal'); |
||||
$this->addClassName('hide'); |
||||
|
||||
if ($this->fade) |
||||
$this->addClassName('fade'); |
||||
|
||||
$this->initPluginOptions(); |
||||
$this->initPluginEvents(); |
||||
} |
||||
|
||||
/** |
||||
* Initialize plugin events if any |
||||
*/ |
||||
public function initPluginEvents() |
||||
{ |
||||
foreach (array('onShow', 'onShown', 'onHide', 'onHidden') as $event) { |
||||
if ($this->{$event} !== null) { |
||||
$modalEvent = strtolower(substr($event, 2)); |
||||
if ($this->{$event} instanceof JsExpression) |
||||
$this->events[$modalEvent] = $this->$event; |
||||
else |
||||
$this->events[$modalEvent] = new JsExpression($this->{$event}); |
||||
} |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Initialize plugin options. |
||||
* ***Important***: The display of the button overrides the initialization of the modal bootstrap widget. |
||||
*/ |
||||
public function initPluginOptions() |
||||
{ |
||||
if (null !== $this->remote) |
||||
$this->pluginOptions['remote'] = Html::url($this->remote); |
||||
|
||||
foreach (array('backdrop', 'keyboard', 'show') as $option) { |
||||
$this->pluginOptions[$option] = isset($this->pluginOptions[$option]) |
||||
? $this->pluginOptions[$option] |
||||
: $this->{$option}; |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Widget's run method |
||||
*/ |
||||
public function run() |
||||
{ |
||||
$this->renderModal(); |
||||
$this->renderButton(); |
||||
$this->registerScript(); |
||||
} |
||||
|
||||
/** |
||||
* Renders the button that will open the modal if its options have been configured |
||||
*/ |
||||
public function renderButton() |
||||
{ |
||||
if (!empty($this->buttonOptions)) { |
||||
|
||||
$this->buttonOptions['data-toggle'] = isset($this->buttonOptions['data-toggle']) |
||||
? $this->buttonOptions['data-toggle'] |
||||
: 'modal'; |
||||
|
||||
if ($this->remote !== null && !isset($this->buttonOptions['data-remote'])) |
||||
$this->buttonOptions['data-remote'] = Html::url($this->remote); |
||||
|
||||
$label = ArrayHelper::remove($this->buttonOptions, 'label', 'Button'); |
||||
$name = ArrayHelper::remove($this->buttonOptions, 'name'); |
||||
$value = ArrayHelper::remove($this->buttonOptions, 'value'); |
||||
|
||||
$attr = isset($this->buttonOptions['data-remote']) |
||||
? 'data-target' |
||||
: 'href'; |
||||
|
||||
$this->buttonOptions[$attr] = isset($this->buttonOptions[$attr]) |
||||
? $this->buttonOptions[$attr] |
||||
: '#' . ArrayHelper::getValue($this->options, 'id'); |
||||
|
||||
echo Html::button($label, $name, $value, $this->buttonOptions); |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Renders the modal markup |
||||
*/ |
||||
public function renderModal() |
||||
{ |
||||
echo Html::beginTag('div', $this->options); |
||||
|
||||
$this->renderModalHeader(); |
||||
$this->renderModalBody(); |
||||
$this->renderModalFooter(); |
||||
|
||||
echo Html::endTag('div'); |
||||
} |
||||
|
||||
/** |
||||
* Renders the header HTML markup of the modal |
||||
*/ |
||||
public function renderModalHeader() |
||||
{ |
||||
echo Html::beginTag('div', array('class'=>'modal-header')); |
||||
if ($this->closeText) |
||||
echo Html::button($this->closeText, null, null, array('data-dismiss' => 'modal', 'class'=>'close')); |
||||
echo $this->header; |
||||
echo Html::endTag('div'); |
||||
} |
||||
|
||||
/** |
||||
* Renders the HTML markup for the body of the modal |
||||
*/ |
||||
public function renderModalBody() |
||||
{ |
||||
echo Html::beginTag('div', array('class'=>'modal-body')); |
||||
echo $this->content; |
||||
echo Html::endTag('div'); |
||||
} |
||||
|
||||
/** |
||||
* Renders the HTML markup for the footer of the modal |
||||
*/ |
||||
public function renderModalFooter() |
||||
{ |
||||
|
||||
echo Html::beginTag('div', array('class'=>'modal-footer')); |
||||
echo $this->footer; |
||||
echo Html::endTag('div'); |
||||
} |
||||
|
||||
/** |
||||
* Registers client scripts |
||||
*/ |
||||
public function registerScript() |
||||
{ |
||||
// do we render a button? If so, bootstrap will handle its behavior through its |
||||
// mark-up, otherwise, register the plugin. |
||||
if(empty($this->buttonOptions)) |
||||
$this->registerPlugin('modal', $this->pluginOptions); |
||||
|
||||
// register events |
||||
$this->registerEvents($this->events); |
||||
} |
||||
|
||||
} |
||||
@ -0,0 +1,123 @@
|
||||
<?php |
||||
/** |
||||
* @link http://www.yiiframework.com/ |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yii\bootstrap; |
||||
|
||||
use Yii; |
||||
use yii\base\View; |
||||
|
||||
|
||||
/** |
||||
* Bootstrap is the base class for bootstrap widgets. |
||||
* |
||||
* @author Antonio Ramirez <amigo.cobos@gmail.com> |
||||
* @since 2.0 |
||||
*/ |
||||
class Widget extends \yii\base\Widget |
||||
{ |
||||
|
||||
/** |
||||
* @var bool whether to register the asset |
||||
*/ |
||||
public static $responsive = true; |
||||
|
||||
/** |
||||
* @var array the HTML attributes for the widget container tag. |
||||
*/ |
||||
public $options = array(); |
||||
|
||||
/** |
||||
* Initializes the widget. |
||||
*/ |
||||
public function init() |
||||
{ |
||||
// ensure bundle |
||||
$this->registerBundle(static::$responsive); |
||||
} |
||||
|
||||
/** |
||||
* Registers plugin events with the API. |
||||
* @param string $selector the CSS selector. |
||||
* @param string[] $events the JavaScript event configuration (name=>handler). |
||||
* @return boolean whether the events were registered. |
||||
* @todo To be discussed |
||||
*/ |
||||
protected function registerEvents($selector, $events = array()) |
||||
{ |
||||
if (empty($events)) |
||||
return; |
||||
|
||||
$script = ''; |
||||
foreach ($events as $name => $handler) { |
||||
$handler = ($handler instanceof JsExpression) |
||||
? $handler |
||||
: new JsExpression($handler); |
||||
|
||||
$script .= ";jQuery('{$selector}').on('{$name}', {$handler});"; |
||||
} |
||||
if (!empty($script)) |
||||
$this->view->registerJs($script); |
||||
} |
||||
|
||||
/** |
||||
* Registers a specific Bootstrap plugin using the given selector and options. |
||||
* |
||||
* @param string $name the name of the javascript widget to initialize |
||||
* @param array $options the Javascript options for the plugin |
||||
*/ |
||||
public function registerPlugin($name, $options = array()) |
||||
{ |
||||
$selector = '#' . ArrayHelper::getValue($this->options, 'id'); |
||||
$options = !empty($options) ? Json::encode($options) : ''; |
||||
$script = ";jQuery('{$selector}').{$name}({$options});"; |
||||
$this->view->registerJs($script); |
||||
} |
||||
|
||||
/** |
||||
* Registers bootstrap bundle |
||||
* @param bool $responsive |
||||
*/ |
||||
public function registerBundle($responsive = false) |
||||
{ |
||||
$bundle = $responsive ? 'yii/bootstrap-responsive' : 'yii/bootstrap'; |
||||
$this->view->registerAssetBundle($bundle); |
||||
} |
||||
|
||||
|
||||
/** |
||||
* Adds a new class to options. If the class key does not exists, it will create one, if it exists it will append |
||||
* the value and also makes sure the uniqueness of them. |
||||
* |
||||
* @param string $class |
||||
* @return array |
||||
*/ |
||||
protected function addClassName($class) |
||||
{ |
||||
if (isset($this->options['class'])) { |
||||
if (!is_array($this->options['class'])) |
||||
$this->options['class'] = explode(' ', $this->options['class']); |
||||
$this->options['class'][] = $class; |
||||
$this->options['class'] = array_unique($this->options['class']); |
||||
$this->options['class'] = implode(' ', $this->options['class']); |
||||
} else |
||||
$this->options['class'] = $class; |
||||
return $this->options; |
||||
} |
||||
|
||||
/** |
||||
* Sets the default value for an item if not set. |
||||
* @param string $key the name of the item. |
||||
* @param mixed $value the default value. |
||||
* @return array |
||||
*/ |
||||
protected function defaultOption($key, $value) |
||||
{ |
||||
if (!isset($this->options[$key])) |
||||
$this->options[$key] = $value; |
||||
return $this->options; |
||||
} |
||||
} |
||||
@ -1,18 +0,0 @@
|
||||
<?php |
||||
/** |
||||
* @copyright Copyright (c) 2008 Yii Software LLC |
||||
* @link http://www.yiiframework.com/ |
||||
* @license http://www.yiiframework.com/license/ |
||||
*/ |
||||
|
||||
namespace yii\helpers; |
||||
|
||||
/** |
||||
* Inflector pluralizes and singularizes English nouns. It also contains other useful methods. |
||||
* |
||||
* @author Antonio Ramirez <amigo.cobos@gmail.com> |
||||
* @since 2.0 |
||||
*/ |
||||
class Inflector extends base\Inflector |
||||
{ |
||||
} |
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in new issue