Jifty::Web::PageRegion - Defines a page region
Describes a region of the page which contains a mason fragment which can be updated via AJAX or via query parameters.
Creates a new page region. The possible arguments in the
The (unqualified) name of the region. This is used to generate a unique id -- it should consist of only letters and numbers.
The path to the fragment that this page region contains.
- defaults (optional)
Specifies an optional set of parameter defaults. These should all be simple scalars, as they might be passed across HTTP if AJAX is used.
- parent (optional)
The parent Jifty::Web::PageRegion that this region is enclosed in.
- region_wrapper (optional)
Gets or sets the name of the page region.
Gets or sets the fully qualified name of the page region. This should be unique on a page. This is usually set by "enter", based on the page regions that this region is inside. See "qualified_region" in Jifty::Web.
Gets or sets the default path of the fragment. This is overridden by "path".
Gets or sets the path that the fragment actually contains. This overrides "default_path".
Gets or sets the default value of the
NAME argument. This is used as a fallback, and also to allow generated links to minimize the amount of state they must transmit.
Gets or sets the actual run-time value of the page region. This usually comes from HTTP parameters. It overrides the "default_argument" of the same
Sets all arguments at once, or returns all arguments. The latter will also include all default arguments.
Enters the region; this sets the qualified name based on "qualified_region" in Jifty::Web, and uses that to pull runtime values for the "path" and "argument"s from the "state_variables" in Jifty::Request.
Exits the page region, if it is the most recent one. Normally, you won't need to call this by hand; however, if you are calling "enter" by hand, you will need to call the corresponding
Returns a CSS2 selector which selects only elements under this region which fit the
RULES. This method is used by AJAX code to specify where to add new regions.