Feature: add the 'prompt' attribute of the SequenceWidget to the list…

… of adaptable attributes.

CHANGES.txt

@@ -4,6 +4,8 @@ CHANGES
 
 Version 2.0.0 (2008-??-??)
 --------------------------
+- Feature: add the 'prompt' attribute of the SequenceWidget to the list of
+  adaptable attributes.
 
 - Fix: IMPORTANT - the signature of z3c.form.util.extractFileName function changed
   because of spelling mistake fix in argument name. The ``allowEmtpyPostFix`` is

src/z3c/form/browser/select.py

@@ -41,7 +41,7 @@ class SelectWidget(widget.HTMLSelectWidget, SequenceWidget):
 
     # Internal attributes
     _adapterValueAttributes = SequenceWidget._adapterValueAttributes + \
-        ('noValueMessage', 'promptMessage')
+        ('noValueMessage', 'promptMessage', 'prompt')
 
     def isSelected(self, term):
         return term.token in self.value

src/z3c/form/browser/select.txt

@@ -213,6 +213,28 @@ So after updating the widget you have the custom value:
   >>> widget.promptMessage
   u'please select a value'
 
+Additionally, the select widget also allows dynamic value for the ``prompt``
+attribute . Initially, value is ``False``:
+
+  >>> widget.prompt = False
+  >>> widget.prompt
+  False
+
+Let's now register an attribute value:
+
+  >>> from z3c.form.widget import StaticWidgetAttribute
+  >>> AllowPrompt = StaticWidgetAttribute(True)
+
+  >>> import zope.component
+  >>> zope.component.provideAdapter(AllowPrompt, name='prompt')
+
+After updating the widget, the value for the prompt attribute changed to the
+value provided by the adapter:
+
+  >>> widget.update()
+  >>> widget.prompt
+  True
+
 Display Widget
 --------------