Downloads bar for MD: work on sizing, text appearance.

chrome/browser/ui/views/download/download_item_view_md.cc

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "chrome/browser/ui/views/download/download_item_view_md.h"
 
 #include <algorithm>
 #include <vector>
 
 #include "base/bind.h"
@@ skipping 47 matching lines @@
 #include "ui/views/controls/button/image_button.h"
 #include "ui/views/controls/button/label_button.h"
 #include "ui/views/controls/label.h"
 #include "ui/views/mouse_constants.h"
 #include "ui/views/widget/root_view.h"
 #include "ui/views/widget/widget.h"
 
 using content::DownloadItem;
 using extensions::ExperienceSamplingEvent;
 
-// TODO(paulg): These may need to be adjusted when download progress
-//              animation is added, and also possibly to take into account
-//              different screen resolutions.
-static const int kTextWidth = 140;           // Pixels
-static const int kDangerousTextWidth = 200;  // Pixels
-static const int kVerticalPadding = 3;       // Pixels
-static const int kVerticalTextPadding = 2;   // Pixels
-static const int kTooltipMaxWidth = 800;     // Pixels
+namespace {
 
-// We add some padding before the left image so that the progress animation icon
-// hides the corners of the left image.
-static const int kLeftPadding = 0;  // Pixels.
+// All values in dp.

[sky, 2015/09/23 23:42:27]

do we really use dp? I thought it was dips.

[Evan Stade, 2015/09/24 00:34:26]

I thought "dp" and "dip" were synonyms. Sources online say

Density-independent Pixels (“dip” or “dp” or “dps”)

+const int kTextWidth = 140;
+const int kDangerousTextWidth = 200;
+
+// The normal height of the item which may be exceeded if text is large.
+const int kDefaultHeight = 36;
+
+// The minimum vertical padding above and below contents of the download item.
+// This is only used when the text size is large.
+const int kMinimumVerticalPadding = 2;
+
+// Vertical padding between filename and status text.
+const int kVerticalTextPadding = 1;
+
+const int kTooltipMaxWidth = 800;
+
+// Padding before the icon and at end of the item. TODO(estade): this needs to
+// be used when drawing the non-warning dialog state. Currently we just use the
+// built in padding for the progress indicator.
+const int kStartPadding = 12;
+const int kEndPadding = 19;
 
 // The space between the Save and Discard buttons when prompting for a dangerous
 // download.
-static const int kButtonPadding = 5;  // Pixels.
+const int kButtonPadding = 5;
 
 // The space on the left and right side of the dangerous download label.
-static const int kLabelPadding = 4;  // Pixels.
+const int kLabelPadding = 8;
 
-static const SkColor kFileNameDisabledColor = SkColorSetRGB(171, 192, 212);
+const SkColor kFileNameDisabledColor = SkColorSetRGB(171, 192, 212);
 
 // How long the 'download complete' animation should last for.
-static const int kCompleteAnimationDurationMs = 2500;
+const int kCompleteAnimationDurationMs = 2500;
 
 // How long the 'download interrupted' animation should last for.
-static const int kInterruptedAnimationDurationMs = 2500;
+const int kInterruptedAnimationDurationMs = 2500;
 
 // How long we keep the item disabled after the user clicked it to open the
 // downloaded item.
-static const int kDisabledOnOpenDuration = 3000;
+const int kDisabledOnOpenDuration = 3000;
 
-// Darken light-on-dark download status text by 20% before drawing, thus
-// creating a "muted" version of title text for both dark-on-light and
-// light-on-dark themes.
-static const double kDownloadItemLuminanceMod = 0.8;
+}  // namespace
 
 DownloadItemViewMd::DownloadItemViewMd(DownloadItem* download_item,
                                        DownloadShelfView* parent)
     : warning_icon_(nullptr),
       shelf_(parent),
       status_text_(l10n_util::GetStringUTF16(IDS_DOWNLOAD_STATUS_STARTING)),
       dropdown_state_(NORMAL),
       mode_(NORMAL_MODE),
       dragging_(false),
       starting_drag_(false),
       model_(download_item),
       save_button_(nullptr),
       discard_button_(nullptr),
       dropdown_button_(nullptr),
       dangerous_download_label_(nullptr),
       dangerous_download_label_sized_(false),
       disabled_while_opening_(false),
       creation_time_(base::Time::Now()),
       time_download_warning_shown_(base::Time()),
       weak_ptr_factory_(this) {
   DCHECK(download());
   DCHECK(ui::MaterialDesignController::IsModeMaterial());
   download()->AddObserver(this);
   set_context_menu_controller(this);
 
-  ui::ResourceBundle& rb = ui::ResourceBundle::GetSharedInstance();
-
-  BodyImageSet normal_body_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_BOTTOM),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_BOTTOM),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_BOTTOM)};
-  normal_body_image_set_ = normal_body_image_set;
-
-  DropdownImageSet normal_dropdown_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_BOTTOM)};
-  normal_dropdown_image_set_ = normal_dropdown_image_set;
-
-  BodyImageSet hot_body_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_TOP_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_MIDDLE_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_BOTTOM_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_TOP_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_MIDDLE_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_BOTTOM_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_TOP_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_MIDDLE_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_BOTTOM_H)};
-  hot_body_image_set_ = hot_body_image_set;
-
-  DropdownImageSet hot_dropdown_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_TOP_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_MIDDLE_H),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_BOTTOM_H)};
-  hot_dropdown_image_set_ = hot_dropdown_image_set;
-
-  BodyImageSet pushed_body_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_TOP_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_MIDDLE_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_BOTTOM_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_TOP_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_MIDDLE_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_BOTTOM_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_TOP_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_MIDDLE_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_BOTTOM_P)};
-  pushed_body_image_set_ = pushed_body_image_set;
-
-  DropdownImageSet pushed_dropdown_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_TOP_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_MIDDLE_P),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_MENU_BOTTOM_P)};
-  pushed_dropdown_image_set_ = pushed_dropdown_image_set;
-
-  BodyImageSet dangerous_mode_body_image_set = {
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_LEFT_BOTTOM),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_TOP),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_MIDDLE),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_CENTER_BOTTOM),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_TOP_NO_DD),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_MIDDLE_NO_DD),
-      rb.GetImageSkiaNamed(IDR_DOWNLOAD_BUTTON_RIGHT_BOTTOM_NO_DD)};
-  dangerous_mode_body_image_set_ = dangerous_mode_body_image_set;
-
-  malicious_mode_body_image_set_ = normal_body_image_set;
-
   LoadIcon();
 
