Component Feature Checklist

Here’s an expanded list of component features I’ll try to incorporate into all the BCA components. Obviously all these features are not applicable to every component, but I’ll attempt to include all I can. My hope is that using this checklist will help me produce a first class component library by updating this feature list and the existing components as I discover new features.

So if you use any of the components from this blog and later find one lacking a feature you need you might want to come back to the blog to see if I’ve added it. If you find I haven’t included a feature you need please leave a comment detailing what you’re looking for and I’ll try to accomodate you.

1. HTML elements that commonly appear together.
   1. Example: Enclosing div, label, and input.
2. Parameters
   1. Value 
      1. Provides the means to set or read the components value via binding
      2. The type is dependent on the component
   2. Placeholder
      1. Provides the means to show a message in an input when the input is null
      2. Type string
   3. Label
      1. The text that will be displayed in the label element
      2. Type string
   4. Title
      1. The title (tooltip) attribute of the enclosing div. 
      2. Type string
   5. Id
      1. The id attribute of the primary HTML element, such as the input 
      2. Type string
   6. ExtraAttributes
      1. Any unmatched values supplied by the user that will be applied to the primary HTML element in the component
      2. Type Dictionary<string, object>
      3. Decorated with [Parameter(CaptureUnmatchedValues = true)]
   7. ClassDiv 
      1. Class for the enclosing div element
      2. Type string
   8. ClassLabel 
      1. Class for the label element
      2. Type string
   9. ClassInput 
      1. Class for the Input element 
      2. Type string
      3. Default value might be “form-control”
   10. ClassValid 
       1. Class to be applied to an input with a valid input value 
       2. Type string
       3. Default value is “valid” which should be the site specific input outline color
   11. ClassModified 
       1. Class to be applied to an input with a modified input value 
       2. Type string
       3. Default value is “valid modified” which usually is a green outline
   12. ClassInvalid 
       1. Class to be applied to an input with an invalid input value 
       2. Type string
       3. Default value is “invalid” which usually is a red outline
   13. ClassValidationMessage
       1. Class to be applied to the validation message
       2. Type string
       3. Default value is “validation-message” which is usually color red
   14. OnChanged
       1. EventCallback triggered after the component value changes
   15. EditContext
       1. The parents EditContext (if applicable) for data validation
   16. For
       1. Used to indicate the applicable EditContext field
       2. Type string
3. Methods
   1. GetSelectedItems
      1. Returns currently selected items
4. Documentation
   1. XML documentation 
      1. Describe the purpose of parameters and public methods