chromium/chrome/browser/ui/webui/ash/settings/pages/device/device_keyboard_handler.h

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

#ifndef CHROME_BROWSER_UI_WEBUI_ASH_SETTINGS_PAGES_DEVICE_DEVICE_KEYBOARD_HANDLER_H_
#define CHROME_BROWSER_UI_WEBUI_ASH_SETTINGS_PAGES_DEVICE_DEVICE_KEYBOARD_HANDLER_H_

#include "base/memory/raw_ptr.h"
#include "base/scoped_observation.h"
#include "chrome/browser/ui/webui/settings/settings_page_ui_handler.h"
#include "ui/events/devices/device_data_manager.h"
#include "ui/events/devices/input_device_event_observer.h"

namespace ash::settings {

// Chrome OS "Keyboard" settings page UI handler.
class KeyboardHandler : public ::settings::SettingsPageUIHandler,
                        public ui::InputDeviceEventObserver {
 public:
  // Name of the message sent to WebUI when the keys that should be shown
  // change.
  static const char kShowKeysChangedName[];

  // Class used by tests to interact with KeyboardHandler internals.
  class TestAPI {
   public:
    explicit TestAPI(KeyboardHandler* handler) { handler_ = handler; }

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

    // Simulates a request from WebUI to initialize the page.
    void Initialize();

   private:
    raw_ptr<KeyboardHandler> handler_;  // Not owned.
  };

  KeyboardHandler();

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

  ~KeyboardHandler() override;

  // SettingsPageUIHandler implementation.
  void RegisterMessages() override;
  void OnJavascriptAllowed() override;
  void OnJavascriptDisallowed() override;

  // ui::InputDeviceEventObserver implementation.
  void OnInputDeviceConfigurationChanged(uint8_t input_device_types) override;

 private:
  // Initializes the page with the current keyboard information.
  void HandleInitialize(const base::Value::List& args);

  // Shows the Ash shortcut customization app.
  void HandleShowShortcutCustomizationApp(const base::Value::List& args) const;

  // Determines what types of keyboards are attached.
  void HandleKeyboardChange(const base::Value::List& args);

  // Shows or hides the Caps Lock and Diamond key settings based on whether the
  // system status.
  void UpdateShowKeys();

  // Sends the UI a message about whether hardware keyboard are attached.
  void UpdateKeyboards();

  base::ScopedObservation<ui::DeviceDataManager, ui::InputDeviceEventObserver>
      observation_{this};
};

}  // namespace ash::settings

#endif  // CHROME_BROWSER_UI_WEBUI_ASH_SETTINGS_PAGES_DEVICE_DEVICE_KEYBOARD_HANDLER_H_