/angular-natural-language

Natural language form element directives for AngularJS

Primary LanguageJavaScriptMIT LicenseMIT

angular-natural-language Build Status

About

Natural language form element directives for AngularJS. Based on codrops/NaturalLanguageForm.

Usage

nlSelect

Markup

As an element:

<nl-select
	value="{string}"
	options="{string}"
	multiple="{string}"
	empty="{string}"
	required>
</nl-select>

As an attribute:

<div
	nl-select
	value="{string}"
	options="{string}"
	multiple="{string}"
	empty="{string}"
	required>
</div>

Parameters

Param Type Details
value string Assignable angular expression to data-bind to. (think of it like ng-model)
options string Expression to data-bind to. (the options list section below shows the accepted formats)
multiple string (optional) Simulates the multiple attribute on a normal select. The string value given is used as the conjunction between selections. Defaults: "and"
all string (optional) Only applicable if multiple is enabled. Text to display for the select all option.
none string (optional) Only applicable if multiple is enabled. Text to display for the select none option.
empty string (optional) What to display when no options are selected. Default: "none" (this is only used if multiple is specified)
required boolean Simulates the required attribute on a normal select

Options List

The options list can be in one of the 4 following formats:

Array of labels/values:

['one', 'two', 'three', ...]

Array of objects:

[
	{ label: 'one', value: 'ten' },
	{ label: 'two', value: 'nine' },
	{ label: 'three', value: 'eight' },
	...
]

Object of labels/values:

{ 'one':'ten', 'two':'nine', 'three':'eight', ... }

Object of objects:

{
	'one':{ label: 'one', value: 'ten' },
	'two':{ label: 'two', value: 'nine' },
	'three':{ label: 'three', value: 'eight' },
	...
}

--

nlText

Markup

As an element:

<nl-text
	value="{string}"
	placeholder="{string}"
	subline="{string}"
	name="{string}"
	required>
</nl-text>

As an attribute:

<div
	nl-text
	value="{string}"
	placeholder="{string}"
	subline="{string}"
	name="{string}"
	required>
</div>

Parameters

Param Type Details
value string Assignable angular expression to data-bind to. (think of it like ng-model)
placeholder string (optional) String to use as the placeholder for the input and default text for the view
subline string (optional) Small bit of directions to display just below the input
name string (optional) Passed directly to the actual input element
required boolean Simulates the required attribute on a normal text input