Joomla CMS
3.10.11 (avec JPlatform 13.1 inclus)
Documentation des API du CMS Joomla en version 3.10.11 et du framework Joomla Platform intégré
|
Fonctions membres publiques | |
compileValue ($value) | |
colorArgs ($args) | |
assertColor ($value, $error="expected color value") | |
assertNumber ($value, $error="expecting number") | |
assertArgs ($value, $expectedArgs, $name="") | |
toBool ($a) | |
lib_red ($color) | |
lib_green ($color) | |
lib_blue ($color) | |
__construct ($fname=null) | |
compile ($string, $name=null) | |
compileFile ($fname, $outFname=null) | |
checkedCompile ($in, $out) | |
cachedCompile ($in, $force=false) | |
parse ($str=null, $initialVariables=null) | |
setFormatter ($name) | |
setPreserveComments ($preserve) | |
registerFunction ($name, $func) | |
unregisterFunction ($name) | |
setVariables ($variables) | |
unsetVariable ($name) | |
setImportDir ($dirs) | |
addImportDir ($dir) | |
allParsedFiles () | |
addParsedFile ($file) | |
throwError ($msg=null) | |
Fonctions membres publiques statiques | |
static | compressList ($items, $delim) |
static | preg_quote ($what) |
static | ccompile ($in, $out, $less=null) |
static | cexecute ($in, $force=false, $less=null) |
Champs de données | |
$vPrefix = '@' | |
$mPrefix = '$' | |
$parentSelector = '&' | |
$importDisabled = false | |
$importDir = '' | |
Attributs publics statiques | |
static | $VERSION = "v0.5.0" |
static | $TRUE = array("keyword", "true") |
static | $FALSE = array("keyword", "false") |
Attributs protégés | |
$libFunctions = array() | |
$registeredVars = array() | |
$preserveComments = false | |
$numberPrecision = null | |
$allParsedFiles = array() | |
$sourceParser = null | |
$sourceLoc = null | |
Attributs protégés statiques | |
static | $nextImportId = 0 |
static | $cssColors |
Fonctions membres privées | |
toLuma ($color) | |
lessphp v0.5.0 http://leafo.net/lessphp
LESS CSS compiler, adapted from http://lesscss.org
Copyright 2013, Leaf Corcoran leafo Licensed under MIT or GPLv3, see LICENSE The LESS compiler and parser. t@gm ail.c om
Converting LESS to CSS is a three stage process. The incoming file is parsed by lessc_parser
into a syntax tree, then it is compiled into another tree representing the CSS structure by lessc
. The CSS tree is fed into a formatter, like lessc_formatter
which then outputs CSS as a string.
During the first compile, all values are reduced, which means that their types are brought to the lowest form before being dump as strings. This handles math equations, variable dereferences, and the like.
The parse
function of lessc
is the entry point.
In summary:
The lessc
class creates an instance of the parser, feeds it LESS code, then transforms the resulting tree to a CSS tree. This class also holds the evaluation context, such as all available mixins and variables at any given time.
The lessc_parser
class is only concerned with parsing its input.
The lessc_formatter
takes a CSS tree, and dumps it to a formatted string, handling things like indentation.
__construct | ( | $fname = null | ) |
Initialize any static state, can initialize parser for a file $opts isn't used yet
Références null.
addImportDir | ( | $dir | ) |
addParsedFile | ( | $file | ) |
Références $file, et allParsedFiles().
Référencé par compileFile(), et tryImport().
allParsedFiles | ( | ) |
Références $allParsedFiles.
Référencé par addParsedFile(), cachedCompile(), et tryImport().
assertArgs | ( | $value, | |
$expectedArgs, | |||
$name = "" |
|||
) |
Références $name, $value, et throwError().
Référencé par lib_extract(), lib_mod(), et lib_pow().
Références $color, $value, coerceColor(), et throwError().
Référencé par colorArgs(), lib_contrast(), lib_hue(), lib_lightness(), lib_mix(), et lib_saturation().
assertNumber | ( | $value, | |
$error = "expecting number" |
|||
) |
Références $value, et throwError().
Référencé par lib_acos(), lib_asin(), lib_atan(), lib_ceil(), lib_contrast(), lib_cos(), lib_extract(), lib_floor(), lib_mod(), lib_percentage(), lib_pow(), lib_round(), lib_sin(), lib_sqrt(), lib_tan(), et lib_unit().
cachedCompile | ( | $in, | |
$force = false |
|||
) |
Execute lessphp on a .less file or a lessphp cache structure
The lessphp cache structure contains information about a specific less file having been parsed. It can be used as a hint for future calls to determine whether or not a rebuild is required.
The cache structure contains two important keys that may be used externally:
compiled: The final compiled CSS updated: The time (in seconds) the CSS was last compiled
The cache structure is a plain-ol' PHP associative array and can be serialized and unserialized without a hitch.
mixed | $in | Input |
bool | $force | Force rebuild? |
Références $root, allParsedFiles(), compileFile(), elseif, et null.
checkedCompile | ( | $in, | |
$out | |||
) |
Références compileFile().
|
protected |
Référencé par funcToColor(), lib_darken(), lib_desaturate(), lib_fade(), lib_fadein(), lib_fadeout(), lib_lighten(), et lib_saturate().
|
protected |
Références $i, $name, $value, $width, et null.
Référencé par assertColor(), compileValue(), evaluate(), lib__sprintf(), lib_alpha(), lib_blue(), lib_contrast(), lib_green(), lib_iscolor(), lib_red(), lib_rgbahex(), reduce(), et toLuma().
|
protected |
Référencé par stringConcatenate(), et tryImport().
colorArgs | ( | $args | ) |
Helper function to get arguments for color manipulation functions. takes a list that contains a color like thing and a percentage
Références $color, et assertColor().
Référencé par lib_darken(), lib_desaturate(), lib_fade(), lib_fadein(), lib_fadeout(), lib_lighten(), lib_saturate(), et lib_spin().
compile | ( | $string, | |
$name = null |
|||
) |
Références $name, $root, compileBlock(), injectVariables(), makeParser(), newFormatter(), et null.
Référencé par compileFile(), et parse().
|
protected |
Recursively compiles a block.
A block is analogous to a CSS block in most cases. A single LESS document is encapsulated in a block when parsed, but it does not have parent tags so all of it's children appear on the root level when compiled.
Blocks are made up of props and children.
Props are property instructions, array tuples which describe an action to be taken, eg. write a property, set a variable, mixin a block.
The children of a block are just all the blocks that are defined within. This is used to look up mixins when performing a mixin.
Compiling the block involves pushing a fresh environment on the stack, and iterating through the props, compiling each one.
Références $name, compileCSSBlock(), compileMedia(), compileNestedBlock(), compileRoot(), compileValue(), null, reduce(), et throwError().
Référencé par compile(), et compileProp().
|
protected |
Références compileProps(), compileSelectors(), makeOutputBlock(), multiplySelectors(), null, popEnv(), et pushEnv().
Référencé par compileBlock().
compileFile | ( | $fname, | |
$outFname = null |
|||
) |
Références $importDir, addParsedFile(), compile(), et null.
Référencé par cachedCompile(), checkedCompile(), et parse().
|
protected |
Références $importDir, $sourceParser, et compileProp().
Référencé par compileProp(), et tryImport().
|
protected |
Références $query, compileMediaQuery(), compileProps(), findClosestSelectors(), makeOutputBlock(), mediaParent(), multiplyMedia(), null, popEnv(), et pushEnv().
Référencé par compileBlock().
|
protected |
Références $parts, $query, compileValue(), et reduce().
Référencé par compileMedia().
|
protected |
Références compileProps(), makeOutputBlock(), popEnv(), et pushEnv().
Référencé par compileBlock().
|
protected |
Références $importDir, $name, $path, $suffix, $value, compileBlock(), compileImportedProps(), compileValue(), findBlocks(), null, popEnv(), pushEnv(), reduce(), sortProps(), throwError(), tryImport(), et zipSetArgs().
Référencé par compileImportedProps(), et compileProps().
|
protected |
Références compileProp(), deduplicate(), et sortProps().
Référencé par compileCSSBlock(), compileMedia(), compileNestedBlock(), et compileRoot().
|
protected |
Références $root, compileProps(), makeOutputBlock(), popEnv(), et pushEnv().
Référencé par compileBlock().
|
protected |
Références $value, compileValue(), et reduce().
Référencé par compileCSSBlock().
compileValue | ( | $value | ) |
Compiles a primitive value into a CSS property value.
Values in lessphp are typed by being wrapped in arrays, their format is typically:
array(type, contents [, additional_contents]*)
The input is expected to be reduced. This function will not work on things like expressions and variables.
Références $b, $content, $g, $name, $r, $value, coerceColor(), null, et throwError().
Référencé par compileBlock(), compileMediaQuery(), compileProp(), compileSelectors(), lib__sprintf(), lib_e(), lib_unit(), reduce(), et tryImport().
|
static |
Références $items.
Référencé par lessc_parser\expressionList(), et lessc_parser\propertyValue().
|
protected |
Deduplicate lines in a block. Comments are not deduplicated. If a duplicate rule is detected, the comments immediately preceding each occurence are consolidated.
Référencé par compileProps().
|
protected |
Référencé par evaluate(), et patternMatch().
|
protected |
Références coerceColor(), eq(), reduce(), stringConcatenate(), et toBool().
Référencé par reduce().
|
protected |
Référencé par multiplySelectors().
|
protected |
Références $name.
Référencé par findImport().
|
protected |
Références $name, $path, null, et patternMatchAll().
Référencé par compileProp().
|
protected |
Références null.
Référencé par compileMedia(), et multiplySelectors().
|
protected |
Références $file, $url, fileExists(), et null.
Référencé par lib_data_uri(), et tryImport().
|
protected |
Références $i.
Référencé par funcToColor(), lib_mix(), et op_color_color().
|
protected |
Références $value.
Référencé par tryImport().
|
protected |
|
protected |
Références $current, $name, et throwError().
|
protected |
Références $color, $i, $template, coerceColor(), compileValue(), lib_e(), et reduce().
|
protected |
Références assertNumber().
|
protected |
Références $color, $value, et coerceColor().
Référencé par lib_contrast(), et lib_mix().
|
protected |
Références $color, et lib_rgbahex().
|
protected |
Références assertNumber().
|
protected |
Références assertNumber().
lib_blue | ( | $color | ) |
Références $color, coerceColor(), et throwError().
|
protected |
Références $value, et assertNumber().
|
protected |
Références assertColor(), assertNumber(), coerceColor(), lib_alpha(), et toLuma().
|
protected |
Références assertNumber().
|
protected |
Références $color, clamp(), colorArgs(), toHSL(), et toRGB().
|
protected |
Given an url, decide whether to output a regular link or the base64-encoded contents of the file
array | $value | either an argument list (two strings) or a single string |
Références $mime, $url, $value, elseif, findImport(), et null.
|
protected |
Références $color, clamp(), colorArgs(), toHSL(), et toRGB().
|
protected |
Références $items, compileValue(), et throwError().
Référencé par lib__sprintf(), lib_unit(), reduce(), et tryImport().
|
protected |
Références $list, $value, assertArgs(), et assertNumber().
|
protected |
Références $color, clamp(), et colorArgs().
|
protected |
Références $color, clamp(), et colorArgs().
|
protected |
Références $color, clamp(), et colorArgs().
|
protected |
Références $value, et assertNumber().
lib_green | ( | $color | ) |
Références $color, coerceColor(), et throwError().
|
protected |
Références $color, assertColor(), et toHSL().
|
protected |
Références $value, coerceColor(), et toBool().
|
protected |
Références $color, clamp(), colorArgs(), toHSL(), et toRGB().
|
protected |
Références $color, assertColor(), et toHSL().
|
protected |
Références assertColor(), fixColor(), lib_alpha(), et throwError().
Référencé par lib_shade(), et lib_tint().
|
protected |
Références $b, assertArgs(), et assertNumber().
|
protected |
Références assertNumber().
|
protected |
|
protected |
Références $base, assertArgs(), et assertNumber().
lib_red | ( | $color | ) |
Références $color, coerceColor(), et throwError().
|
protected |
Références $color, coerceColor(), et throwError().
Référencé par lib_argb().
|
protected |
Références $value, et assertNumber().
|
protected |
Références $color, clamp(), colorArgs(), toHSL(), et toRGB().
|
protected |
Références $color, assertColor(), et toHSL().
|
protected |
Mix color with black in variable proportion.
It is the same as calling mix(#000000, @color, @weight)
shade(@color, [@weight: 50%]);
http://lesscss.org/functions/#color-operations-shade
Références elseif, lib_mix(), et throwError().
|
protected |
Références assertNumber().
|
protected |
Références $color, colorArgs(), toHSL(), et toRGB().
|
protected |
Références assertNumber().
|
protected |
Références assertNumber().
|
protected |
Mix color with white in variable proportion.
It is the same as calling mix(#ffffff, @color, @weight)
.
tint(@color, [@weight: 50%]);
http://lesscss.org/functions/#color-operations-tint
Références elseif, lib_mix(), et throwError().
|
protected |
Références assertNumber(), compileValue(), et lib_e().
|
protected |
Référencé par compileCSSBlock(), compileMedia(), compileNestedBlock(), et compileRoot().
|
protected |
Références $name, et $preserveComments.
Référencé par compile(), et tryImport().
|
protected |
Référencé par compileMedia().
|
protected |
Référencé par compileMedia().
|
protected |
Références $count, expandParentSelectors(), et findClosestSelectors().
Référencé par compileCSSBlock().
|
protected |
Références $className.
Référencé par compile().
|
protected |
Références $i, fixColor(), et throwError().
Référencé par op_color_number().
|
protected |
Références op_color_color().
Référencé par op_number_color().
|
protected |
Références op_color_number().
|
protected |
Références $value, throwError(), et toBool().
Références $registeredVars, compile(), compileFile(), null, et setVariables().
|
protected |
Références $i, eq(), popEnv(), pushEnv(), reduce(), et zipSetArgs().
Référencé par patternMatchAll().
|
protected |
Références null, et patternMatch().
Référencé par findBlocks().
|
protected |
Référencé par compileCSSBlock(), compileMedia(), compileNestedBlock(), compileProp(), compileRoot(), et patternMatch().
|
static |
Référencé par lessc_parser\__construct(), lessc_parser\literal(), lessc_parser\string(), et lessc_parser\to().
|
protected |
Référencé par compileCSSBlock(), compileMedia(), compileNestedBlock(), compileProp(), compileRoot(), injectVariables(), et patternMatch().
|
protected |
Références $color, $item, $key, $name, $value, coerceColor(), compileValue(), elseif, evaluate(), funcToColor(), lib_e(), et throwError().
Référencé par compileBlock(), compileMediaQuery(), compileProp(), compileSelectors(), evaluate(), funcToColor(), lib__sprintf(), patternMatch(), et zipSetArgs().
registerFunction | ( | $name, | |
$func | |||
) |
Références $name.
setFormatter | ( | $name | ) |
Références $name.
Référencé par TemplatesModelTemplate\compileLess().
setImportDir | ( | $dirs | ) |
setPreserveComments | ( | $preserve | ) |
setVariables | ( | $variables | ) |
Référencé par parse().
|
protected |
Références $id.
Référencé par compileProp(), compileProps(), et tryImport().
|
protected |
Références coerceString().
Référencé par evaluate().
throwError | ( | $msg = null | ) |
Uses the current value of $this->count to show line and line number
Référencé par assertArgs(), assertColor(), assertNumber(), compileBlock(), compileProp(), compileValue(), get(), lib_blue(), lib_e(), lib_green(), lib_mix(), lib_red(), lib_rgbahex(), lib_shade(), lib_tint(), op_color_color(), op_number_number(), reduce(), et zipSetArgs().
toBool | ( | $a | ) |
Référencé par evaluate(), lib_iscolor(), lib_isem(), lib_iskeyword(), lib_isnumber(), lib_ispercentage(), lib_ispixel(), lib_isrem(), lib_isstring(), et op_number_number().
|
protected |
Références $b, $color, $g, $r, et elseif.
Référencé par lib_darken(), lib_desaturate(), lib_hue(), lib_lighten(), lib_lightness(), lib_saturate(), lib_saturation(), et lib_spin().
|
private |
Références $b, $color, $g, $r, et coerceColor().
Référencé par lib_contrast(), et lib_luma().
|
protected |
Converts a hsl array into a color value in rgb. Expects H to be in range of 0 to 360, S and L in 0 to 100
Références $b, $color, $g, $r, et toRGB_helper().
Référencé par funcToColor(), lib_darken(), lib_desaturate(), lib_lighten(), lib_saturate(), et lib_spin().
|
protected |
Références $root, $url, addParsedFile(), allParsedFiles(), coerceString(), compileImportedProps(), compileValue(), findImport(), flattenList(), lib_e(), makeParser(), null, et sortProps().
Référencé par compileProp().
unregisterFunction | ( | $name | ) |
Références $name.
unsetVariable | ( | $name | ) |
Références $name.
|
protected |
Références $i, $value, elseif, null, reduce(), et throwError().
Référencé par compileProp(), et patternMatch().
|
protected |
Référencé par allParsedFiles().
|
staticprotected |
|
static |
$importDir = '' |
Référencé par compileFile(), compileImportedProps(), et compileProp().
$importDisabled = false |
|
protected |
$mPrefix = '$' |
|
staticprotected |
|
protected |
$parentSelector = '&' |
|
protected |
Référencé par makeParser().
|
protected |
Référencé par parse().
|
protected |
|
protected |
Référencé par compileImportedProps().
|
static |
|
static |
$vPrefix = '@' |