-  font_list_ = rb.GetFontList(ui::ResourceBundle::BaseFont);
-  box_height_ = std::max<int>(2 * kVerticalPadding + font_list_.GetHeight() +
-                                  kVerticalTextPadding + font_list_.GetHeight(),
-                              2 * kVerticalPadding +
-                                  normal_body_image_set_.top_left->height() +
-                                  normal_body_image_set_.bottom_left->height());
-  box_y_ =
-      std::max(0, (DownloadShelf::kProgressIndicatorSize - box_height_) / 2);
+  ui::ResourceBundle& rb = ui::ResourceBundle::GetSharedInstance();
+  font_list_ =
+      rb.GetFontList(ui::ResourceBundle::BaseFont).DeriveWithSizeDelta(1);
+  status_font_list_ =
+      rb.GetFontList(ui::ResourceBundle::BaseFont).DeriveWithSizeDelta(-2);
 
   body_hover_animation_.reset(new gfx::SlideAnimation(this));
   drop_hover_animation_.reset(new gfx::SlideAnimation(this));
 
   SetAccessibilityFocusable(true);
 
   OnDownloadUpdated(download());
 
   // TODO(estade): share this button init code with the find in page bar;
   // also fix theming.
@@ skipping 133 matching lines @@
   shelf_->OpenedDownload();
 }
 
 // View overrides
 
 // In dangerous mode we have to layout our buttons.
 void DownloadItemViewMd::Layout() {
   UpdateColorsFromTheme();
 
   if (IsShowingWarningDialog()) {
-    BodyImageSet* body_image_set = (mode_ == DANGEROUS_MODE)
-                                       ? &dangerous_mode_body_image_set_
-                                       : &malicious_mode_body_image_set_;
-    int x = kLeftPadding + body_image_set->top_left->width() +
-            warning_icon_->width() + kLabelPadding;
+    int x = kStartPadding + warning_icon_->width() + kStartPadding;
     int y = (height() - dangerous_download_label_->height()) / 2;
     dangerous_download_label_->SetBounds(x, y,
                                          dangerous_download_label_->width(),
                                          dangerous_download_label_->height());
     gfx::Size button_size = GetButtonSize();
     x += dangerous_download_label_->width() + kLabelPadding;
     y = (height() - button_size.height()) / 2;
     if (save_button_) {
       save_button_->SetBounds(x, y, button_size.width(), button_size.height());
       x += button_size.width() + kButtonPadding;
     }
     discard_button_->SetBounds(x, y, button_size.width(), button_size.height());
   } else {
     dropdown_button_->SizeToPreferredSize();
     dropdown_button_->SetPosition(
         gfx::Point(width() - dropdown_button_->width(),
                    (height() - dropdown_button_->height()) / 2));
   }
 }
 
 gfx::Size DownloadItemViewMd::GetPreferredSize() const {
   int width, height;
 
   // First, we set the height to the height of two rows or text plus margins.
-  height =
-      2 * kVerticalPadding + 2 * font_list_.GetHeight() + kVerticalTextPadding;
+  height = std::max(kDefaultHeight,
+                    2 * kMinimumVerticalPadding + font_list_.GetBaseline() +

[sky, 2015/09/23 23:42:27]

Why are you using baseline instead of height?

[Evan Stade, 2015/09/24 00:34:26]

The specs use the baseline for alignment, e.g. aligning the baseline to the
bottom of the progress indicator or measuring the distance between the lines of
text.

[sky, 2015/09/24 15:05:53]

For alignment, sure, but in calculating the preferred height if you don't
consider descenders then they might get chopped off, right?

[Evan Stade, 2015/09/24 17:28:03]

Hmm, I guess that's fair. I left the filename one on Baseline() because that's
how things are laid out. The worst case scenario is overlap between the lines of
text but I tested at 18pt fonts (which is basically the largest font size that
leaves Chrome usable) and there was still no overlap. The second one is
GetHeight() to make sure the descenders don't run out of space. All of this is
only relevant for unusual font sizes; kDefaultHeight is used normally.

+                        kVerticalTextPadding + status_font_list_.GetBaseline());
   // Then we increase the size if the progress icon doesn't fit.
   height = std::max<int>(height, DownloadShelf::kProgressIndicatorSize);
 
   if (IsShowingWarningDialog()) {
-    const BodyImageSet* body_image_set = (mode_ == DANGEROUS_MODE)
-                                             ? &dangerous_mode_body_image_set_
-                                             : &malicious_mode_body_image_set_;
-    width = kLeftPadding + body_image_set->top_left->width();
-    width += warning_icon_->width() + kLabelPadding;
-    width += dangerous_download_label_->width() + kLabelPadding;
+    width = kStartPadding + warning_icon_->width() + kLabelPadding +
+            dangerous_download_label_->width() + kLabelPadding;
     gfx::Size button_size = GetButtonSize();
     // Make sure the button fits.
-    height = std::max<int>(height, 2 * kVerticalPadding + button_size.height());
+    height = std::max<int>(height,
+                           2 * kMinimumVerticalPadding + button_size.height());
     // Then we make sure the warning icon fits.
-    height =
-        std::max<int>(height, 2 * kVerticalPadding + warning_icon_->height());
+    height = std::max<int>(
+        height, 2 * kMinimumVerticalPadding + warning_icon_->height());
     if (save_button_)
       width += button_size.width() + kButtonPadding;
-    width += button_size.width();
-    width += body_image_set->top_right->width();
-    if (mode_ == MALICIOUS_MODE)
-      width += normal_dropdown_image_set_.top->width();
+    width += button_size.width() + kEndPadding;
   } else {
-    width = kLeftPadding + normal_body_image_set_.top_left->width();
-    width += DownloadShelf::kProgressIndicatorSize;
-    width += kTextWidth;
-    width += normal_body_image_set_.top_right->width();
-    width += normal_dropdown_image_set_.top->width();
+    width = kStartPadding + DownloadShelf::kProgressIndicatorSize + kTextWidth +
+            kEndPadding;
   }
   return gfx::Size(width, height);
 }
 
 // Handle a mouse click and open the context menu if the mouse is
 // over the drop-down region.
 bool DownloadItemViewMd::OnMousePressed(const ui::MouseEvent& event) {
   HandlePressEvent(event, event.IsOnlyLeftMouseButton());
   return true;
 }
