Actions

API16

JHtmlString/abridge

From Joomla! Documentation

< API16:JHtmlString
Revision as of 21:58, 13 May 2013 by JoomlaWikiBot (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Contents

Description

Abridges text strings over the specified character limit. The behavior will insert an ellipsis into the text replacing a section of variable size to ensure the string does not exceed the defined maximum length. This method is UTF-8 safe.

[<! removed edit link to red link >]

<! removed transcluded page call, red link never existed >

Syntax

abridge($text, $length=50, $intro=30)
Parameter Name Default Value Description
$text $text The text to abridge.
$length 50 $length The maximum length of the text.
$intro 30 $intro The maximum length of the intro text.

Returns

string The abridged text.

Defined in

libraries/joomla/html/html/string.php

Importing

jimport( 'joomla.html.html.string' );

Source Body

function abridge($text, $length = 50, $intro = 30)
{
        // Abridge the item text if it is too long.
        if (JString::strlen($text) > $length) {
                // Determine the remaining text length.
                $remainder = $length - ($intro + 3);
 
                // Extract the beginning and ending text sections.
                $beg = JString::substr($text, 0, $intro);
                $end = JString::substr($text, JString::strlen($text)-$remainder);
 
                // Build the resulting string.
                $text = $beg.'...'.$end;
        }
 
        return $text;
}

[<! removed edit link to red link >] <! removed transcluded page call, red link never existed >

Examples

<CodeExamplesForm />