4.5.2 getCssReferences

La méthode getCssReferences() permet d'injecter des feuilles de style personnalisées dans le widget de document.

Elle doit retourner un tableau qui contient le chemin des fichiers css à insérer dans la page HTML. Ces chemins sont relatifs au répertoire d'installation.

Par défaut, les classes Dcp\Ui\DefaultView et Dcp\Ui\DefaultEdit retournent les css suivantes :

[
    "bootstrap" => "css/dcp/document/bootstrap.css",
    "kendo"     => "css/dcp/document/kendo.css",
    "document"  => "css/dcp/document/document.css",
    "datatable" => "lib/jquery-dataTables/1.10/bootstrap/3/dataTables.bootstrap.css"
]

Pour ajouter une feuille de style, il faut reprendre le tableau de la classe parente puis ajouter le chemin vers le nouveau fichier css.

Ce chemin doit être relatif par rapport au répertoire d'installation de Dynacase.

namespace My;
class MyRenderConfigView extends \Dcp\Ui\DefaultView
{
    public function getCssReferences(\Doc $document=null)
    {
        $css = parent::getCssReferences($document);
        $css["myCustom"] = "MY/Layout/custom.css";
        return $css;
    }
}

L'index dans la table permet d'identifier un fichier dans la perspective de le remplacer.

Cet index doit être unique sur l'ensemble des css des rendus.

Note : Dans un soucis de performance, lorsqu'un rendu de document est modifié sur le navigateur, les css déjà enregistrées avec le même identifiant ne sont pas rechargées. Lors du rendu d'un document, les css spécifiques sont supprimées si elles ne sont plus demandées par le nouveau rendu.

Afin de cibler des parties spécifiques du document ou des attributs, la DOM des éléments générs par Dynacase Document UIS est normalisée.