components/infobars/README.md

   1 The infobars component contains the core types for infobars, a UI surface that
   2 shows informative but generally nonblocking updates to users related to their
   3 current page content.  This is used on both desktop and mobile, though the
   4 presentation and available infobars both differ.  On desktop, for example,
   5 infobars are a thin bar atop the page, while on Android an "infobar" is a
   6 larger, popup-like surface at screen bottom.
   7
   8 Infobars are a problematic UI design for various reasons (spoofability,
   9 dynamically modifying content area size, not being visually anchored and scoped
  10 well), and are occasionally used for purposes outside their original intent
  11 (e.g. the "default browser" infobar, which does not relate to the page content).
  12 Be cautious about adding new ones.
  13
  14 Infobars is a layered component
  15 (https://sites.google.com/a/chromium.org/dev/developers/design-documents/layered-components-design)
  16 to enable it to be shared cleanly on iOS.
  17
  18 On Android, Infobars have been deprecated in favor of the new Message UI.
  19 Please consider using this new Message UI.
  20 See components/messages/README.md for more details.
  21
  22 Directory structure:
  23 android/: Android-specific specializations
  24 core/: Shared code that does not depend on src/content/
  25 content/: Driver for the shared code based on the content layer