Velocity API: View.insertCss()

Version 2

    Return To Index

    View.insertCss()

    Overview

    Inserts CSS from a resource file into a specific Web screen or all Web screens from the host. The CSS file must be in the resource bundle.

     

    This option is only available for Web hosts.

    Use case

    • Your site was not initially designed to accommodate mobile device screens and requires additional CSS to properly format elements.

    Format

     

    View.insertCss(resourceName, tag, position, 
         {'MATCH-URL':urlfrag, 'MATCH-SOURCE':searchText});
    ParameterDescriptionTypeRequiredNotes
    resourceNameThe name of the CSS file in the resource bundle.TextRequiredDo not specify a path, just the file name. For example:
    'newcss.css'
    tagSpecifies the name of the tag where the CSS link will be inserted.TextRequiredValid values:

     

    "HEAD" - Specifies that the code should be inserted between the <head></head> tags of the page.

     

    "BODY" - Specifies that the code should be inserted between the <body></body> tags of the page.
    positionSpecifies where in the tag that the CSS link will be inserted.TextRequiredValid values:

     

    "TOP" - Specifies that the code should be inserted at the top of the specified tag.

     

    "BOTTOM" - Specifies that the code should be inserted at the bottom of specified tag.
    urlfragSpecifies the partial or full URL of the page where you want to insert the CSS. For example:
    'page2.html'
    'company/page2.html'
    StringOptionalPart of the matching parameters object. It must be in the following format, enclosed in braces:
    {'MATCH-URL':'URL'}
    The URL must match at least a portion of the host profile address. If you want the CSS to be applied to all pages, do not use the matching parameters object.
    searchTextSpecifies a text string that must match text on the page.StringOptionalPart of the matching parameters object. It must be in the following format, enclosed in braces:
    {'MATCH-SOURCE':'TEXT'}
    The text must be matched exactly, or the CSS is not inserted. It is case-sensitive. If you want the CSS to be applied to all pages, do not use the matching parameters object.

     

    Example

    /* Insert specific styles from newstyles.css within the BOTTOM 
    * of the HEAD tag and apply it to the index.html page.
    */
      
    View.insertCss('newstyles.css','HEAD','BOTTOM',
        {'MATCH-URL':'index.html'});