Error202
/
yii2-bootstrap
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

Merge pull request #415 from creocoder/jui-tabs-rework 

[READY] jQuery UI tabs rework
tags/2.0.0-beta
Qiang Xue 12 years ago
parent
f05f85fcfe c77d3193a5
commit
f3cfc60d6c
1 changed files with 96 additions and 53 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 141
      framework/yii/jui/Tabs.php

141
framework/yii/jui/Tabs.php
Unescape View File

@ -20,15 +20,42 @@ use yii\helpers\Html;
* echo Tabs::widget(array( * echo Tabs::widget(array(
* 'items' => array( * 'items' => array(
* array( * array(
* 'header' => 'One', * 'label' => 'Tab one',
* 'content' => 'Mauris mauris ante, blandit et, ultrices a, suscipit eget...', * 'content' => 'Mauris mauris ante, blandit et, ultrices a, suscipit eget...',
* ), * ),
* array( * array(
* 'header' => 'Two', * 'label' => 'Tab two',
* 'headerOptions' => array(...),
* 'content' => 'Sed non urna. Phasellus eu ligula. Vestibulum sit amet purus...', * 'content' => 'Sed non urna. Phasellus eu ligula. Vestibulum sit amet purus...',
* 'options' => array(...), * 'options' => array(
* 'tag' => 'div',
* ), * ),
* 'headerOptions' => array(
* 'class' => 'my-class',
* ),
* ),
* array(
* 'label' => 'Tab with custom id',
* 'content' => 'Morbi tincidunt, dui sit amet facilisis feugiat...',
* 'options' => array(
* 'id' => 'my-tab',
* ),
* ),
* array(
* 'label' => 'Ajax tab',
* 'url' => array('ajax/content'),
* ),
* ),
* 'options' => array(
* 'tag' => 'div',
* ),
* 'itemOptions' => array(
* 'tag' => 'div',
* ),
* 'headerOptions' => array(
* 'class' => 'my-class',
* ),
* 'clientOptions' => array(
* 'collapsible' => false,
* ), * ),
* )); * ));
* ``` * ```
@ -40,23 +67,44 @@ use yii\helpers\Html;
class Tabs extends Widget class Tabs extends Widget
{ {
/** /**
* @var array list of tabs in the tabs widget. Each array element represents a single * @var array the HTML attributes for the widget container tag. The following special options are recognized:
* tab with the following structure:
* *
* ```php * - tag: string, defaults to "div", the tag name of the container tag of this widget
* array( */
* // required, the header (HTML) of the tab public $options = array();
* 'header' => 'Tab label', /**
* // required, the content (HTML) of the tab * @var array list of tab items. Each item can be an array of the following structure:
* 'content' => 'Mauris mauris ante, blandit et, ultrices a, suscipit eget...', *
* // optional the HTML attributes of the tab content container * - label: string, required, specifies the header link label. When [[encodeLabels]] is true, the label
* 'options'=> array(...), * will be HTML-encoded.
* // optional the HTML attributes of the tab header container * - content: string, the content to show when corresponding tab is clicked. Can be omitted if url is specified.
* 'headerOptions'=> array(...), * - url: mixed, mixed, optional, the url to load tab contents via AJAX. It is required if no content is specified.
* ) * - template: string, optional, the header link template to render the header link. If none specified
* ``` * [[linkTemplate]] will be used instead.
* - options: array, optional, the HTML attributes of the header.
* - headerOptions: array, optional, the HTML attributes for the header container tag.
*/ */
public $items = array(); public $items = array();
/**
* @var array list of HTML attributes for the item container tags. This will be overwritten
* by the "options" set in individual [[items]]. The following special options are recognized:
*
* - tag: string, defaults to "div", the tag name of the item container tags.
*/
public $itemOptions = array();
/**
* @var array list of HTML attributes for the header container tags. This will be overwritten
* by the "headerOptions" set in individual [[items]].
*/
public $headerOptions = array();
/**
* @var string the default header template to render the link.
*/
public $linkTemplate = '<a href="{url}">{label}</a>';
/**
* @var boolean whether the labels for header items should be HTML-encoded.
*/
public $encodeLabels = true;
/** /**
@ -64,53 +112,48 @@ class Tabs extends Widget
*/ */
public function run() public function run()
{ {
echo Html::beginTag('div', $this->options) . "\n"; $options = $this->options;
echo $this->renderHeaders() . "\n"; $tag = ArrayHelper::remove($options, 'tag', 'div');
echo $this->renderContents() . "\n"; echo Html::beginTag($tag, $options) . "\n";
echo Html::endTag('div') . "\n"; echo $this->renderItems() . "\n";
echo Html::endTag($tag) . "\n";
$this->registerWidget('tabs'); $this->registerWidget('tabs');
} }
/** /**
* Renders tabs headers as specified on [[items]]. * Renders tab items as specified on [[items]].
* @return string the rendering result. * @return string the rendering result.
* @throws InvalidConfigException. * @throws InvalidConfigException.
*/ */
protected function renderHeaders() protected function renderItems()
{ {
$headers = array(); $headers = array();
$items = array();
foreach ($this->items as $n => $item) { foreach ($this->items as $n => $item) {
if (!isset($item['header'])) { if (!isset($item['label'])) {
throw new InvalidConfigException("The 'header' option is required."); throw new InvalidConfigException("The 'label' option is required.");
}
$options = ArrayHelper::getValue($item, 'options', array());
$id = isset($options['id']) ? $options['id'] : $this->options['id'] . '-tab' . $n;
$headerOptions = ArrayHelper::getValue($item, 'headerOptions', array());
$headers[] = Html::tag('li', Html::a($item['header'], "#$id"), $headerOptions);
}
return Html::tag('ul', implode("\n", $headers));
} }
if (isset($item['url'])) {
/** $url = Html::url($item['url']);
* Renders tabs contents as specified on [[items]]. } else {
* @return string the rendering result.
* @throws InvalidConfigException.
*/
protected function renderContents()
{
$contents = array();
foreach ($this->items as $n => $item) {
if (!isset($item['content'])) { if (!isset($item['content'])) {
throw new InvalidConfigException("The 'content' option is required."); throw new InvalidConfigException("The 'content' or 'url' option is required.");
} }
$options = ArrayHelper::getValue($item, 'options', array()); $options = array_merge($this->itemOptions, ArrayHelper::getValue($item, 'options', array()));
$tag = ArrayHelper::remove($options, 'tag', 'div');
if (!isset($options['id'])) { if (!isset($options['id'])) {
$options['id'] = $this->options['id'] . '-tab' . $n; $options['id'] = $this->options['id'] . '-tab' . $n;
} }
$contents[] = Html::tag('div', $item['content'], $options); $url = '#' . $options['id'];
$items[] = Html::tag($tag, $item['content'], $options);
} }
$headerOptions = array_merge($this->headerOptions, ArrayHelper::getValue($item, 'headerOptions', array()));
return implode("\n", $contents); $template = ArrayHelper::getValue($item, 'template', $this->linkTemplate);
$headers[] = Html::tag('li', strtr($template, array(
'{label}' => $this->encodeLabels ? Html::encode($item['label']) : $item['label'],
'{url}' => $url,
)), $headerOptions);
}
return Html::tag('ul', implode("\n", $headers)) . "\n" . implode("\n", $items);
} }
} }

Write Preview
Loading…
Cancel
Save