Joomla! API

下载
启动

ColorField

扩展 FormField

Joomla 平台的颜色表单字段类。

此实现旨在与 HTML5 的 <input type="color"> 兼容

链接
自

1.7.3
包

Joomla CMS

方法

__construct

用于实例化表单字段对象的方法。

__construct(\Joomla\CMS\Form\Form form = null) :
继承
自

1.7.0

参数

form

Form 要附加到表单字段对象的表单。

响应

混合

__get

用于从表单字段对象获取某些原本无法访问的属性的方法。

__get( name) :
自

3.2

参数

name

string 要获取值的属性名称。

响应

mixed 属性值或 null。

__set

用于设置表单字段对象的某些原本无法访问的属性的方法。

__set( name,  value) :
自

3.2

参数

name

string 要设置值的属性名称。

value

mixed 属性的值。

响应

void

collectLayoutData

用于获取要传递到布局以进行呈现的数据的方法。

collectLayoutData() : mixed||string|int
继承

数据缓存在内存中。

自

5.1.0

响应

array<string|int, mixed>

filter

用于过滤字段值的方法。

filter( value,  group = null, \Joomla\Registry\Registry input = null) :
继承
自

4.0.0
抛出

UnexpectedValueException

参数

value

mixed 用于作为字段默认值的可选值。

group

string 用于查找字段的可选点分隔表单组路径。

input

Registry|null 带有要根据整个表单过滤的整个数据集的可选 Registry 对象。

响应

mixed 过滤后的值。

getAdvancedModeLayoutData

用于获取要传递到布局以进行呈现的高级模式的数据的方法。

getAdvancedModeLayoutData( lang) : mixed||string|int
自

3.5

参数

lang

object 语言对象

响应

array<string|int, mixed>

getAttribute

用于获取字段属性的方法

getAttribute( name,  default = null) :
继承
自

3.2

参数

name

string 要获取的属性的名称

default

mixed 如果未找到属性，则返回的可选值

响应

mixed 属性的值/默认值

getCurrentUser

返回当前用户，如果没有设置，则返回全局应用程序的身份。这将在 6.0 中更改，并且将返回空用户。

getCurrentUser() : \Joomla\CMS\User\User
继承
自

4.2.0

响应

User

getDataAttributes

用于获取数据属性的方法。例如，data-user-type

getDataAttributes() : mixed||string|int
继承
自

4.0.0

响应

array<string|int, mixed> 数据属性列表

getFieldName

用于获取使用的字段名称的方法。

getFieldName( fieldName) :
继承
自

1.7.0

参数

fieldName

string 字段元素名称。

响应

string 字段名称

getId

用于获取用于字段输入标签的 id 的方法。

getId( fieldId,  fieldName) :
继承
自

1.7.0

参数

fieldId

string 字段元素 id。

fieldName

string 字段元素名称。

响应

string 要用于字段输入标签的 id。

getInput

用于获取字段输入标记的方法。

getInput() :
自

1.7.3

响应

string 字段输入标记。

getLabel

用于获取字段标签标记的方法。

getLabel() :
继承
自

1.7.0

响应

string 字段标签标记。

getLayoutData

用于获取要传递到布局以进行呈现的数据的方法。

getLayoutData() : mixed||string|int
自

3.5

响应

array<string|int, mixed>

getLayoutPaths

允许在子字段中覆盖渲染器包含路径

getLayoutPaths() : mixed||string|int
继承
自

3.5

响应

array<string|int, mixed>

getName

用于获取用于字段输入标签的名称的方法。

getName( fieldName) :
继承
自

1.7.0

参数

fieldName

string 字段元素名称。

响应

string 要用于字段输入标签的名称。

getRenderer

获取渲染器

getRenderer( layoutId = 'default') : \Joomla\CMS\Layout\FileLayout
继承
自

3.5

参数

layoutId

string 要加载的 id

响应

FileLayout

getSimpleModeLayoutData

用于获取要传递到布局以进行呈现的简单模式的数据的方法。

getSimpleModeLayoutData() : mixed||string|int
自

3.5

响应

array<string|int, mixed>

getSliderModeLayoutData

用于获取滑块数据的方法

getSliderModeLayoutData() : mixed||string|int
自

4.0.0

响应

array<string|int, mixed>

getTitle

用于获取字段标题的方法。

getTitle() :
继承
自

1.7.0

响应

string 字段标题。

isDebugEnabled

此字段是否启用了调试

isDebugEnabled() :
继承
自

3.5

响应

bool

postProcess

用于后处理字段值的方法。

postProcess( value,  group = null, \Joomla\Registry\Registry input = null) :
继承
自

4.0.0

参数

value

mixed 用于作为字段默认值的可选值。

group

string 用于查找字段的可选点分隔表单组路径。

input

Registry|null 带有要根据整个表单过滤的整个数据集的可选 Registry 对象。

响应

mixed 已处理的值。

render

呈现此字段的布局

render( layoutId, mixed||string|int data = []) :
继承
自

3.5

参数

layoutId

string 布局标识符

data

array<string|int, mixed> 布局的可选数据

响应

string

renderDataAttributes

用于将数据属性渲染为 html 的方法。

renderDataAttributes() :
继承
自

4.0.0

响应

string 数据属性的 HTML 标签属性字符串

renderField

用于获取带有标签和输入的控制组的方法。

renderField(mixed||string|int options = []) :
继承
自

3.2

参数

options

array<string|int, mixed> 要传递到字段渲染的选项

响应

string 包含控制组 html 的字符串

setCurrentUser

设置当前用户。

setCurrentUser(\Joomla\CMS\User\User currentUser) :
继承
自

4.2.0

参数

currentUser

User 当前用户对象

响应

void

setForm

用于将表单对象附加到字段的方法。

setForm(\Joomla\CMS\Form\Form form) : \Joomla\CMS\Form\FormField
继承
自

1.7.0

参数

form

Form 要附加到表单字段的表单对象。

响应

FormField 表单字段对象，以便该方法可以在链中使用。

setup

用于将表单对象附加到字段的方法。

setup(\SimpleXMLElement element,  value,  group = null) :
参见 FormField::setup()
自

3.2

参数

element

SimpleXMLElement 表示表单字段对象的 <field> 标签的 SimpleXMLElement 对象。

value

mixed 要验证的表单字段值。

group

string 字段名称组控制值。这充当字段的数组容器。例如，如果字段的名称为“foo”，并且组值为“bar”，则完整的字段名称将最终变为“bar[foo]”。

响应

bool 成功时为 true。

setValue

用于设置值的简单方法

setValue( value) :
继承
自

3.2

参数

value

mixed 要设置的值

响应

void

validate

用于根据字段数据验证 FormField 对象的方法。

validate( value,  group = null, \Joomla\Registry\Registry input = null) : bool|\Exception
继承
自

4.0.0
抛出

InvalidArgumentException

UnexpectedValueException

参数

value

mixed 用于作为字段默认值的可选值。

group

string 用于查找字段的可选点分隔表单组路径。

input

Registry|null 带有要根据整个表单验证的整个数据集的可选 Registry 对象。

响应

bool|Exception 如果字段值有效，则为布尔值 true，失败时为异常。

属性

currentUser

当前用户对象。

继承
自

4.2.0

类型

User

description

表单字段的描述文本。通常用于工具提示。

继承
自

1.7.0

类型

string

hint

表单字段的提示文本，用于在字段内显示提示。

继承
自

3.2

类型

string

autocomplete

表单字段的自动完成状态。如果为“off”，则元素将不会被浏览器自动完成。

继承
自

3.2

类型

混合

spellcheck

表单字段的拼写检查状态。

继承
自

3.2

类型

bool

autofocus

表单字段的自动聚焦请求。如果为 true，则元素将在文档加载时自动聚焦。

继承
自

3.2

类型

bool

element

描述表单字段的 <field> XML 元素的 SimpleXMLElement 对象。

继承
自

1.7.0

类型

SimpleXMLElement

form

附加到表单字段的表单的表单对象。

继承
自

1.7.0

类型

Form

formControl

附加到表单字段的表单对象的字段名称的表单控件前缀。

继承
自

1.7.0

类型

string

hidden

表单字段的隐藏状态。

继承
自

1.7.0

类型

bool

hiddenLabel

