From f7394d2c32b4b4717066f254adaa513d08ab32a4 Mon Sep 17 00:00:00 2001 From: Claude Paroz Date: Mon, 28 Jan 2013 14:24:48 +0100 Subject: Added HTML5 url input type Refs #16630. --- docs/ref/forms/api.txt | 2 +- docs/ref/forms/fields.txt | 8 ++++---- docs/ref/forms/widgets.txt | 13 +++++++++++-- docs/releases/1.6.txt | 7 ++++--- 4 files changed, 20 insertions(+), 10 deletions(-) (limited to 'docs') diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt index 44e4684c1d..4c5c275806 100644 --- a/docs/ref/forms/api.txt +++ b/docs/ref/forms/api.txt @@ -161,7 +161,7 @@ precedence:: >>> f = CommentForm(initial={'name': 'instance'}, auto_id=False) >>> print(f) Name: - Url: + Url: Comment: Accessing "clean" data diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt index 8bfe77cc20..2e4e779f0c 100644 --- a/docs/ref/forms/fields.txt +++ b/docs/ref/forms/fields.txt @@ -112,7 +112,7 @@ We've specified ``auto_id=False`` to simplify the output:: >>> f = CommentForm(auto_id=False) >>> print(f) Your name: - Your Web site: + Your Web site: Comment: ``initial`` @@ -135,7 +135,7 @@ field is initialized to a particular value. For example:: >>> f = CommentForm(auto_id=False) >>> print(f) Name: - Url: + Url: Comment: You may be thinking, why not just pass a dictionary of the initial values as @@ -150,7 +150,7 @@ and the HTML output will include any validation errors:: >>> f = CommentForm(default_data, auto_id=False) >>> print(f) Name: - Url: + Url: Comment: This is why ``initial`` values are only displayed for unbound forms. For bound @@ -805,7 +805,7 @@ For each field, we describe the default widget used if you don't specify .. class:: URLField(**kwargs) - * Default widget: :class:`TextInput` + * Default widget: :class:`URLInput` * Empty value: ``''`` (an empty string) * Normalizes to: A Unicode object. * Validates that the given value is a valid URL. diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt index 9105a41b25..cb5224fd3c 100644 --- a/docs/ref/forms/widgets.txt +++ b/docs/ref/forms/widgets.txt @@ -139,7 +139,7 @@ provided for each widget will be rendered exactly the same:: >>> f = CommentForm(auto_id=False) >>> f.as_table() Name: - Url: + Url: Comment: On a real Web page, you probably don't want every widget to look the same. You @@ -160,7 +160,7 @@ Django will then include the extra attributes in the rendered output: >>> f = CommentForm(auto_id=False) >>> f.as_table() Name: - Url: + Url: Comment: .. _styling-widget-classes: @@ -403,6 +403,15 @@ These widgets make use of the HTML elements ``input`` and ``textarea``. Text input: ```` +``URLInput`` +~~~~~~~~~~~~ + +.. class:: URLInput + + .. versionadded:: 1.6 + + Text input: ```` + ``PasswordInput`` ~~~~~~~~~~~~~~~~~ diff --git a/docs/releases/1.6.txt b/docs/releases/1.6.txt index 03341e586b..e0c07c40fe 100644 --- a/docs/releases/1.6.txt +++ b/docs/releases/1.6.txt @@ -31,8 +31,9 @@ Minor features * Added :meth:`~django.db.models.query.QuerySet.earliest` for symmetry with :meth:`~django.db.models.query.QuerySet.latest`. -* The default widgets for :class:`~django.forms.EmailField` use - the new type attribute available in HTML5 (type='email'). +* The default widgets for :class:`~django.forms.EmailField` and + :class:`~django.forms.URLField` use the new type attributes available in + HTML5 (type='email', type='url'). Backwards incompatible changes in 1.6 ===================================== @@ -44,7 +45,7 @@ Backwards incompatible changes in 1.6 * If your CSS/Javascript code used to access HTML input widgets by type, you should review it as ``type='text'`` widgets might be now output as - ``type='email'`` depending on their corresponding field type. + ``type='email'`` or ``type='url'`` depending on their corresponding field type. .. warning:: -- cgit v1.3