Documentation

dateTimeInput extends input
in package
Uses minMaxHelper

Text input view helper object

Tags
author

Stefan Seehafer sea75300@yahoo.de

copyright

(c) 2011-2022, Stefan Seehafer

license

http://www.gnu.org/licenses/gpl.txt GPLv3

since
4.2

Table of Contents

DEFAULT_CLASS  = 'fpcm-ui-datetime-picker'
ID_START_PREFIX  = 'fpcm-id-'
LABEL_TYPE_DEFAULT  = 'input-group'
LABEL_TYPE_FLOATING  = 'form-floating'
TEXT_DEFAULT_LABEL  = 'LABEL_FIELD_'
$aria  : array<string|int, mixed>
Ement aria config
$autocomplete  : string
Enables default browser autocompletion
$autoFocused  : bool
Element is autoFocused
$bottomSpace  : string
UI element bottom spance
$class  : string
CSS class string
$colWidth  : string
Column with if input uses an icon
$data  : array<string|int, mixed>
Element data
$fieldSize  : string
Input field size
$icon  : string
Icon class
$iconOnly  : bool
Show icon only
$iconStack  : string
Icon stack class
$id  : string
Element ID
$labelClass  : string
CS class for label
$labelSize  : string
Label size string
$labelType  : string
Column with if input uses an icon
$language  : language
Language object
$max  : mixed
Minimum value
$maxlenght  : int
Maximum input lenght
$min  : mixed
Maximum value
$name  : string
Element name
$pattern  : string
Pattern for client side validation
$placeholder  : string
Use label text as placeholder
$prefix  : string
Element prefix
$readonly  : bool
Element is readonly
$requ  : bool
Element is required
$returned  : bool
Flag if element string was return by @see __toString
$size  : string
Icon size
$spinner  : string
Spinner class for icon
$stackTop  : bool
Move stack icon to top
$step  : mixed
Step value
$text  : string
Input label
$type  : string
Element type
$useWrapper  : string
Add div wrapper to input field
$value  : string
Element value
$wrapperClass  : string
CSS class for div wrapper
$sizeMap  : array<string|int, mixed>
Size map
__construct()  : mixed
Konstruktor
getCleanName()  : string
Name cleanup from bracket, etc.
getIdString()  : string
Returns name and ID string
getJsLangVars()  : void
Returns optional JavaScript language vars
getJsVars()  : void
Returns optional JavaScript vars
getLabelSize()  : string
Fetch label size classes
initFromYml()  : bool
setAria()  : $this
Add array for 'data-'-params to element
setAutocomplete()  : $this
Enables/disables browser autocompletion
setAutoFocused()  : $this
Make helper auto focused
setBottomSpace()  : $this
Set bottom space class
setClass()  : $this
Set additional css class
setData()  : $this
Add array for 'data-'-params to element
setDisplaySizes()  : $this
Sets label and field sizes
setDisplaySizesDefault()  : $this
Sets default label and field sizes values, Label: xs: 12, sm: 6, md: 5 Fields: xs: 12, sm: 6, md: 7
setIcon()  : $this
Set icon
setIconOnly()  : $this
Set button to display icon only
setInputColWidth()  : $this
Set column with if input uses an icon
setLabelClass()  : $this
Set label class CSS string
setLabelSize()  : $this
Sets label sizes only
setLabelTypeFloat()  : $this
Set label typ to floating
setMax()  : $this
Set input maximum
setMaxlenght()  : $this
Set max lenght
setMin()  : $this
Set input minimum
setNativeDate()  : void
Enables native browser date selection field input
setNativeDateTime()  : void
Enables native browser datetime-local selection field input
setNativeTime()  : void
Enables native browser time selection field input
setPattern()  : $this
Pattern for client side validation
setPlaceholder()  : $this
Use label text as placeholder
setReadonly()  : $this
Set element to readonly
setRequired()  : $this
Set required flag
setReturned()  : $this
Prevents rendering of view helper at the end of PHP proessing
setSize()  : $this
Set Icon size
setSpinner()  : $this
Set flag icon has spinner
setStack()  : $this
Set if icon is stacked
setStackTop()  : $this
Move stack icon to top
setStep()  : $this
Set input minimum
setText()  : $this
Set button description
setType()  : $this
Set button type
setValue()  : $this
Set input value
setWrapper()  : $this
Use div wrapper around input field
setWrapperClass()  : $this
Set wrapper css class
appendAttributes()  : string
Append attributes to input element
appendItems()  : bool
Appends item to input field before wrapper
getAriaString()  : string
Return class string
getAutocompleteString()  : string
Browser autocomplete string
getAutoFocusedString()  : string
Return autofocused string
getClassString()  : string
Return class string
getColorMode()  : string
Returns color mode
getDataString()  : string
Return class string
getDescriptionTextString()  : string
Returns name and ID string
getIconString()  : string
Return full icon string
getNameIdString()  : string
Returns name and ID string
getPatternString()  : string
Browser autocomplete string
getPlaceholderString()  : string
Placeholder string
getReadonlyString()  : string
Return class string
getRequiredString()  : string
Return required string
getString()  : string
Return element string
getValueString()  : string
Return value string
getWrapperEnd()  : string
Get input end wrapper
getWrapperStart()  : string
Get input start wrapper
init()  : void
Optional init function
initLabel()  : bool
Initialized default label by field name
isFloating()  : bool
assocArrayToString()  : string
Turns assoc array into string
getAttributeStrings()  : string
Fetch string for element attributes
mapSizes()  : bool
Maps indices to sizeMap
replaceDefaultCssClass()  : void
Replaces default css-classes within native date/time/datetime fields

