README

yii2-popover-x

基于Krajee的bootstrap-popover-x jQuery插件的Yii Framework 2扩展的扩展popover小部件。该插件是一个扩展的popover jQuery插件，结合了popover和bootstrap modal功能，并包含各种新的样式增强。这个小部件可以像内置的yii\bootstrap\Modal一样设置，还有一些额外的增强。

注意：有关各个版本更改的详细信息，请参阅更改日志。

功能

该插件提供以下增强功能

• 扩展的popover可以像bootstrap modal对话框一样渲染，具有bootstrap popover样式。由于该插件扩展了bootstrap modal，因此bootstrap modal及其所有方法和功能也都可以使用。
• 添加了页脚，包括标题。配置popover的HTML内容的配置就像bootstrap modal一样简单。
• 特别为添加到popover页脚中的bootstrap按钮进行样式设计和间隔。
• 向popover窗口添加关闭图标/按钮。
• 配置各种预构建样式/模板。除了默认（灰色）之外，还可以使用Bootstrap 3上下文颜色样式primary、info、success、danger和warning。
• 根据目标元素控制popover的位置。该插件支持19个不同的位置选项
  • auto
  • auto-left
  • auto-right
  • auto-top
  • auto-bottom
  • horizontal
  • vertical
  • right
  • left
  • top
  • bottom
  • top top-left
  • top top-right
  • bottom bottom-left
  • bottom bottom-right
  • left left-top
  • left left-bottom
  • right right-top
  • right right-bottom
• 特别为每种上下文颜色和popover位置样式化popover箭头，使其保持一致。
• 为控制popover外观和尺寸提供预构建的CSS样式。

注意：此扩展依赖于kartik-v/yii2-widgets扩展，而该扩展又依赖于yiisoft/yii2-bootstrap扩展。请检查此扩展的composer.json以获取此扩展的要求和依赖关系。注意：Yii 2框架仍在积极开发中，直到发布完全稳定的Yii2版本，您的核心yii2-bootstrap包（及其依赖项）在安装或更新此扩展时可能会更新。如果您不希望自动更新依赖项，您可能需要锁定特定应用的composer包版本，并测试扩展是否会中断。

演示

您可以在此处查看有关此扩展用法的详细文档和示例。

安装

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

注意：检查此扩展的依赖和需求，请查看 composer.json。阅读有关为您的应用程序的 composer.json 设置 minimum-stability 的 Web 提示。

运行以下命令之一：

$ php composer.phar require kartik-v/yii2-popover-x "dev-master"

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

"kartik-v/yii2-popover-x": "dev-master"

使用方法

PopoverX

use kartik\popover\PopoverX;

PopoverX::begin([
    'header' => 'Hello world',
    'footer' => Html::button('View', ['class'=>'btn btn-primary']),
    'toggleButton' => ['class'=>'btn btn-primary'],
]);

echo '<p class="text-justify">' .
    'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor.' . 
    '</p>';

PopoverX::end();

许可证

yii2-popover-x 在 BSD 3-Clause 许可证下发布。有关详细信息，请参阅打包的 LICENSE.md 文件。