summaryrefslogtreecommitdiff
path: root/dom/html/HTMLOptionsCollection.h
diff options
context:
space:
mode:
Diffstat (limited to 'dom/html/HTMLOptionsCollection.h')
-rw-r--r--dom/html/HTMLOptionsCollection.h170
1 files changed, 170 insertions, 0 deletions
diff --git a/dom/html/HTMLOptionsCollection.h b/dom/html/HTMLOptionsCollection.h
new file mode 100644
index 0000000000..21123b3d21
--- /dev/null
+++ b/dom/html/HTMLOptionsCollection.h
@@ -0,0 +1,170 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+#ifndef mozilla_dom_HTMLOptionsCollection_h
+#define mozilla_dom_HTMLOptionsCollection_h
+
+#include "mozilla/Attributes.h"
+#include "nsIHTMLCollection.h"
+#include "nsIDOMHTMLOptionsCollection.h"
+#include "nsWrapperCache.h"
+
+#include "mozilla/dom/HTMLOptionElement.h"
+#include "mozilla/ErrorResult.h"
+#include "nsCOMPtr.h"
+#include "nsError.h"
+#include "nsGenericHTMLElement.h"
+#include "nsTArray.h"
+
+class nsIDOMHTMLOptionElement;
+
+namespace mozilla {
+namespace dom {
+
+class HTMLElementOrLong;
+class HTMLOptionElementOrHTMLOptGroupElement;
+class HTMLSelectElement;
+
+/**
+ * The collection of options in the select (what you get back when you do
+ * select.options in DOM)
+ */
+class HTMLOptionsCollection final : public nsIHTMLCollection
+ , public nsIDOMHTMLOptionsCollection
+ , public nsWrapperCache
+{
+ typedef HTMLOptionElementOrHTMLOptGroupElement HTMLOptionOrOptGroupElement;
+public:
+ explicit HTMLOptionsCollection(HTMLSelectElement* aSelect);
+
+ NS_DECL_CYCLE_COLLECTING_ISUPPORTS
+
+ // nsWrapperCache
+ using nsWrapperCache::GetWrapperPreserveColor;
+ using nsWrapperCache::GetWrapper;
+ virtual JSObject* WrapObject(JSContext* aCx, JS::Handle<JSObject*> aGivenProto) override;
+protected:
+ virtual ~HTMLOptionsCollection();
+
+ virtual JSObject* GetWrapperPreserveColorInternal() override
+ {
+ return nsWrapperCache::GetWrapperPreserveColor();
+ }
+public:
+
+ // nsIDOMHTMLOptionsCollection interface
+ NS_DECL_NSIDOMHTMLOPTIONSCOLLECTION
+
+ // nsIDOMHTMLCollection interface, all its methods are defined in
+ // nsIDOMHTMLOptionsCollection
+
+ virtual Element* GetElementAt(uint32_t aIndex) override;
+ virtual nsINode* GetParentObject() override;
+
+ NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS_AMBIGUOUS(HTMLOptionsCollection,
+ nsIHTMLCollection)
+
+ // Helpers for HTMLSelectElement
+ /**
+ * Insert an option
+ * @param aOption the option to insert
+ * @param aIndex the index to insert at
+ */
+ void InsertOptionAt(mozilla::dom::HTMLOptionElement* aOption, uint32_t aIndex)
+ {
+ mElements.InsertElementAt(aIndex, aOption);
+ }
+
+ /**
+ * Remove an option
+ * @param aIndex the index of the option to remove
+ */
+ void RemoveOptionAt(uint32_t aIndex)
+ {
+ mElements.RemoveElementAt(aIndex);
+ }
+
+ /**
+ * Get the option at the index
+ * @param aIndex the index
+ * @param aReturn the option returned [OUT]
+ */
+ mozilla::dom::HTMLOptionElement* ItemAsOption(uint32_t aIndex)
+ {
+ return mElements.SafeElementAt(aIndex, nullptr);
+ }
+
+ /**
+ * Clears out all options
+ */
+ void Clear()
+ {
+ mElements.Clear();
+ }
+
+ /**
+ * Append an option to end of array
+ */
+ void AppendOption(mozilla::dom::HTMLOptionElement* aOption)
+ {
+ mElements.AppendElement(aOption);
+ }
+
+ /**
+ * Drop the reference to the select. Called during select destruction.
+ */
+ void DropReference();
+
+ /**
+ * Finds the index of a given option element.
+ * If the option isn't part of the collection, return NS_ERROR_FAILURE
+ * without setting aIndex.
+ *
+ * @param aOption the option to get the index of
+ * @param aStartIndex the index to start looking at
+ * @param aForward TRUE to look forward, FALSE to look backward
+ * @return the option index
+ */
+ nsresult GetOptionIndex(Element* aOption,
+ int32_t aStartIndex, bool aForward,
+ int32_t* aIndex);
+
+ HTMLOptionElement* GetNamedItem(const nsAString& aName)
+ {
+ bool dummy;
+ return NamedGetter(aName, dummy);
+ }
+ HTMLOptionElement* NamedGetter(const nsAString& aName, bool& aFound);
+ virtual Element*
+ GetFirstNamedElement(const nsAString& aName, bool& aFound) override
+ {
+ return NamedGetter(aName, aFound);
+ }
+
+ void Add(const HTMLOptionOrOptGroupElement& aElement,
+ const Nullable<HTMLElementOrLong>& aBefore,
+ ErrorResult& aError);
+ void Remove(int32_t aIndex, ErrorResult& aError);
+ int32_t GetSelectedIndex(ErrorResult& aError);
+ void SetSelectedIndex(int32_t aSelectedIndex, ErrorResult& aError);
+ void IndexedSetter(uint32_t aIndex, nsIDOMHTMLOptionElement* aOption,
+ ErrorResult& aError)
+ {
+ aError = SetOption(aIndex, aOption);
+ }
+ virtual void GetSupportedNames(nsTArray<nsString>& aNames) override;
+
+private:
+ /** The list of options (holds strong references). This is infallible, so
+ * various members such as InsertOptionAt are also infallible. */
+ nsTArray<RefPtr<mozilla::dom::HTMLOptionElement> > mElements;
+ /** The select element that contains this array */
+ HTMLSelectElement* mSelect;
+};
+
+} // namespace dom
+} // namespace mozilla
+
+#endif // mozilla_dom_HTMLOptionsCollection_h