Оснастки расширений типов "массив"

Предоставляют расширение базовых функций типа Array в ECMAScript (JavaScript) за счет добавления статических методов.

Пространство имен: отсутствует. Это расширение типа является глобальным и не принадлежит к пространству имен.

Наследование от: Array

var arrayVar = new Array("Saturn","Mars","Jupiter");
Array.add(arrayVar, "Earth");

Расширения членов

Имя

Описание

Функция Array.add

Добавляет элемент в конец объекта Array.

Функция Array.addRange

Копирует все элементы указанного массива в конец объекта Array.

Функция Array.clear

Удаляет все элементы из объекта Array.

Функция Array.clone

Создает неполную копию объекта Array.

Функция Array.contains

Определяет, входит ли элемент в состав объекта Array.

Функция Array.dequeue

Удаляет первый элемент из объекта Array.

Функция Array.enqueue

Добавляет элемент в конец объекта Array.

ПримечаниеПримечание
Используйте функцию add вместо функции Array.enqueue.

Функция Array.forEach

Выполняет заданное действие для каждого элемента объекта Array.

Функция Array.indexOf

Производит поиск указанного элемента объекта Array и возвращает его индекс.

Функция Array.insert

Вставляет значение в указанную позицию объекта Array.

Функция Array.parse

Создает объект Array из строкового представления.

Функция Array.remove

Удаляет первое вхождение элемента из объекта Array.

Функция Array.removeAt

Удаляет элемент из указанного места в объекте Array.

Заметки

Расширения типа Array являются частью библиотеки Библиотека Microsoft Ajax. Они добавляют статические методы к объекту JavaScript Array для обеспечения дополнительных возможностей.

Дополнительные сведения об объекте JavaScript, который расширяется этими статическими методами, и о его конструкторе см. в разделе Объект Array в руководстве Справочник по языку.

Пример

В следующем примере показано, как создать новый объект Array и вызвать функцию Библиотека Microsoft Ajax add для добавления массивов в виде одного элемента массива. Затем многомерный массив передается функции, отображающей массив в документе в виде таблицы.


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Sample</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager runat="server" ID="ScriptManager1">
        </asp:ScriptManager>

        <div id="results">
        </div>

        <script type="text/javascript">

        // Create and display a table based on array content.
        function displayTable(arrayTable, element) 
        {
            var tableMarkup;
            tableMarkup = "<table border=on>";
            var rows = arrayTable[0][0].length;

            for(x=0; x<=rows; x++)
            {
               tableMarkup += "<tr>";
               var columns = arrayTable[x].length - 1;
               for(y=0; y<=columns; y++)
               {
                    tableMarkup += "<td>" + arrayTable[x][y] + "</td>";
               }
               tableMarkup += "</tr>";
            }
            tableMarkup += "</table>";

            element.innerHTML += tableMarkup;

            // Clean up.
            Array.clear(arrayTable);
        }

        // Create table data.
        function createTableData() 
        {
               var costsArray = [];

               var headerRow = new Array("ID", "Name", "Costs");
               var firstRow = new Array("1", "ruler", "1.30");
               var secondRow = new Array("2", "binder", "4.75");

               Array.add(costsArray, headerRow);
               Array.add(costsArray, firstRow);
               Array.add(costsArray, secondRow);

               return costsArray;
        }  

        var myTable = createTableData();
        var element = $get("results");
        displayTable(myTable, element);

    </script>
    </form>
</body>
</html>


См. также

Ссылки

Объект Array

Оператор new

Функции типа "массив"