Add an example of constructing a MultiWidget and document the value_from_datadict method

[cuci]

I've been trying to get a multiwidget but I could only see some(old) example on net, none in official docs...preatty hard to do without docs.

[Gabriel Hurley]

One sentence certainly isn't all that should be said about MultiWidget. It probably warrants a whole "Constructing A MultiWidget" section at the end of that page, complete with explanation and an example.

[Preston Timmons]

Documented using the Multiwidget with single value fields

[Preston Timmons]

I added a patch with an example widget for using a MultiWidget with the us.forms.USPhoneNumberField in localflavor.

[Preston Timmons]

Modified the docs with better example and gave example usage.

[Jacob]

Milestone 1.3 deleted

[mjdemilliano@…]

It would be helpful if the documentation on MultiWidget also brought the method value_from_datadict to the attention, next to decompress, to also have the transformation from multiple widget values to the field value (decompress does the reverse).

Example:

def value_from_datadict(self, data, files, name):
    values = super(MyMultiWidget, self).value_from_datadict(data, files, name)
    # i.e. return MyValueType(float(values[0]), float(values[1]))
    return MyValueType(... something with values ...)

[Tim Graham]

We probably shouldn't use localflavor as an example at this point since it's being broken out into a separate package.

[Tim Graham]

I've added a patch that combines the two existing MultiWidget sections, documents value_from_datadict, and adds an example MultiWidget with an explanation of each method.

[Jannis Leidel]

Looks great!

[Tim Graham <timograham@…>]

In 04775b4598d1a9c5bcc0c1da431e368f28dcd13e:

Fixed #13997 - Added an example of constructing a MultiWidget and documented the value_from_datadict method.

[Tim Graham <timograham@…>]

In 31da2a5e56dba374279cc8276d9ccb2e3096e4a9:

[1.5.X] Fixed #13997 - Added an example of constructing a MultiWidget and documented the value_from_datadict method.

Backport of 04775b4598 from master

[Tim Graham <timograham@…>]

In 06c14a63a2c27e5eddfbd6f7b35bcb1d0fc2882b:

[1.4.X] Fixed #13997 - Added an example of constructing a MultiWidget and documented the value_from_datadict method.

Backport of 04775b4598 from master