Navigation.php

Show:

inherited

Classes
- \Zend_Navigation

Table of Contents

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to [email protected] so we can send you a copy immediately.

Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Package: Zend_Navigation
Version: $Id: Navigation.php 25024 2012-07-30 15:08:15Z rob $

\Zend_Navigation
jump to top

Package: Zend\Navigation

A simple container class for {@link Zend_Navigation_Page} pages

Container class for Zend_Navigation_Page classes.

Parent(s): \Zend_Navigation_Container
Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License

Properties

bool $_dirtyIndex = false

inherited

Whether index is dirty and needs to be re-arranged

Inherited from: \Zend_Navigation_Container::$$_dirtyIndex

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Navigation_Container::$$_dirtyIndex

array $_index = array()

inherited

An index that contains the order in which to iterate pages

Inherited from: \Zend_Navigation_Container::$$_index

Default valuearray()Details

Type: array
Inherited_from: \Zend_Navigation_Container::$$_index

array $_pages = array()

inherited

Contains sub pages

Inherited from: \Zend_Navigation_Container::$$_pages

Default valuearray()Details

Type: array
Inherited_from: \Zend_Navigation_Container::$$_pages

Methods

__call(string $method, array $arguments) : mixed

inherited

Magic overload: Proxy calls to finder methods

Inherited from: \Zend_Navigation_Container::__call()

Examples of finder calls:

// METHOD                         // SAME AS
$nav->findByLabel('foo');         // $nav->findOneBy('label', 'foo');
$nav->findByLabel('/foo/', true); // $nav->findBy('label', '/foo/', true);
$nav->findOneByLabel('foo');      // $nav->findOneBy('label', 'foo');
$nav->findAllByClass('foo');      // $nav->findAllBy('class', 'foo');

Parameters

Name	Type	Description
$method	string	method name
$arguments	array	method arguments

Returns

Type	Description
mixed	Zend_Navigation\|array\|null matching page, array of pages or null

Throws

Exception	Description
\Zend_Navigation_Exception	if method does not exist

__construct(array | \Zend_Config $pages = null) : void

Creates a new navigation container

Parameters

Name	Type	Description
$pages	array \| \Zend_Config	[optional] pages to add

Throws

Exception	Description
\Zend_Navigation_Exception	if $pages is invalid

_sort() : void

inherited

Sorts the page index according to page order

Inherited from: \Zend_Navigation_Container::_sort()

addPage(\Zend_Navigation_Page | array | \Zend_Config $page) : \Zend_Navigation_Container

inherited

Adds a page to the container

Inherited from: \Zend_Navigation_Container::addPage()

This method will inject the container as the given page's parent by calling Zend_Navigation_Page::setParent().

Parameters

Name	Type	Description
$page	\Zend_Navigation_Page \| array \| \Zend_Config	page to add

Returns

Type	Description
\Zend_Navigation_Container	fluent interface, returns self

Throws

Exception	Description
\Zend_Navigation_Exception	if page is invalid

addPages(array | \Zend_Config | \Zend_Navigation_Container $pages) : \Zend_Navigation_Container

inherited

Adds several pages at once

Inherited from: \Zend_Navigation_Container::addPages()

Parameters

Name	Type	Description
$pages	array \| \Zend_Config \| \Zend_Navigation_Container	pages to add

Returns

Type	Description
\Zend_Navigation_Container	fluent interface, returns self

Throws

Exception	Description
\Zend_Navigation_Exception	if $pages is not array, Zend_Config or Zend_Navigation_Container

count() : int

inherited

Returns number of pages in container

Inherited from: \Zend_Navigation_Container::count()

Implements Countable interface.

Returns

Type	Description
int	number of pages in the container

current() : \Zend_Navigation_Page

inherited

Returns current page

Inherited from: \Zend_Navigation_Container::current()

Implements RecursiveIterator interface.

Returns

Type	Description
\Zend_Navigation_Page	current page or null

Throws

Exception	Description
\Zend_Navigation_Exception	if the index is invalid

findAllBy(string $property, mixed $value, bool $useRegex = false) : array

inherited

Returns all child pages matching $property == $value or preg_match($value, $property), or an empty array if no pages are found

Inherited from: \Zend_Navigation_Container::findAllBy()

Parameters

Name	Type	Description
$property	string	name of property to match against
$value	mixed	value to match property against
$useRegex	bool	[optional] if true PHP's preg_match is used. Default is false.

Returns

