class views_tabset

class views_tabset {
    var $tabs = array();
    var $extra = '';
    var $selected = NULL;
    
    /**
     * Add a tab to the tabset.
     *
     * @param $name
     *   The name of the tab; this is the internal identifier and must be
     *   unique within the tabset.
     * @param $title
     *   If given, this will be the visible title of the tab. This can also
     *   be set via $tabset->set(). This will be the link to click on to
     *   view the tab.
     * @param $body
     *   If given, this is the body of the tab itself. It will display
     *   when the tab title is clicked on.
     */
    function add($name, $title = '', $body = '') {
        if (is_object($name) && is_subclass_of($name, 'views_tab')) {
            $this->add_tab($name);
        }
        elseif (is_array($name)) {
            foreach ($name as $real_tab) {
                $this->add($real_tab);
            }
        }
        else {
            $this->add_tab(new views_tab($name, $title, $body));
        }
    }
    
    /**
     * Add a fully realized tab object to the tabset.
     *
     * @param $tab
     *   A fully populated views_tab object.
     */
    function add_tab($tab) {
        $this->tabs[$tab->name] = $tab;
    }
    
    /**
     * Set the values of a tab.
     *
     * @param $name
     *   The unique identifier of the tab to set.
     * @param $title
     *   The title of the tab; this will be clickable.
     * @param $body
     *   The HTML body of the tab.
     */
    function set($name, $title, $body = NULL) {
        if (empty($this->tabs[$name])) {
            return $this->add($name, $title, $body);
        }
        $this->tabs[$name]->title = $title;
        if (isset($body)) {
            $this->tabs[$name]->body = $body;
        }
    }
    
    /**
     * Set the body of a tab.
     */
    function set_body($name, $body) {
        if (empty($this->tabs[$name])) {
            return $this->add($name, '', $body);
        }
        $this->tabs[$name]->body = $body;
    }
    
    /**
     * Add text to the 'extra' region of the tabset.
     */
    function add_extra($text) {
        $this->extra .= $text;
    }
    
    /**
     * Remove a tab.
     *
     * @param $tab
     *   May be the name of the tab or a views_tab object.
     */
    function remove($tab) {
        if (is_string($tab)) {
            unset($this->tabs[$tab]);
        }
        else {
            unset($this->tabs[$tab->name]);
        }
    }
    
    /**
     * Control which tab will be selected when it is rendered.
     */
    function set_selected($name) {
        $this->selected = $name;
    }
    
    /**
     * Output the HTML for the tabs.
     *
     * @return
     *   HTML representation of the tabs.
     */
    function render() {
        views_add_js('tabs');
        views_add_css('views-tabs');
        if (empty($this->selected)) {
            $keys = array_keys($this->tabs);
            $this->selected = array_shift($keys);
        }
        drupal_alter('views_tabset', $this);
        return theme('views_tabset', $this->tabs, $this->extra, $this->selected);
    }

}