Constants

DEFAULT_CLASS

public mixed DEFAULT_CLASS = 'fpcm-ui-datetime-picker'

ID_START_PREFIX

public mixed ID_START_PREFIX = 'fpcm-id-'

LABEL_TYPE_DEFAULT

public mixed LABEL_TYPE_DEFAULT = 'input-group'

LABEL_TYPE_FLOATING

public mixed LABEL_TYPE_FLOATING = 'form-floating'

TEXT_DEFAULT_LABEL

public mixed TEXT_DEFAULT_LABEL = 'LABEL_FIELD_'

Properties

$aria

Ement aria config

protected array<string|int, mixed> $aria = []
Tags
since
5.0-dev

$autocomplete

Enables default browser autocompletion

protected string $autocomplete = true
Tags
since
4.1

$autoFocused

Element is autoFocused

protected bool $autoFocused = false
Tags
since
4.1

$bottomSpace

UI element bottom spance

protected string $bottomSpace = 'mb-3'

$colWidth

Column with if input uses an icon

protected string $colWidth = '12'

$data

Element data

protected array<string|int, mixed> $data = []

$iconOnly

Show icon only

protected bool $iconOnly = false

$iconStack

Icon stack class

protected string $iconStack = ''

$id

Element ID

protected string $id = ''

$labelClass

CS class for label

protected string $labelClass = ''
Tags
since
4.1

$labelType

Column with if input uses an icon

protected string $labelType = 'input-group'

$maxlenght

Maximum input lenght

protected int $maxlenght = 255

$name

Element name

protected string $name = ''

$pattern

Pattern for client side validation

protected string $pattern = ''
Tags
since
4.4

$placeholder

Use label text as placeholder

protected string $placeholder = false

$prefix

Element prefix

protected string $prefix = ''

$readonly

Element is readonly

protected bool $readonly = false

$requ

Element is required

protected bool $requ = false
Tags
since
5.0.0-a3

$returned

Flag if element string was return by @see __toString

protected bool $returned = false

$spinner

Spinner class for icon

protected string $spinner = ''
Tags
since
4.2

$stackTop

Move stack icon to top

protected bool $stackTop = false

$text

Input label

protected string $text = ''

$useWrapper

Add div wrapper to input field

protected string $useWrapper = false

$wrapperClass

CSS class for div wrapper

protected string $wrapperClass = ''

$sizeMap

Size map

private array<string|int, mixed> $sizeMap = [0 => 'col-', 1 => 'col-sm-', 2 => 'col-md-', 3 => 'col-lg-', 4 => 'col-xl-', 'xs' => 'col-', 'sm' => 'col-sm-', 'md' => 'col-md-', 'lg' => 'col-lg-', 'xl' => 'col-xl-']

Methods

__construct()

Konstruktor

public __construct(string $name[, string $id = '' ]) : mixed
Parameters
$name : string
$id : string = ''
Return values
mixed

getCleanName()

Name cleanup from bracket, etc.

public final getCleanName() : string
Return values
string

getIdString()

Returns name and ID string

public final getIdString() : string
Return values
string

getJsLangVars()

Returns optional JavaScript language vars

public getJsLangVars() : void
Return values
void

getJsVars()

Returns optional JavaScript vars

public getJsVars() : void
Return values
void

getLabelSize()

