Guides

ImageDirective extends BaseDirective
in package

FinalYes

Renders an image, example :

.. image:: image.jpg :width: 100 :title: An image

Attributes
#[Option]
$name: 'width'
$description: 'Width of the image in pixels'
#[Option]
$name: 'height'
$description: 'Height of the image in pixels'
#[Option]
$name: 'alt'
$description: 'Alternative text for the image'
#[Option]
$name: 'scale'
$description: 'Scale of the image, e.g. 0.5 for half size'
#[Option]
$name: 'target'
$description: 'Target for the image, e.g. a link to the image'
#[Option]
$name: 'class'
$description: 'CSS class to apply to the image'
#[Option]
$name: 'name'
$description: 'Name of the image, used for references'
#[Option]
$name: 'align'
$description: 'Alignment of the image, e.g. left, right, center'

Table of Contents

Constants

REFERENCE_ESCAPED_REGEX  : mixed = '/^`([^`]+)`_$/'
REFERENCE_REGEX  : mixed = '/^([a-zA-Z0-9-_]+)_$/'

Properties

$documentNameResolver  : DocumentNameResolverInterface

Methods

__construct()  : mixed
createNode()  : Node|null
getAliases()  : array<string|int, string>
Allow a directive to be registered under multiple names.
getName()  : string
Get the directive name
process()  : Node|null
This is the function called by the parser to process the directive, it can be overloaded to do anything with the document, like tweaking nodes or change the parser context
processNode()  : Node
This can be overloaded to write a directive that just create one node for the document, which is common
optionsToArray()  : array<string, scalar|null>
readAllOptions()  : array<string, scalar|array<string|int, scalar>|null>
readOption()  : mixed
Gets an option value from a directive based on attribute configuration.
resolveLinkTarget()  : LinkInlineNode

Constants

Properties

Methods

getAliases()

Allow a directive to be registered under multiple names.

public getAliases() : array<string|int, string>

Aliases can be used for directives whose name has been deprecated or allows for multiple spellings.

Return values
array<string|int, string>

getName()

Get the directive name

public getName() : string
Return values
string

process()

This is the function called by the parser to process the directive, it can be overloaded to do anything with the document, like tweaking nodes or change the parser context

public process(BlockContext $blockContext, Directive $directive) : Node|null

The node that directly follows the directive is also passed to it

Parameters
$blockContext : BlockContext

the current document context with the content of the directive

$directive : Directive

parsed directive containing options and variable

Return values
Node|null

optionsToArray()

protected optionsToArray(array<string|int, DirectiveOption> $options) : array<string, scalar|null>
Parameters
$options : array<string|int, DirectiveOption>
Return values
array<string, scalar|null>

readAllOptions()

protected final readAllOptions(Directive $directive) : array<string, scalar|array<string|int, scalar>|null>
Parameters
$directive : Directive
Return values
array<string, scalar|array<string|int, scalar>|null>

readOption()

Gets an option value from a directive based on attribute configuration.

protected final readOption(Directive $directive, string $optionName) : mixed

Looks up the option in the directive and returns its value converted to the appropriate type based on the Option attribute defined on this directive class. If the option is not present in the directive, returns the default value from the attribute.

Parameters
$directive : Directive

The directive containing the options

$optionName : string

The name of the option to retrieve

Return values
mixed —

The option value converted to the appropriate type, or the default value

On this page

Search results