Тип: Число. Указывает количество колонок, на которые влияет элемент.
Полное описание, параметры и ограничения
ЭлементКолонкаТаблицыHTML.Диапазон (HTMLTableColElement.Span)
ЭлементКолонкаТаблицыHTML (HTMLTableColElement)
Диапазон (Span)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Число.
Указывает количество колонок, на которые влияет элемент.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Различить настройки строки, колонки и отдельной ячейки
Оформляем название книги и всю первую строку. Числовые индексы и диапазон колонки не путать со строковыми размерами.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
СтрокаТаблицы = Документ.ПолучитьЭлементПоИдентификатору("book");
Если СтрокаТаблицы = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент book";
КонецЕсли;
Если ТипЗнч(СтрокаТаблицы) <> Тип("ЭлементСтрокаТаблицыHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента book";
КонецЕсли;
Ячейка = Документ.ПолучитьЭлементПоИдентификатору("book-name");
Если Ячейка = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент book-name";
КонецЕсли;
Если ТипЗнч(Ячейка) <> Тип("ЭлементЯчейкаТаблицыHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента book-name";
КонецЕсли;
Колонка = Документ.ПолучитьЭлементПоИдентификатору("column");
Если Колонка = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент column";
КонецЕсли;
Если ТипЗнч(Колонка) <> Тип("ЭлементКолонкаТаблицыHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента column";
КонецЕсли;
СтрокаТаблицы.Выравнивание = "left";
СтрокаТаблицы.ВертикальноеПоложение = "top";
СтрокаТаблицы.ЦветФона = "#eef4ff";
Ячейка.Выравнивание = "left";
Ячейка.ВертикальноеПоложение = "middle";
Ячейка.Ширина = "70%";
Ячейка.Высота = "32";
Ячейка.ЦветФона = "#eef4ff";
Ячейка.НеПереносить = Ложь;
Колонка.Выравнивание = "left";
Колонка.ВертикальноеПоложение = "top";
Колонка.Ширина = "70%";
Колонка.Диапазон = 1;
Сообщить(СтрокаТаблицы.ИндексСтроки = 0);
Сообщить(Ячейка.ИндексЯчейки = 0);
Сообщить(СтрокаТаблицы.Ячейки.Количество() = 2);
Сообщить(Колонка.Диапазон = 1);
Сообщить(Ячейка.ТекстовоеСодержимое = "Книга");Разбор по шагам
Получаем именно tr, td и col по собственным id, проверяя каждый специальный тип.
Размеры td и col заданы строками; Диапазон col и индексы — числа.
Настройки строки относятся к строке, а конкретной ячейки могут уточнять её оформление.
Как проверить результат
Пять сравнений дают Истина: индексы 0, две ячейки, одна колонка в диапазоне и текст Книга.
Оформление не создало новых строк или колонок DOM.
Ожидаемый результат
Показаны три уровня HTML-таблицы на собственных данных.
На что обратить внимание
ИндексСтроки и ИндексЯчейки читаются из структуры; ими не переставляют строку.
Диапазон элемента col не является количеством детей строки tr.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.