Fetch label size classes

public getLabelSize() : string
Return values
string

initFromYml()

public final initFromYml(array<string|int, mixed> $param, array<string|int, mixed> $viewVars) : bool
Parameters
$param : array<string|int, mixed>
$viewVars : array<string|int, mixed>
Tags
since
4.5
Return values
bool

setAria()

Add array for 'data-'-params to element

public setAria(array<string|int, mixed> $aria) : $this
Parameters
$aria : array<string|int, mixed>
Return values
$this

setAutocomplete()

Enables/disables browser autocompletion

public setAutocomplete(bool $autocomplete) : $this
Parameters
$autocomplete : bool
Tags
since
4.1
Return values
$this

setAutoFocused()

Make helper auto focused

public setAutoFocused(bool $autoFocused) : $this
Parameters
$autoFocused : bool
Tags
since
4.1
Return values
$this

setBottomSpace()

Set bottom space class

public setBottomSpace(string $bottomSpace) : $this
Parameters
$bottomSpace : string
Tags
since
5.1-dev
Return values
$this

setClass()

Set additional css class

public setClass(string $class) : $this
Parameters
$class : string
Return values
$this

setData()

Add array for 'data-'-params to element

public setData(array<string|int, mixed> $data) : $this
Parameters
$data : array<string|int, mixed>
Return values
$this

setDisplaySizes()

Sets label and field sizes

public setDisplaySizes(array<string|int, mixed> $label) : $this
Parameters
$label : array<string|int, mixed>
Return values
$this

setDisplaySizesDefault()

Sets default label and field sizes values, Label: xs: 12, sm: 6, md: 5 Fields: xs: 12, sm: 6, md: 7

public setDisplaySizesDefault() : $this
Return values
$this

setIcon()

Set icon

public setIcon(string $icon[, string $prefix = 'fa' ][, bool $useFa = true ]) : $this
Parameters
$icon : string

Icon CSS classes

$prefix : string = 'fa'

Icon prefix

$useFa : bool = true

Auto-add FontAwesome Icon classes

Return values
$this

setIconOnly()

Set button to display icon only

public setIconOnly([string $iconOnly = true ]) : $this
Parameters
$iconOnly : string = true
Return values
$this

setInputColWidth()

Set column with if input uses an icon

public setInputColWidth(mixed $colWidth) : $this
Parameters
$colWidth : mixed
Return values
$this

setLabelClass()

Set label class CSS string

public setLabelClass(string $labelClass) : $this
Parameters
$labelClass : string
Tags
since
4.1
Return values
$this

setLabelSize()

Sets label sizes only

public setLabelSize(array<string|int, mixed> $labelSizes) : $this
Parameters
$labelSizes : array<string|int, mixed>
Return values
$this

setLabelTypeFloat()

Set label typ to floating

public setLabelTypeFloat() : $this
Tags
since
5.0.0-b4
Return values
$this

setMax()

Set input maximum

public setMax(int|float $max) : $this
Parameters
$max : int|float
Return values
$this

setMaxlenght()

Set max lenght

public setMaxlenght(int $maxlenght) : $this
Parameters
$maxlenght : int
Return values
$this

setMin()

Set input minimum

public setMin(int|float $min) : $this
Parameters
$min : int|float
Return values
$this

setNativeDate()

Enables native browser date selection field input

public setNativeDate() : void
Return values
void

setNativeDateTime()

Enables native browser datetime-local selection field input

public setNativeDateTime() : void
Return values
void

setNativeTime()

Enables native browser time selection field input

public setNativeTime() : void
Return values
void

setPattern()

Pattern for client side validation

public setPattern(string $pattern) : $this
Parameters
$pattern : string
Tags
since
4.4
Return values
$this

setPlaceholder()

Use label text as placeholder

public setPlaceholder(bool|string $placeholder) : $this
Parameters
$placeholder : bool|string
Return values
$this

setReadonly()

Set element to readonly

public setReadonly(bool $readonly) : $this
Parameters
$readonly : bool
Return values
$this

setRequired()

Set required flag

public setRequired([bool $requ = true ]) : $this
Parameters
$requ : bool = true
Tags
since
5.0.0-a3
Return values
$this

setReturned()

Prevents rendering of view helper at the end of PHP proessing

public setReturned(bool $returned) : $this
Parameters
$returned : bool
Return values
$this

setSize()

Set Icon size

public setSize(string $size[, bool $useFa = true ]) : $this
Parameters
$size : string
$useFa : bool = true

Auto-add FontAwesome Icon classes

Return values
$this

setSpinner()

Set flag icon has spinner

public setSpinner(string $spinner[, bool $useFa = true ]) : $this
Parameters
$spinner : string
$useFa : bool = true
Return values
$this

setStack()

Set if icon is stacked

public setStack(string $iconStack[, bool $useFa = true ]) : $this
Parameters
$iconStack : string
$useFa : bool = true

Auto-add FontAwesome Icon classes

Return values
$this

setStackTop()

Move stack icon to top

public setStackTop(bool $stackTop) : $this
Parameters
$stackTop : bool
Return values
$this

setStep()

Set input minimum

public setStep(mixed $step) : $this
Parameters
$step : mixed
Return values
$this

setText()

Set button description

public final setText(string $text[, array<string|int, mixed> $params = [] ][, bool $spf = false ]) : $this
Parameters
$text : string
$params : array<string|int, mixed> = []
$spf : bool = false
Return values
$this

setType()

Set button type

public setType(string $type) : $this
Parameters
$type : string
Return values
$this

setValue()

Set input value

public setValue(mixed $value[, int $escapeMode = null ]) : $this
Parameters
$value : mixed
$escapeMode : int = null
Return values
$this

setWrapper()

Use div wrapper around input field

public setWrapper(bool $useWrapper) : $this
Parameters
$useWrapper : bool
Return values
$this

setWrapperClass()

Set wrapper css class

public setWrapperClass(string $wrapperClass) : $this
Parameters
$wrapperClass : string
Return values
$this

appendAttributes()

Append attributes to input element

protected appendAttributes() : string
Tags
since
5.0-dev
Return values
string

appendItems()

Appends item to input field before wrapper

protected appendItems(string &$str) : bool
Parameters
$str : string
Tags
since
4.5.2
Return values
bool

getAriaString()

Return class string

protected getAriaString() : string
Return values
string

getAutocompleteString()

Browser autocomplete string

protected getAutocompleteString() : string
Tags
since
4.1
Return values
string

getAutoFocusedString()

Return autofocused string

protected getAutoFocusedString() : string
Return values
string

getClassString()

Return class string

protected getClassString() : string
Return values
string

getColorMode()

Returns color mode

protected getColorMode() : string
Tags
since
5.2.0-a1
Return values
string

getDataString()

Return class string

protected getDataString() : string
Return values
string

getDescriptionTextString()

Returns name and ID string

protected final getDescriptionTextString([string $prefix = 'ps-1' ]) : string
Parameters
$prefix : string = 'ps-1'
Return values
string

getIconString()

Return full icon string

protected getIconString() : string
Return values
string

getNameIdString()

Returns name and ID string

protected getNameIdString() : string
Return values
string

getPatternString()

Browser autocomplete string

protected getPatternString() : string
Tags
since
4.1
Return values
string

getPlaceholderString()

Placeholder string

protected getPlaceholderString() : string
Return values
string

getReadonlyString()

Return class string

protected getReadonlyString() : string
Return values
string

getRequiredString()

Return required string

protected getRequiredString() : string
Tags
since
5.0.0-a3
Return values
string

getString()

Return element string

protected abstract getString() : string
Return values
string

getValueString()

Return value string

protected getValueString() : string
Return values
string

getWrapperEnd()

Get input end wrapper

protected getWrapperEnd() : string
Tags
since
5.2.0
Return values
string

getWrapperStart()

Get input start wrapper

protected getWrapperStart() : string
Tags
since
5.2.0
Return values
string

init()

Optional init function

protected init() : void
Return values
void

initLabel()

Initialized default label by field name

protected final initLabel() : bool
Tags
since
4.3.0
Return values
bool

isFloating()

protected isFloating() : bool
Tags
since
5.1-dev
Return values
bool

assocArrayToString()

Turns assoc array into string

private assocArrayToString(string $prefix, array<string|int, mixed> $data) : string
Parameters
$prefix : string
$data : array<string|int, mixed>
Return values
string

getAttributeStrings()

Fetch string for element attributes

private getAttributeStrings() : string
Return values
string

mapSizes()

Maps indices to sizeMap

private mapSizes(string|int &$size, string|int $index) : bool
Parameters
$size : string|int
$index : string|int
Return values
bool

replaceDefaultCssClass()

Replaces default css-classes within native date/time/datetime fields

private replaceDefaultCssClass(string $newClass) : void
Parameters
$newClass : string
Return values
void

Search results