Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(5069)

Unified Diff: chrome/browser/resources/settings/settings_main/settings_main.js

Issue 981203007: Scaffold for MD-Settings. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: remove help Created 5 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: chrome/browser/resources/settings/settings_main/settings_main.js
diff --git a/chrome/browser/resources/settings/settings_main/settings_main.js b/chrome/browser/resources/settings/settings_main/settings_main.js
new file mode 100644
index 0000000000000000000000000000000000000000..fe52f13b7284f21602c6c57317193ffecaf47588
--- /dev/null
+++ b/chrome/browser/resources/settings/settings_main/settings_main.js
@@ -0,0 +1,146 @@
+// Copyright 2015 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.
+
+/**
+ * @fileoverview
+ * 'cr-settings-main' displays the selected settings page.
+ *
+ * Example:
+ *
+ * <cr-settings-main pages="{{pages}}" currentPageIndex="{{index}}">
+ * </cr-settings-main>
+ *
+ * See cr-settings-drawer for example of use in 'core-panel'.
+ *
+ * @group Chrome Settings Elements
+ * @element cr-settings-main
+ */
+Polymer('cr-settings-main', {
+ publish: {
+ /**
+ * Pages that may be shown.
+ *
+ * @attribute pages
+ * @type Array<!Obect>
Oren Blasberg 2015/03/09 21:34:00 !Object
michaelpg 2015/03/12 01:41:40 Done.
+ * @default []
+ */
+ pages: [],
+
+ /**
+ * Index of the currently selected page.
+ *
+ * @attribute selectedIndex
+ * @type number
+ * default 0
+ */
+ currentPageIndex: 0,
+ },
+
+ /** @override */
+ ready: function() {
+ this.processPages_();
+ },
+
+ /**
+ * Polymer pages changed method. Ensures the pages container contains the
+ * pages in the right order.
+ *
+ * @param {*} value The old value if the property value has changed, or the
Oren Blasberg 2015/03/09 21:34:00 In the first case, what type would the old value h
michaelpg 2015/03/12 01:41:40 Removed.
+ * array of splices if the existing array has been changed.
+ */
+ pagesChanged: function(value) {
+ // If value is an array of plain objects, it represents splices from an
+ // ArrayObserver.
+ if (value instanceof Array && value.length &&
+ Object.prototype.isPrototypeOf(value[0])) {
+ this.applyPageSplices_(value);
+ } else {
+ this.updatePages_(this.pages);
Oren Blasberg 2015/03/09 21:34:00 updatePages_ doesn't take args -- can you remove t
michaelpg 2015/03/12 01:41:40 Removed.
+ }
+ },
+
+ /**
+ * Adds each page to the page list and prepare the core-animated-pages.
+ *
+ * @private
+ */
+ processPages_: function() {
Kyle Horimoto 2015/03/09 20:59:32 I don't understand why this is necessary. We decla
michaelpg 2015/03/09 22:24:11 Some annoying rule about containers for pages not
Kyle Horimoto 2015/03/09 22:32:03 Just use the "cross-fade-all" transition instead o
michaelpg 2015/03/12 01:41:40 Done-ish (cross-fade-all is too janky)
+ // Generate the list of pages from the DOM.
+ var pages = [];
+ var children = [].slice.call(this.$.pages.children);
Jeremy Klein 2015/03/09 21:17:14 Why not just use this.$.pages.items?
Oren Blasberg 2015/03/09 21:34:00 How come we need to call slice in this unusual way
michaelpg 2015/03/09 22:24:11 Oops, this was from when I was updating the pages
+ for (var i = 0; i < children.length; i++) {
+ // Ignore <template>s.
+ if (children[i].tagName != 'TEMPLATE')
Jeremy Klein 2015/03/09 21:17:14 You can ignore this with an excludedLocalNames att
michaelpg 2015/03/09 22:24:11 See response to khorimito above.
+ pages.push(children[i]);
+ }
+ // Set the list of pages so each page is placed in a <section> within
Kyle Horimoto 2015/03/09 20:59:32 Why a <section>?
Jeremy Klein 2015/03/09 21:17:14 Why does it need to be inside a section?
michaelpg 2015/03/09 22:24:11 Requirement of core-animated-pages, provides a con
Jeremy Klein 2015/03/09 22:35:05 Section isn't a requirement of core-animated-pages
michaelpg 2015/03/12 01:41:40 Done. Thanks for the tips Jeremy & Kyle!
+ // core-animated-pages.
+ this.pages = pages;
+ },
+
+ /**
+ * Sets the list of pages shown in the 'core-animated-pages'. Rebuilds the DOM
+ * for 'core-animated-pages', so this should be called sparingly.
+ *
+ * @private
+ */
+ updatePages_: function() {
+ this.$.pages.innerHTML = '';
+ if (!this.pages.length)
+ return;
+
+ if (this.currentPageIndex >= this.pages.length)
+ this.currentPageIndex = 0;
+
+ for (var i = 0; i < this.pages.length; i++)
+ this.$.pages.appendChild(this.createSection_(this.pages[i]));
+ },
+
+ /**
+ * Applies the splices for the list of pages to the sections in the DOM.
+ *
+ * TODO(michaelpg): core-animated-pages throws when all pages are removed.
+ *
+ * @param {!Array<!Object>} splices The changes made to 'pages'.
+ * @private
+ */
+ applyPageSplices_: function(splices) {
Jeremy Klein 2015/03/09 21:17:14 I don't really understand why any of this stuff is
michaelpg 2015/03/09 22:24:11 Hmm, I'll take a look at MutationObserver. I agree
michaelpg 2015/03/12 01:41:40 Done.
+ var numRemoved = 0;
+ splices.forEach(function(splice) {
+ // Remove the sections to be removed before inserting new children.
+ for (var i = 0; i < splice.removed.length; i++)
+ this.$.pages.removeChild(splice.removed[i].parentNode);
+ numRemoved += splice.removed.length;
+
+ if (!splice.addedCount)
+ return;
+
+ // Find the node to insert before, unless splice.index indicates the end
+ // of the array.
+ var sectionAfter = null;
+ if (splice.index < this.$.pages.children.length)
+ sectionAfter = this.$.pages.children[splice.index];
+
+ for (var i = 0; i < splice.addedCount; i++) {
+ var section = this.createSection_(this.pages[splice.index + i]);
+ this.$.pages.insertBefore(section, sectionAfter);
+ }
+ }.bind(this));
+
+ if (this.currentPageIndex >= this.pages.length)
+ this.currentPageIndex = 0;
+ },
+
+ /** Creates a section for 'core-animated-pages' for the given element.
Kyle Horimoto 2015/03/09 20:59:32 nit: Next line.
+ *
+ * @param {HTMLElement} element Element to add to 'core-animated-pages'.
+ * @private
+ */
+ createSection_: function(element) {
+ element.setAttribute('cross-fade', '');
Kyle Horimoto 2015/03/09 20:59:32 What's this doing?
Dan Beam 2015/03/09 21:23:30 before: <element> after: <element cross-fade>
Kyle Horimoto 2015/03/09 21:28:56 Well yeah - I know that, but I meant to ask why it
michaelpg 2015/03/09 22:24:11 It tells core-animated-pages that this page should
Jeremy Klein 2015/03/09 22:35:05 See note above about cross-fade-all.
michaelpg 2015/03/12 01:41:40 Done.
+ var section = document.createElement('section');
+ section.appendChild(element);
+ return section;
+ },
+});

Powered by Google App Engine
This is Rietveld 408576698