Type	Description
array	array containing only Zend_Navigation_Page instances

findBy(string $property, mixed $value, bool $all = false, bool $useRegex = false) : \Zend_Navigation_Page | null

inherited

Returns page(s) matching $property == $value or preg_match($value, $property)

Inherited from: \Zend_Navigation_Container::findBy()

Parameters

Name	Type	Description
$property	string	name of property to match against
$value	mixed	value to match property against
$all	bool	[optional] whether an array of all matching pages should be returned, or only the first. If true, an array will be returned, even if not matching pages are found. If false, null will be returned if no matching page is found. Default is false.
$useRegex	bool	[optional] if true PHP's preg_match is used. Default is false.

Returns

Type	Description
\Zend_Navigation_Page \| null	matching page or null

findOneBy(string $property, mixed $value, bool $useRegex = false) : \Zend_Navigation_Page | null

inherited

Returns a child page matching $property == $value or preg_match($value, $property), or null if not found

Inherited from: \Zend_Navigation_Container::findOneBy()

Parameters

Name	Type	Description
$property	string	name of property to match against
$value	mixed	value to match property against
$useRegex	bool	[optional] if true PHP's preg_match is used. Default is false.

Returns

Type	Description
\Zend_Navigation_Page \| null	matching page or null

getChildren() : \Zend_Navigation_Page | null

inherited

Returns the child container.

Inherited from: \Zend_Navigation_Container::getChildren()

Implements RecursiveIterator interface.

Returns

Type	Description
\Zend_Navigation_Page \| null

getPages() : array

inherited

Returns pages in the container

Inherited from: \Zend_Navigation_Container::getPages()

Returns

Type	Description
array	array of Zend_Navigation_Page instances

hasChildren() : bool

inherited

Proxy to hasPages()

Inherited from: \Zend_Navigation_Container::hasChildren()

Implements RecursiveIterator interface.

Returns

Type	Description
bool	whether container has any pages

hasPage(\Zend_Navigation_Page $page, bool $recursive = false) : bool

inherited

Checks if the container has the given page

Inherited from: \Zend_Navigation_Container::hasPage()

Parameters

Name	Type	Description
$page	\Zend_Navigation_Page	page to look for
$recursive	bool	[optional] whether to search recursively. Default is false.

Returns

Type	Description
bool	whether page is in container

hasPages() : bool

inherited

Returns true if container contains any pages

Inherited from: \Zend_Navigation_Container::hasPages()

Returns

Type	Description
bool	whether container has any pages

key() : string

inherited

Returns hash code of current page

Inherited from: \Zend_Navigation_Container::key()

Implements RecursiveIterator interface.

Returns

Type	Description
string	hash code of current page

next() : void

inherited

Moves index pointer to next page in the container

Inherited from: \Zend_Navigation_Container::next()

Implements RecursiveIterator interface.

notifyOrderUpdated() : void

inherited

Notifies container that the order of pages are updated

Inherited from: \Zend_Navigation_Container::notifyOrderUpdated()

removePage(\Zend_Navigation_Page | int $page) : bool

inherited

Removes the given page from the container

Inherited from: \Zend_Navigation_Container::removePage()

Parameters

Name	Type	Description
$page	\Zend_Navigation_Page \| int	page to remove, either a page instance or a specific page order

Returns

Type	Description
bool	whether the removal was successful

removePages() : \Zend_Navigation_Container

inherited

Removes all pages in container

Inherited from: \Zend_Navigation_Container::removePages()

Returns

Type	Description
\Zend_Navigation_Container	fluent interface, returns self

rewind() : void

inherited

Sets index pointer to first page in the container

Inherited from: \Zend_Navigation_Container::rewind()

Implements RecursiveIterator interface.

setPages(array $pages) : \Zend_Navigation_Container

inherited

Sets pages this container should have, removing existing pages

Inherited from: \Zend_Navigation_Container::setPages()

Parameters

Name	Type	Description
$pages	array	pages to set

Returns

Type	Description
\Zend_Navigation_Container	fluent interface, returns self

toArray() : array

inherited

Returns an array representation of all pages in container

Inherited from: \Zend_Navigation_Container::toArray()

Returns

Type	Description
array

valid() : bool

inherited

Checks if container index is valid

Inherited from: \Zend_Navigation_Container::valid()

Implements RecursiveIterator interface.

Returns

Type	Description
bool

Navigation.php

\Zend_Navigationjump to top

Properties

Methods

\Zend_Navigation
jump to top