ash/system/unified/user_chooser_view.h

// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_SYSTEM_UNIFIED_USER_CHOOSER_VIEW_H_
#define ASH_SYSTEM_UNIFIED_USER_CHOOSER_VIEW_H_

#include "ash/ash_export.h"
#include "ash/media/media_controller_impl.h"
#include "base/memory/raw_ptr.h"
#include "base/scoped_observation.h"
#include "ui/base/metadata/metadata_header_macros.h"
#include "ui/views/controls/button/button.h"
#include "ui/views/view.h"

namespace views {
class ImageView;
class Label;
}  // namespace views

namespace ash {

class UserChooserDetailedViewController;

// Circular image view with user's icon of |user_index|.
views::View* CreateUserAvatarView(int user_index);

// Get accessibility string for |user_index|.
std::u16string GetUserItemAccessibleString(int user_index);

// A button item of a switchable user.
class UserItemButton : public views::Button {
  METADATA_HEADER(UserItemButton, views::Button)

 public:
  UserItemButton(PressedCallback callback,
                 UserChooserDetailedViewController* controller,
                 int user_index,
                 ax::mojom::Role role,
                 bool has_close_button);

  UserItemButton(const UserItemButton&) = delete;
  UserItemButton& operator=(const UserItemButton&) = delete;

  ~UserItemButton() override;

  void SetCaptureState(MediaCaptureState capture_states);

  // views::Button:
  // When both name and email are full shown we suppress the tooltip
  // text. This means that we must provide an alternative accessible name, when
  // this is the case. This is because `Button::AdjustAccessibleName` will use
  // the tooltip text when the accessible name is empty, and if the tooltip text
  // is also empty then the button will have no accessible name.
  std::u16string GetAlternativeAccessibleName() const override;

  // views::ViewObserver:
  void OnViewPreferredSizeChanged(View* observed_view) override;

  // views::View
  void OnBoundsChanged(const gfx::Rect& previous_bounds) override;

  int user_index_for_testing() const { return user_index_; }

 private:
  void UpdateTooltipText();

  const int user_index_;
  const raw_ptr<views::ImageView> capture_icon_;
  const raw_ptr<views::Label> name_;
  const raw_ptr<views::Label> email_;
  // Suppress tooltip when name and email are full shown.
  std::u16string suppressed_tooltip_text_;

  base::ScopedObservation<views::View, views::ViewObserver> name_observation_{
      this};
  base::ScopedObservation<views::View, views::ViewObserver> email_observation_{
      this};
  base::WeakPtrFactory<UserItemButton> weak_ptr_factory_{this};
};

// A detailed view of user chooser.
class ASH_EXPORT UserChooserView : public views::View,
                                   public MediaCaptureObserver {
  METADATA_HEADER(UserChooserView, views::View)

 public:
  explicit UserChooserView(UserChooserDetailedViewController* controller);

  UserChooserView(const UserChooserView&) = delete;
  UserChooserView& operator=(const UserChooserView&) = delete;

  ~UserChooserView() override;

  // MediaCaptureObserver:
  void OnMediaCaptureChanged(const base::flat_map<AccountId, MediaCaptureState>&
                                 capture_states) override;

  std::u16string GetUserItemAccessibleStringForTesting(int user_index);

 private:
  FRIEND_TEST_ALL_PREFIXES(PowerButtonTest, UserItemButtonTooltipText);

  std::vector<raw_ptr<UserItemButton, VectorExperimental>> user_item_buttons_;
};

}  // namespace ash

#endif  // ASH_SYSTEM_UNIFIED_USER_CHOOSER_VIEW_H_