HD-Internetdienste

Dieser Beitrag stellt die Klasse ColorProvider vor, welche die Funktionalität der "Bedingten Formatierung", bekannt aus Excel 2007, nachbildet.

Dabei wird ein Wertebereich einem Farbverlauf gegenübergestellt, so dass man schon aufgrund der Hintergrundfarbe auf den Wert der Zelle schließen kann. Das erleichtert die Übersichtlichkeit einer Tabelle enorm.

Hier der Quelltext als "Out of the box" Beispiel:

<?php 
 
class ColorProvider {

    //Konstruktorparameter
    private $startColor;
    private $endColor;
    private $minWert;
    private $maxWert;
    //Optionale Parameter
    private $increment = 0.1;
    private $outOfRangeColorMin = "#ffffff";
    private $outOfRangeColorMax = "#000000";
    //Hilfsvariablen
    private $steps;
    private $preR;
    private $preG;
    private $preB;
    private $postR;
    private $postG;
    private $postB;
    private $deltaR;
    private $deltaG;
    private $deltaB;

    /**
     * Ermöglicht eine "Bedingte Formatierung" Wie aus Excel 2007 bekannt.
     * @access public
     * @param $startColor String Anfangsfarbe im Farbverlauf.
     * @param $endColor String Endfarbe im Farbverlauf.
     * @param $minWert Double Kleinster Wert im Wertebereich.
     * @param $maxWert Double Größter Wert im Wertebereich.
     */
    function __construct($startColor, $endColor, $minWert, $maxWert) {

        $this->startColor = str_replace("#", "", $startColor);
        $this->endColor = str_replace("#", "", $endColor);
        $this->minWert = $minWert;
        $this->maxWert = $maxWert;

        $this->steps = (($this->maxWert - $this->minWert) / $this->increment);

        $this->preR = hexdec(substr($this->startColor, 0, 2));
        $this->preG = hexdec(substr($this->startColor, 2, 2));
        $this->preB = hexdec(substr($this->startColor, 4, 2));

        $this->postR = hexdec(substr($this->endColor, 0, 2));
        $this->postG = hexdec(substr($this->endColor, 2, 2));
        $this->postB = hexdec(substr($this->endColor, 4, 2));

        $this->deltaR = $this->postR - $this->preR;
        $this->deltaG = $this->postG - $this->preG;
        $this->deltaB = $this->postB - $this->preB;
    }

    /**
     * Stellt die Schrittweite eines Farbsprungs ein. Default auf 0.1
     * @access public
     * @param $increment Double Schrittweite einer Farbänderung.
     */
    public function setIncrement($increment) {
        $this->increment = $increment;
    }

    /**
     * Stellt die Farbe ein, die zurueckgegeben werden soll wenn 
     * der Wertebereich nach unten ueberschritten wird.
     * @access public
     * @param $outOfRangeColorMin HexColor Farbwert in Hex-Schreibweise. Default '#ffffff'
     */
    public function setOutOfRangeColorMin($outOfRangeColorMin) {
        $this->outOfRangeColorMin = $outOfRangeColorMin;
    }

    /**
     * Stellt die Farbe ein, die zurueckgegeben werden soll wenn 
     * der Wertebereich nach oben ueberschritten wird.
     * @access public
     * @param $outOfRangeColorMax HexColor Farbwert in Hex-Schreibweise. Default '#ffffff'
     */
    public function setOutOfRangeColorMax($outOfRangeColorMax) {
        $this->outOfRangeColorMax = $outOfRangeColorMax;
    }

    /**
     * Gibt eine Hexfarbe für für den übergebenen Wert zurück
     * @access public
     * @param $wert Double Wert der in eine Farbe umgewandelt werden soll. 
     */
    public function getColor($wert) {
        if ($wert < $this->minWert) {
            return $this->outOfRangeColorMin;
        }
        if ($wert > $this->maxWert) {
            return $this->outOfRangeColorMax;
        }
        $stand = (($wert - $this->minWert) / $this->increment);
        $factor = $stand / $this->steps;
        $r = round($this->preR + $this->deltaR * $factor);
        $g = round($this->preG + $this->deltaG * $factor);
        $b = round($this->preB + $this->deltaB * $factor);
        $color = "#" . sprintf("%02X", $r) . sprintf("%02X", $g) . sprintf("%02X", $b);
        return $color;
    }

}

// Testbereich Aufruf
$CP = new ColorProvider("#70ef69", "#f97042", 0.0, 30.0);
echo "<table><tr>";
for ($i = 1; $i <= 300; $i++) {
    echo "<td style='background-color:" . $CP->getColor($i / 10) . ";'>" . ($i / 10) . "</td>";
    if ($i % 20 == 0) {
        echo "</tr><tr>";
    }
}
echo "</tr></table>";
?>

Hier das Ergebnis: