Home | History | Annotate | Download | only in views
      1 // Copyright 2013 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #include "ui/message_center/views/bounded_label.h"
      6 
      7 #include <limits>
      8 
      9 #include "base/strings/string_util.h"
     10 #include "base/strings/utf_string_conversions.h"
     11 #include "ui/gfx/canvas.h"
     12 #include "ui/gfx/text_elider.h"
     13 #include "ui/views/controls/label.h"
     14 
     15 namespace {
     16 
     17 const size_t kPreferredLinesCacheSize = 10;
     18 
     19 }  // namespace
     20 
     21 namespace message_center {
     22 
     23 // InnerBoundedLabel ///////////////////////////////////////////////////////////
     24 
     25 // InnerBoundedLabel is a views::Label subclass that does all of the work for
     26 // BoundedLabel. It is kept private to prevent outside code from calling a
     27 // number of views::Label methods like setFont() that break BoundedLabel's
     28 // caching but can't be overridden.
     29 //
     30 // TODO(dharcourt): Move the line limiting functionality to views::Label to make
     31 // this unnecessary.
     32 
     33 class InnerBoundedLabel : public views::Label {
     34  public:
     35   InnerBoundedLabel(const BoundedLabel& owner);
     36   virtual ~InnerBoundedLabel();
     37 
     38   void SetNativeTheme(const ui::NativeTheme* theme);
     39 
     40   // Pass in a -1 width to use the preferred width, a -1 limit to skip limits.
     41   int GetLinesForWidthAndLimit(int width, int limit);
     42   gfx::Size GetSizeForWidthAndLines(int width, int lines);
     43   std::vector<string16> GetWrappedText(int width, int lines);
     44 
     45  protected:
     46   // Overridden from views::Label.
     47   virtual void OnBoundsChanged(const gfx::Rect& previous_bounds) OVERRIDE;
     48   virtual void OnPaint(gfx::Canvas* canvas) OVERRIDE;
     49 
     50  private:
     51   int GetTextFlags();
     52 
     53   void ClearCaches();
     54   int GetCachedLines(int width);
     55   void SetCachedLines(int width, int lines);
     56   gfx::Size GetCachedSize(const std::pair<int, int>& width_and_lines);
     57   void SetCachedSize(std::pair<int, int> width_and_lines, gfx::Size size);
     58 
     59   const BoundedLabel* owner_;  // Weak reference.
     60   string16 wrapped_text_;
     61   int wrapped_text_width_;
     62   int wrapped_text_lines_;
     63   std::map<int, int> lines_cache_;
     64   std::list<int> lines_widths_;  // Most recently used in front.
     65   std::map<std::pair<int, int>, gfx::Size> size_cache_;
     66   std::list<std::pair<int, int> > size_widths_and_lines_;  // Recent in front.
     67 
     68   DISALLOW_COPY_AND_ASSIGN(InnerBoundedLabel);
     69 };
     70 
     71 InnerBoundedLabel::InnerBoundedLabel(const BoundedLabel& owner)
     72     : owner_(&owner),
     73       wrapped_text_width_(0),
     74       wrapped_text_lines_(0) {
     75   SetMultiLine(true);
     76   SetAllowCharacterBreak(true);
     77   SetHorizontalAlignment(gfx::ALIGN_LEFT);
     78   set_collapse_when_hidden(true);
     79 }
     80 
     81 InnerBoundedLabel::~InnerBoundedLabel() {
     82 }
     83 
     84 void InnerBoundedLabel::SetNativeTheme(const ui::NativeTheme* theme) {
     85   ClearCaches();
     86   OnNativeThemeChanged(theme);
     87 }
     88 
     89 int InnerBoundedLabel::GetLinesForWidthAndLimit(int width, int limit) {
     90   if (width == 0 || limit == 0)
     91     return 0;
     92   int lines = GetCachedLines(width);
     93   if (lines == std::numeric_limits<int>::max()) {
     94     int text_width = std::max(width - owner_->GetInsets().width(), 0);
     95     lines = GetWrappedText(text_width, lines).size();
     96     SetCachedLines(width, lines);
     97   }
     98   return (limit < 0 || lines <= limit) ? lines : limit;
     99 }
    100 
    101 gfx::Size InnerBoundedLabel::GetSizeForWidthAndLines(int width, int lines) {
    102   if (width == 0 || lines == 0)
    103     return gfx::Size();
    104   std::pair<int, int> key(width, lines);
    105   gfx::Size size = GetCachedSize(key);
    106   if (size.height() == std::numeric_limits<int>::max()) {
    107     gfx::Insets insets = owner_->GetInsets();
    108     int text_width = (width < 0) ? std::numeric_limits<int>::max() :
    109                                    std::max(width - insets.width(), 0);
    110     int text_height = std::numeric_limits<int>::max();
    111     std::vector<string16> wrapped = GetWrappedText(text_width, lines);
    112     gfx::Canvas::SizeStringInt(JoinString(wrapped, '\n'), font(),
    113                                &text_width, &text_height,
    114                                owner_->GetLineHeight(),
    115                                GetTextFlags());
    116     size.set_width(text_width + insets.width());
    117     size.set_height(text_height + insets.height());
    118     SetCachedSize(key, size);
    119   }
    120   return size;
    121 }
    122 
    123 std::vector<string16> InnerBoundedLabel::GetWrappedText(int width, int lines) {
    124   // Short circuit simple case.
    125   if (width == 0 || lines == 0)
    126     return std::vector<string16>();
    127 
    128   // Restrict line limit to ensure (lines + 1) * line_height <= INT_MAX and
    129   // use it to calculate a reasonable text height.
    130   int height = std::numeric_limits<int>::max();
    131   if (lines > 0) {
    132     int line_height = std::max(font().GetHeight(), 2);  // At least 2 pixels.
    133     int max_lines = std::numeric_limits<int>::max() / line_height - 1;
    134     lines = std::min(lines, max_lines);
    135     height = (lines + 1) * line_height;
    136   }
    137 
    138   // Try to ensure that the width is no smaller than the width of the text's
    139   // characters to avoid the http://crbug.com/237700 infinite loop.
    140   // TODO(dharcourt): Remove when http://crbug.com/237700 is fixed.
    141   width = std::max(width, 2 * font().GetStringWidth(UTF8ToUTF16("W")));
    142 
    143   // Wrap, using INT_MAX for -1 widths that indicate no wrapping.
    144   std::vector<string16> wrapped;
    145   gfx::ElideRectangleText(text(), font_list(),
    146                           (width < 0) ? std::numeric_limits<int>::max() : width,
    147                           height, gfx::WRAP_LONG_WORDS, &wrapped);
    148 
    149   // Elide if necessary.
    150   if (lines > 0 && wrapped.size() > static_cast<unsigned int>(lines)) {
    151     // Add an ellipsis to the last line. If this ellipsis makes the last line
    152     // too wide, that line will be further elided by the gfx::ElideText below,
    153     // so for example "ABC" could become "ABC..." and then "AB...".
    154     string16 last = wrapped[lines - 1] + UTF8ToUTF16(gfx::kEllipsis);
    155     if (width > 0 && font().GetStringWidth(last) > width)
    156       last = gfx::ElideText(last, font(), width, gfx::ELIDE_AT_END);
    157     wrapped.resize(lines - 1);
    158     wrapped.push_back(last);
    159   }
    160 
    161   return wrapped;
    162 }
    163 
    164 void InnerBoundedLabel::OnBoundsChanged(const gfx::Rect& previous_bounds) {
    165   ClearCaches();
    166   views::Label::OnBoundsChanged(previous_bounds);
    167 }
    168 
    169 void InnerBoundedLabel::OnPaint(gfx::Canvas* canvas) {
    170   views::Label::OnPaintBackground(canvas);
    171   views::Label::OnPaintBorder(canvas);
    172   int lines = owner_->GetLineLimit();
    173   int height = GetSizeForWidthAndLines(width(), lines).height();
    174   if (height > 0) {
    175     gfx::Rect bounds(width(), height);
    176     bounds.Inset(owner_->GetInsets());
    177     if (bounds.width() != wrapped_text_width_ || lines != wrapped_text_lines_) {
    178       wrapped_text_ = JoinString(GetWrappedText(bounds.width(), lines), '\n');
    179       wrapped_text_width_ = bounds.width();
    180       wrapped_text_lines_ = lines;
    181     }
    182     bounds.set_x(GetMirroredXForRect(bounds));
    183     PaintText(canvas, wrapped_text_, bounds, GetTextFlags());
    184   }
    185 }
    186 
    187 int InnerBoundedLabel::GetTextFlags() {
    188   int flags = gfx::Canvas::MULTI_LINE | gfx::Canvas::CHARACTER_BREAK;
    189 
    190   // We can't use subpixel rendering if the background is non-opaque.
    191   if (SkColorGetA(background_color()) != 0xFF)
    192     flags |= gfx::Canvas::NO_SUBPIXEL_RENDERING;
    193 
    194   if (directionality_mode() ==
    195       views::Label::AUTO_DETECT_DIRECTIONALITY) {
    196     base::i18n::TextDirection direction =
    197         base::i18n::GetFirstStrongCharacterDirection(text());
    198     if (direction == base::i18n::RIGHT_TO_LEFT)
    199       flags |= gfx::Canvas::FORCE_RTL_DIRECTIONALITY;
    200     else
    201       flags |= gfx::Canvas::FORCE_LTR_DIRECTIONALITY;
    202   }
    203 
    204   return flags;
    205 }
    206 
    207 void InnerBoundedLabel::ClearCaches() {
    208   wrapped_text_width_ = 0;
    209   wrapped_text_lines_ = 0;
    210   lines_cache_.clear();
    211   lines_widths_.clear();
    212   size_cache_.clear();
    213   size_widths_and_lines_.clear();
    214 }
    215 
    216 int InnerBoundedLabel::GetCachedLines(int width) {
    217   int lines = std::numeric_limits<int>::max();
    218   std::map<int, int>::const_iterator found;
    219   if ((found = lines_cache_.find(width)) != lines_cache_.end()) {
    220     lines = found->second;
    221     lines_widths_.remove(width);
    222     lines_widths_.push_front(width);
    223   }
    224   return lines;
    225 }
    226 
    227 void InnerBoundedLabel::SetCachedLines(int width, int lines) {
    228   if (lines_cache_.size() >= kPreferredLinesCacheSize) {
    229     lines_cache_.erase(lines_widths_.back());
    230     lines_widths_.pop_back();
    231   }
    232   lines_cache_[width] = lines;
    233   lines_widths_.push_front(width);
    234 }
    235 
    236 gfx::Size InnerBoundedLabel::GetCachedSize(
    237     const std::pair<int, int>& width_and_lines) {
    238   gfx::Size size(width_and_lines.first, std::numeric_limits<int>::max());
    239   std::map<std::pair<int, int>, gfx::Size>::const_iterator found;
    240   if ((found = size_cache_.find(width_and_lines)) != size_cache_.end()) {
    241     size = found->second;
    242     size_widths_and_lines_.remove(width_and_lines);
    243     size_widths_and_lines_.push_front(width_and_lines);
    244   }
    245   return size;
    246 }
    247 
    248 void InnerBoundedLabel::SetCachedSize(std::pair<int, int> width_and_lines,
    249                                       gfx::Size size) {
    250   if (size_cache_.size() >= kPreferredLinesCacheSize) {
    251     size_cache_.erase(size_widths_and_lines_.back());
    252     size_widths_and_lines_.pop_back();
    253   }
    254   size_cache_[width_and_lines] = size;
    255   size_widths_and_lines_.push_front(width_and_lines);
    256 }
    257 
    258 // BoundedLabel ///////////////////////////////////////////////////////////
    259 
    260 BoundedLabel::BoundedLabel(const string16& text, const gfx::FontList& font_list)
    261     : line_limit_(-1) {
    262   label_.reset(new InnerBoundedLabel(*this));
    263   label_->SetFontList(font_list);
    264   label_->SetText(text);
    265 }
    266 
    267 BoundedLabel::BoundedLabel(const string16& text)
    268     : line_limit_(-1) {
    269   label_.reset(new InnerBoundedLabel(*this));
    270   label_->SetText(text);
    271 }
    272 
    273 BoundedLabel::~BoundedLabel() {
    274 }
    275 
    276 void BoundedLabel::SetColors(SkColor textColor, SkColor backgroundColor) {
    277   label_->SetEnabledColor(textColor);
    278   label_->SetBackgroundColor(backgroundColor);
    279 }
    280 
    281 void BoundedLabel::SetLineHeight(int height) {
    282   label_->SetLineHeight(height);
    283 }
    284 
    285 void BoundedLabel::SetLineLimit(int lines) {
    286   line_limit_ = std::max(lines, -1);
    287 }
    288 
    289 int BoundedLabel::GetLineHeight() const {
    290   return label_->line_height();
    291 }
    292 
    293 int BoundedLabel::GetLineLimit() const {
    294   return line_limit_;
    295 }
    296 
    297 int BoundedLabel::GetLinesForWidthAndLimit(int width, int limit) {
    298   return visible() ? label_->GetLinesForWidthAndLimit(width, limit) : 0;
    299 }
    300 
    301 gfx::Size BoundedLabel::GetSizeForWidthAndLines(int width, int lines) {
    302   return visible() ?
    303          label_->GetSizeForWidthAndLines(width, lines) : gfx::Size();
    304 }
    305 
    306 int BoundedLabel::GetBaseline() const {
    307   return label_->GetBaseline();
    308 }
    309 
    310 gfx::Size BoundedLabel::GetPreferredSize() {
    311   return visible() ? label_->GetSizeForWidthAndLines(-1, -1) : gfx::Size();
    312 }
    313 
    314 int BoundedLabel::GetHeightForWidth(int width) {
    315   return visible() ?
    316          label_->GetSizeForWidthAndLines(width, line_limit_).height() : 0;
    317 }
    318 
    319 void BoundedLabel::Paint(gfx::Canvas* canvas) {
    320   if (visible())
    321     label_->Paint(canvas);
    322 }
    323 
    324 bool BoundedLabel::HitTestRect(const gfx::Rect& rect) const {
    325   return label_->HitTestRect(rect);
    326 }
    327 
    328 void BoundedLabel::GetAccessibleState(ui::AccessibleViewState* state) {
    329   label_->GetAccessibleState(state);
    330 }
    331 
    332 void BoundedLabel::OnBoundsChanged(const gfx::Rect& previous_bounds) {
    333   label_->SetBoundsRect(bounds());
    334   views::View::OnBoundsChanged(previous_bounds);
    335 }
    336 
    337 void BoundedLabel::OnNativeThemeChanged(const ui::NativeTheme* theme) {
    338   label_->SetNativeTheme(theme);
    339 }
    340 
    341 string16 BoundedLabel::GetWrappedTextForTest(int width, int lines) {
    342   return JoinString(label_->GetWrappedText(width, lines), '\n');
    343 }
    344 
    345 }  // namespace message_center
    346