Spec-Zone.ru › ColdFusion

cfgrid

Используется внутри тега cfform. Добавляет элемент управления в виде сетки (таблицы данных) в форму CFML. Чтобы задать столбцы и данные строк сетки, используйте теги cfgridcolumn и cfgridrow или атрибут query, с тегами cfgridcolumn или без них.

<cfgrid name="">

cfgrid(name="");

Для этого тега требуется Adobe ColdFusion 3 или более поздняя версия. Не поддерживается в Lucee и других системах.

Не рекомендуется: сообщество CFML в целом не рекомендует использовать теги, создающие пользовательский интерфейс. См.: https://static.raymondcamden.com/cfuitherightway/cfgrid/index.html

  • CF3+
    • См. также: cfgridcolumn cfgridrow cfgridupdate

    Справочник по атрибутам

    name string
    Обязательный

    Имя элемента сетки.

    bind string

    Выражение привязки, указывающее, какие данные использовать для заполнения сетки. Не может использоваться вместе с атрибутом query.

    pagesize numeric

    Количество строк на странице динамической сетки. Если количество доступных строк превышает размер страницы, в сетке отображается только указанное количество записей на одной странице, а пользователь переходит между страницами, чтобы просмотреть все данные. Данные для каждой страницы извлекаются только тогда, когда они нужны для отображения. Этот атрибут игнорируется, если указан атрибут query.

    striperowcolor string

    Цвет одной из чередующихся полос. Другой цвет задается параметром bgColor.

    preservepageonsort boolean
    По умолчанию: true

    Указывает, следует ли после сортировки (или повторной сортировки) сетки отображать текущую страницу или страницу 1.

    striperows boolean
    По умолчанию: true

    Указывает, следует ли после сортировки (или повторной сортировки) сетки отображать текущую страницу или страницу 1.

    format string
    По умолчанию: applet

    - applet: создает апплет Java. - Flash: создает элемент управления сеткой Flash. - xml: создает XML-представление сетки. В формах формата XML созданный XML включается в форму. В формах формата HTML XML помещается в строковую переменную с именем, указанным атрибутом name. По умолчанию: applet
    Значения:
    • applet
    • flash
    • xml
    • html

    height numeric
    По умолчанию: 300

    Высота элемента управления в пикселях. По умолчанию для апплета: 300

    width numeric

    Ширина элемента управления в пикселях. По умолчанию для апплета: 300

    autowidth boolean
    По умолчанию: false

    Yes: задает ширину столбцов так, чтобы все столбцы помещались в пределах ширины сетки. No: задает одинаковую ширину столбцов. Пользователь может изменять ширину столбцов. Горизонтальные полосы прокрутки недоступны, поскольку, если указать ширину столбца и задать autoWidth = "Yes", CFML установит эту ширину, если это возможно.

    vspace numeric

    Вертикальный отступ над элементом управления и под ним, в пикселях.

    hspace numeric

    Горизонтальный отступ слева и справа от элемента управления, в пикселях.

    align string

    Выравнивание содержимого ячеек сетки
    Значения:
    • top
    • left
    • bottom
    • baseline
    • texttop
    • absbottom
    • middle
    • absmiddle
    • right

    query query

    Имя запроса, связанного с элементом управления сеткой.

    insert boolean
    По умолчанию: false

    Пользователь может вставлять данные строк в сетку. Действует только при selectmode="edit".

    delete boolean
    По умолчанию: false

    Пользователь может удалять данные строк из сетки. Действует только при selectmode="edit".

    sort boolean
    По умолчанию: false

    Кнопка сортировки выполняет простую текстовую сортировку столбца. Пользователь может сортировать столбцы, щелкая заголовок столбца или кнопки сортировки. Не поддерживается при selectmode=browse. Yes: в элементе управления сеткой отображаются кнопки сортировки.

    font string
    По умолчанию: arial

    Шрифт данных в столбце.
    Значения:
    • arial
    • times
    • courier
    • arialunicodeMS

    fontsize numeric

    Размер текста в столбце.

    italic boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой курсивом.

    bold boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой полужирным шрифтом.

    textcolor string
    По умолчанию: black

    Цвет текста элемента управления. Для шестнадцатеричного значения используйте формат: textColor = "##xxxxxx", где x = 0–9 или A–F; используйте два знака решетки или ни одного.
    Значения:
    • black
    • red
    • blue
    • magenta
    • cyan
    • orange
    • darkgray
    • pink
    • white
    • lightgray
    • yellow

    href string

    URL или имя столбца запроса, содержащего URL, который будет использоваться для создания гиперссылки в каждом столбце сетки.

    hrefkey string

    Столбец запроса, значение которого будет добавлено к URL href каждого столбца вместо значения самого столбца.

    target string

    Фрейм, в котором открывается ссылка, указанная в href.

    appendkey boolean
    По умолчанию: true

    При использовании вместе с href передает переменную CFTREEITEMKEY со значением выбранного элемента дерева в URL страницы приложения, указанной в атрибуте action тега cfform.

    highlighthref boolean
    По умолчанию: true

    Yes: выделяет ссылки, связанные с cftreeitem, у которого задано значение атрибута URL. No: отключает выделение.

    onvalidate string

    Функция JavaScript для проверки пользовательского ввода. Указанной процедуре передаются объект формы, объект ввода и значение объекта ввода. Она должна возвращать True, если проверка прошла успешно, и False в противном случае.

    onerror string

    Функция JavaScript, выполняемая в случае неудачной проверки.

    griddataalign string
    По умолчанию: left

    Left: выравнивает данные в столбце по левому краю. Right: выравнивает данные в столбце по правому краю. Center: выравнивает данные в столбце по центру.
    Значения:
    • left
    • center
    • right

    gridlines boolean
    По умолчанию: true

    Yes: отображает линии строк и столбцов в элементе управления сеткой.

    rowheight numeric

    Минимальная высота строки элемента управления сеткой в пикселях. Используется с типом type = "Image" тега cfgridcolumn; задает место для отображения графики в строке.

    rowheaders boolean
    По умолчанию: true

    Yes: отображает в элементе управления сеткой столбец с числовыми метками строк.

    rowheaderalign string
    По умолчанию: left

    Left: выравнивает данные в заголовке строки по левому краю. Right: выравнивает данные в заголовке строки по правому краю. Center: выравнивает данные в заголовке строки по центру.
    Значения:
    • left
    • center
    • right

    rowheaderfont string

    Шрифт данных в столбце.

    rowheaderfontsize numeric

    Размер текста в столбце.

    rowheaderitalic boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой курсивом.

    rowheaderbold boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой полужирным шрифтом.

    rowheadertextcolor string
    По умолчанию: black

    Цвет текста элемента управления. Для шестнадцатеричного значения используйте формат: textColor = "##xxxxxx", где x = 0–9 или A–F; используйте два знака решетки или ни одного.
    Значения:
    • black
    • red
    • blue
    • magenta
    • cyan
    • orange
    • darkgray
    • pink
    • white
    • lightgray
    • yellow

    colheaders boolean
    По умолчанию: true

    Yes: отображает в элементе управления сеткой столбец с числовыми метками строк.

    colheaderalign string
    По умолчанию: left

    Left: выравнивает данные в заголовке строки по левому краю. Right: выравнивает данные в заголовке строки по правому краю. Center: выравнивает данные в заголовке строки по центру.
    Значения:
    • left
    • center
    • right

    colheaderfont string

    Шрифт данных в столбце.

    colheaderfontsize numeric

    Размер текста в столбце.

    colheaderitalic boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой курсивом.

    colheaderbold boolean
    По умолчанию: false

    Yes: отображает текст элемента управления сеткой полужирным шрифтом.

    colheadertextcolor string

    Цвет текста элемента управления. Для шестнадцатеричного значения используйте формат: textColor = "##xxxxxx", где x = 0–9 или A–F; используйте два знака решетки или ни одного.
    Значения:
    • black
    • red
    • blue
    • magenta
    • cyan
    • orange
    • darkgray
    • pink
    • white
    • lightgray
    • yellow

    bgcolor string

    Цвет фона элемента управления сеткой.
    Значения:
    • black
    • red
    • blue
    • magenta
    • cyan
    • orange
    • darkgray
    • pink
    • white
    • lightgray
    • yellow

    selectcolor string

    Цвет фона выбранного элемента.
    Значения:
    • black
    • red
    • blue
    • magenta
    • cyan
    • orange
    • darkgray
    • pink
    • white
    • lightgray
    • yellow

    selectmode string

    Режим выбора элементов в элементе управления. - Edit: пользователь может редактировать данные сетки. При выборе ячейки открывается редактор соответствующего типа. - Row: выбор пользователя автоматически распространяется на строку, содержащую выбранную ячейку. - Single: выбор пользователя ограничен выбранной ячейкой. (Только апплет) - Column: выбор пользователя автоматически распространяется на столбец, содержащий выбранную ячейку. (Только апплет) - Browse: пользователь может только просматривать данные сетки. (Только апплет)
    Значения:
    • edit
    • single
    • row
    • column
    • browse

    maxrows numeric

    Максимальное количество строк, отображаемых в сетке.

    notsupported string
    По умолчанию: <b>Browser must support Java to <br>view ColdFusion Java Applets!</b>

    Текст, отображаемый, если страницу с элементом управления cfform на основе апплета Java открывает браузер, не поддерживающий Java, или если поддержка Java отключена.

    picturebar boolean
    По умолчанию: false

    Yes: изображения для кнопок «Вставить», «Удалить» и «Сортировать».

    insertbutton string

    Текст кнопки вставки. Действует только при selectmode="edit".

    deletebutton string

    Текст кнопки удаления. Действует только при selectmode="edit".

    sortascendingbutton string

    Текст кнопки сортировки

    sortdescendingbutton string

    Текст кнопки сортировки

    style string

    Только для Flash: должна быть спецификация стиля в формате CSS. Игнорируется для type="text".

    enabled boolean
    По умолчанию: true

    Только для Flash: логическое значение, указывающее, включен ли элемент управления. Отключенный элемент управления отображается светло-серым цветом. По умолчанию: true

    visible boolean
    По умолчанию: true

    Только для Flash: логическое значение, указывающее, следует ли отображать элемент управления. На месте невидимого элемента управления остается пустое пространство. По умолчанию: true

    tooltip string

    Только для Flash: текст, отображаемый при наведении указателя мыши на элемент управления.

    onchange string

    Только для Flash: код ActionScript, выполняемый при изменении элемента управления в результате действий пользователя.

    bindonload boolean
    По умолчанию: true

    * yes: выполняет выражение атрибута bind при первой загрузке формы. * no: не выполняет выражение атрибута bind до первого связанного события. Игнорируется, если атрибут bind не задан.

    selectonload boolean
    По умолчанию: true

    * yes: выбирает первую строку сетки при ее загрузке. * no: не выбирает строки при загрузке сетки.

    onblur string

    Код ActionScript, выполняемый при потере фокуса сеткой.

    onfocus string

    Код ActionScript, выполняемый при получении фокуса сеткой.

    collapsible boolean

    Логическое значение, указывающее, может ли пользователь свернуть всю сетку, щелкнув стрелку на строке заголовка.

    groupfield string

    Объединяет строки сетки в группы по столбцу, указанному в этом атрибуте. Каждую группу можно свернуть; у нее есть заголовок с именем столбца, значением поля группировки и количеством записей в группе.

    onLoad string

    Функция JavaScript, вызываемая при первой загрузке сетки.

    Примеры
    Пример кода с использованием тега cfgrid

    Самая простая сетка cfgrid без использования запроса

    Тег CFgrid и связанные с ним теги обладают множеством возможностей и параметров, но если вам нужен простой пример работающей сетки, воспользуйтесь этим.

    <cfform>
                <cfgrid name="grid1" format="html" >
                                <cfgridcolumn name="col1">
                                <cfgridrow data="xxx">
                </cfgrid>
</cfform>

    Ожидаемый результат: Сетка с одним столбцом

    © 2012–present Foundeo, Inc. and the CFDocs contributors.
    Licensed under the MIT License.
    ColdFusion is a trademark of Adobe Systems Incorporated.
    https://cfdocs.org/cfgrid

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API