mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-07-05 10:59:35 +02:00
ee5b4fd8d3
Introducing <Tabs> component based on react-bootstrap Better support for nested fields in FormBuilder Tweaks to get FormBuilder working with frameworktest BasicFieldsPage fields Added exception in FormBuilder when Component is defined but not found Added check in SingleSelectField for empty value before adding one in Added temporary workaround for CompositeFields with no name (another story to address the actual problem) Added asset_preview_height for File image preview, matches the defined CSS max-height Added documentation to DBFile::PreviewLink() method
140 lines
2.8 KiB
PHP
140 lines
2.8 KiB
PHP
<?php
|
|
|
|
namespace SilverStripe\Forms;
|
|
|
|
use SilverStripe\Core\Convert;
|
|
use InvalidArgumentException;
|
|
|
|
/**
|
|
* Implements a single tab in a {@link TabSet}.
|
|
*
|
|
* Here is a simple implementation of a Tab. Obviously, you can include as much fields
|
|
* inside as you want. A tab can contain other tabs as well.
|
|
*
|
|
* <code>
|
|
* new Tab(
|
|
* $title='Tab one',
|
|
* new HeaderField("A header"),
|
|
* new LiteralField("Lipsum","Lorem ipsum dolor sit amet enim.")
|
|
* )
|
|
* </code>
|
|
*/
|
|
class Tab extends CompositeField {
|
|
|
|
/**
|
|
* Use custom react component
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $schemaComponent = 'TabItem';
|
|
|
|
/**
|
|
* @var TabSet
|
|
*/
|
|
protected $tabSet;
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
protected $id;
|
|
|
|
/**
|
|
* @uses FormField::name_to_label()
|
|
*
|
|
* @param string $name Identifier of the tab, without characters like dots or spaces
|
|
* @param string|FormField $titleOrField Natural language title of the tabset, or first tab.
|
|
* If its left out, the class uses {@link FormField::name_to_label()} to produce a title
|
|
* from the {@link $name} parameter.
|
|
* @param FormField ...$fields All following parameters are inserted as children to this tab
|
|
*/
|
|
public function __construct($name, $titleOrField = null, $fields = null) {
|
|
if(!is_string($name)) {
|
|
throw new InvalidArgumentException('Invalid string parameter for $name');
|
|
}
|
|
|
|
// Get following arguments
|
|
$fields = func_get_args();
|
|
array_shift($fields);
|
|
|
|
// Detect title from second argument, if it is a string
|
|
if($titleOrField && is_string($titleOrField)) {
|
|
$title = $titleOrField;
|
|
array_shift($fields);
|
|
} else {
|
|
$title = static::name_to_label($name);
|
|
}
|
|
|
|
// Remaining arguments are child fields
|
|
parent::__construct($fields);
|
|
|
|
// Assign name and title (not assigned by parent constructor)
|
|
$this->setName($name);
|
|
$this->setTitle($title);
|
|
$this->setID(Convert::raw2htmlid($name));
|
|
}
|
|
|
|
public function ID() {
|
|
if($this->tabSet) {
|
|
return $this->tabSet->ID() . '_' . $this->id;
|
|
} else {
|
|
return $this->id;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set custom HTML ID to use for this tabset
|
|
*
|
|
* @param string $id
|
|
* @return $this
|
|
*/
|
|
public function setID($id) {
|
|
$this->id = $id;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get child fields
|
|
*
|
|
* @return FieldList
|
|
*/
|
|
public function Fields() {
|
|
return $this->children;
|
|
}
|
|
|
|
/**
|
|
* Assign to a TabSet instance
|
|
*
|
|
* @param TabSet $val
|
|
* @return $this
|
|
*/
|
|
public function setTabSet($val) {
|
|
$this->tabSet = $val;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get parent tabset
|
|
*
|
|
* @return TabSet
|
|
*/
|
|
public function getTabSet() {
|
|
return $this->tabSet;
|
|
}
|
|
|
|
public function extraClass() {
|
|
$classes = (array)$this->extraClasses;
|
|
|
|
return implode(' ', $classes);
|
|
}
|
|
|
|
public function getAttributes() {
|
|
return array_merge(
|
|
$this->attributes,
|
|
array(
|
|
'id' => $this->ID(),
|
|
'class' => 'tab ' . $this->extraClass()
|
|
)
|
|
);
|
|
}
|
|
}
|