渲染表单字段时是否应隐藏标签？这可能很有用，如果您在表单字段本身的图例中为字段集中的单选按钮等渲染标签。

继承

如果您使用此标志，则应确保在您的表单中显示标签（出于 a11y 等原因）。

自

4.0.0

类型

bool

hiddenDescription

渲染表单字段时是否应隐藏描述？这可能很有用，如果您在表单字段本身中为例如注释字段渲染描述。

继承
自

4.0.0

类型

bool

translateLabel

是否要翻译字段标签字符串。

继承
自

1.7.0

类型

bool

translateDescription

是否要翻译字段描述字符串。

继承
自

1.7.0

类型

bool

translateHint

是否要翻译字段提示字符串。

继承
自

3.2

类型

bool

id

表单字段的文档 id。

继承
自

1.7.0

类型

string

input

表单字段的输入。

继承
自

1.7.0

类型

string

label

表单字段的标签。

继承
自

1.7.0

类型

string

multiple

表单字段的多值状态。如果为 true，则允许字段具有多个值。最常用于列表字段类型。

继承
自

1.7.0

类型

bool

repeat

允许扩展创建重复元素

继承
自

3.2

类型

混合

pattern

表单字段值的模式（正则表达式）。

继承
自

1.7.0

类型

string

validationtext

表单字段无效值的验证文本。

继承
自

4.0.0

类型

string

name

表单字段的名称。

继承
自

1.7.0

类型

string

fieldname

字段的名称。

继承
自

1.7.0

类型

string

group

字段的组。

继承
自

1.7.0

类型

string

required

表单字段的必填状态。如果为 true，则必须有该字段的值才能被视为有效。

继承
自

1.7.0

类型

bool

disabled

表单字段的禁用状态。如果为 true，则该字段将被禁用，并且用户无法与该字段交互。

继承
自

3.2

类型

bool

readonly

表单字段的只读状态。如果为 true，则该字段将为只读。

继承
自

3.2

类型

bool

type

表单字段类型。

自

1.7.3

类型

string

validate

表单字段的验证方法。此值将确定用于验证字段的值的方法。

继承
自

1.7.0

类型

string

value

表单字段的值。

继承
自

1.7.0

类型

混合

default

没有值时的默认颜色。

自

4.0.0

类型

string

size

表单字段的大小。

继承
自

3.2

类型

int

class

表单字段的类

继承
自

3.2

类型

混合

labelclass

表单字段的标签的 CSS 类

继承
自

1.7.0

类型

混合

onchange

表单字段的 JavaScript onchange 事件。

继承
自

3.2

类型

string

onclick

表单字段的 JavaScript onclick 事件。

继承
自

3.2

类型

string

showon

显示/隐藏字段的条件。

继承
自

3.7.0

类型

string

parentclass

字段的父类。

继承
自

4.0.0

类型

string

count

为生成的名称字段生成的计数值。

inherited static
自

1.7.0

类型

int

generated_fieldname

用于生成字段名称的字符串。

inherited static
自

1.7.0

类型

string

layout

用于呈现字段的布局名称。

自

3.5

类型

string

layoutData

用于布局渲染的缓存数据。

继承
自

5.1.0

类型

array<string|int, mixed>

renderLayout

用于呈现表单字段的布局。

继承

类型

string

renderLabelLayout

用于呈现标签的布局。

继承

类型

string

dataAttributes

表单字段的 data 属性名称和值。

继承

例如，data-action-type="click" data-action-type="change"

自

4.0.0

类型

array<string|int, mixed>

control

控件。

自

3.2

类型

混合

display

滑块应显示的值类型：'hue'、'saturation' 或 'light'。

自

4.0.0

类型

string

format

格式。

自

3.6.0

类型

string

keywords

关键字（transparent、initial、inherit）。

自

3.6.0

类型

string

position

位置。

自

3.2

类型

混合

colors

颜色。

自

3.2

类型

混合

preview

显示所选颜色的预览。

自

4.0.0

类型

bool

saveFormat

值保存时使用的颜色格式。

自

4.0.0

类型

string

split

分割。

自

3.2

类型

int
  • \ Joomla
  • \ CMS
  • \ Form
  • \ Field
  • \ ColorField