@@ skipping 180 matching lines @@
 void DownloadItemViewMd::OnPaint(gfx::Canvas* canvas) {
   DrawStatusText(canvas);
   DrawFilename(canvas);
   DrawIcon(canvas);
   OnPaintBorder(canvas);
 
   if (HasFocus())
     canvas->DrawFocusRect(GetLocalBounds());
 }
 
+int DownloadItemViewMd::GetYForFilenameText() const {
+  int text_height = font_list_.GetBaseline();
+  if (!status_text_.empty())
+    text_height += kVerticalTextPadding + status_font_list_.GetBaseline();
+  return (height() - text_height) / 2;
+}
+
 void DownloadItemViewMd::DrawStatusText(gfx::Canvas* canvas) {
-  if (status_text_.empty())
+  if (status_text_.empty() || IsShowingWarningDialog())
     return;
 
   int mirrored_x = GetMirroredXWithWidthInView(
       DownloadShelf::kProgressIndicatorSize, kTextWidth);
-  // Add font_list_.height() to compensate for title, which is drawn later.
   int y =
-      box_y_ + kVerticalPadding + font_list_.GetHeight() + kVerticalTextPadding;
-  SkColor file_name_color =
-      GetThemeProvider()->GetColor(ThemeProperties::COLOR_BOOKMARK_TEXT);
-  // If text is light-on-dark, lightening it alone will do nothing.
-  // Therefore we mute luminance a wee bit before drawing in this case.
-  if (color_utils::RelativeLuminance(file_name_color) > 0.5)
-    file_name_color =
-        SkColorSetRGB(static_cast<int>(kDownloadItemLuminanceMod *
-                                       SkColorGetR(file_name_color)),
-                      static_cast<int>(kDownloadItemLuminanceMod *
-                                       SkColorGetG(file_name_color)),
-                      static_cast<int>(kDownloadItemLuminanceMod *
-                                       SkColorGetB(file_name_color)));
+      GetYForFilenameText() + font_list_.GetBaseline() + kVerticalTextPadding;
+  SkColor file_name_color = SkColorSetA(
+      GetThemeProvider()->GetColor(ThemeProperties::COLOR_BOOKMARK_TEXT), 0xC7);
   canvas->DrawStringRect(
-      status_text_, font_list_, file_name_color,
-      gfx::Rect(mirrored_x, y, kTextWidth, font_list_.GetHeight()));
+      status_text_, status_font_list_, file_name_color,
+      gfx::Rect(mirrored_x, y, kTextWidth, status_font_list_.GetHeight()));
 }
 
 void DownloadItemViewMd::DrawFilename(gfx::Canvas* canvas) {
+  if (IsShowingWarningDialog())
+    return;
+
   // Print the text, left aligned and always print the file extension.
   // Last value of x was the end of the right image, just before the button.
   // Note that in dangerous mode we use a label (as the text is multi-line).
   base::string16 filename;
   if (!disabled_while_opening_) {
     filename = gfx::ElideFilename(download()->GetFileNameToReportUser(),
                                   font_list_, kTextWidth);
   } else {
     // First, Calculate the download status opening string width.
     base::string16 status_string = l10n_util::GetStringFUTF16(
         IDS_DOWNLOAD_STATUS_OPENING, base::string16());
     int status_string_width = gfx::GetStringWidth(status_string, font_list_);
     // Then, elide the file name.
     base::string16 filename_string =
         gfx::ElideFilename(download()->GetFileNameToReportUser(), font_list_,
                            kTextWidth - status_string_width);
     // Last, concat the whole string.
     filename = l10n_util::GetStringFUTF16(IDS_DOWNLOAD_STATUS_OPENING,
                                           filename_string);
   }
 
   int mirrored_x = GetMirroredXWithWidthInView(
       DownloadShelf::kProgressIndicatorSize, kTextWidth);
   SkColor file_name_color =
       GetThemeProvider()->GetColor(ThemeProperties::COLOR_BOOKMARK_TEXT);
-  int y = box_y_ + (status_text_.empty()
-                        ? ((box_height_ - font_list_.GetHeight()) / 2)
-                        : kVerticalPadding);
 
-  canvas->DrawStringRect(
-      filename, font_list_,
-      enabled() ? file_name_color : kFileNameDisabledColor,
-      gfx::Rect(mirrored_x, y, kTextWidth, font_list_.GetHeight()));
+  canvas->DrawStringRect(filename, font_list_,
+                         enabled() ? file_name_color : kFileNameDisabledColor,
+                         gfx::Rect(mirrored_x, GetYForFilenameText(),
+                                   kTextWidth, font_list_.GetHeight()));
 }
 
 void DownloadItemViewMd::DrawIcon(gfx::Canvas* canvas) {
   if (IsShowingWarningDialog()) {
-    int icon_x = kLeftPadding + normal_body_image_set_.top_left->width();
+    int icon_x = kStartPadding;
     int icon_y = (height() - warning_icon_->height()) / 2;
     canvas->DrawImageInt(*warning_icon_, icon_x, icon_y);
     return;
   }
 
   // Paint download progress.
   DownloadItem::DownloadState state = download()->GetState();
   canvas->Save();
   if (base::i18n::IsRTL()) {
     canvas->Translate(
@@ skipping 414 matching lines @@
     State to,
     gfx::SlideAnimation* animation) {
   if (from == NORMAL && to == HOT) {
     animation->Show();
   } else if (from == HOT && to == NORMAL) {
     animation->Hide();
   } else if (from != to) {
     animation->Reset((to == HOT) ? 1.0 : 0.0);
   }
 }